bs-manager/README.md

<a name="readme-top"></a>

<!-- PROJECT SHIELDS -->
<!--
*** I'm using markdown "reference style" links for readability.
*** Reference links are enclosed in brackets [ ] instead of parentheses ( ).
*** See the bottom of this document for the declaration of the reference variables
*** for contributors-url, forks-url, etc. This is an optional, concise syntax you may use.
*** https://www.markdownguide.org/basic-syntax/#reference-style-links
-->

<!-- PROJECT LOGO -->

<div align="center">
  <a href="https://github.com/Zagrios/bs-manager">
    <img src="https://raw.githubusercontent.com/Zagrios/bs-manager/master/resources/readme/icon.svg" alt="Logo" width="250" height="250">
  </a>
  <br><br>
  <h2 align="center"><b>Beat Saber Manager</b></h3>
  <p align="center">
    Download, manage and customize your versions of Beat Saber with a simple click!
    <br />
    <a href="https://github.com/Zagrios/bs-manager/issues/new?assignees=Zagrios&labels=bug&template=bug_report.md&title=%5BBUG%5D">Report Bug</a>
    ·
    <a href="https://github.com/Zagrios/bs-manager/issues/new?assignees=Zagrios&labels=enhancement&template=feature_request.md&title=%5BAME%5D">Request Feature</a>
    <br><img src="https://github.com/Zagrios/bs-manager/blob/master/resources/readme/beat-running.png?raw=true" width="130"/>
  </p>
</div>
<div align="center">
<a href="https://github.com/Zagrios/bs-manager/stargazers"><img src ="https://img.shields.io/github/stars/Zagrios/bs-manager?style=for-the-badge" alt="Stargazers"/></a>
<a href="https://github.com/Zagrios/bs-manager/network/members"><img src ="https://img.shields.io/github/forks/Zagrios/bs-manager?style=for-the-badge" alt="Forks"/></a>
<a href="https://github.com/Zagrios/bs-manager/blob/master/LICENSE"><img src ="https://img.shields.io/github/license/Zagrios/bs-manager?style=for-the-badge" alt="License"/></a>
<a href="https://github.com/Zagrios/bs-manager/graphs/contributors"><img src ="https://img.shields.io/github/contributors/Zagrios/bs-manager?style=for-the-badge" alt="Contributors"/></a>
<a href="https://github.com/Zagrios/bs-manager/issues"><img alt="GitHub issues" src="https://img.shields.io/github/issues/Zagrios/bs-manager?style=for-the-badge"></a>
<br><br>
<a href="https://discord.gg/uSqbHVpKdV"><img src ="https://img.shields.io/badge/-DISCORD%20-grey?style=for-the-badge&logo=Discord" alt="Discord"/></a>
<a href="https://www.patreon.com/bsmanager"><img src ="https://img.shields.io/badge/-Patreon-052d49?style=for-the-badge&logo=patreon" alt="Patreon"/></a>
<br><br>
<p align="center">[<a href="#readme-bot">go to bot</a>]</p>
</div>

<h1> </h1>

<!-- TABLE OF CONTENTS -->
  <b>Table of Contents</b>
  <ol>
    <li>
      <a href="#about-the-project">About The Project</a>
      <ul>
        <li><a href="#built-with">Built With</a></li>
            <li><a href="#contributing">Contributing</a></li>
      </ul>
    </li>
    <li><a href="#usage">Usage</a></li>
    <ul>
        <li><a href="#how-to-install">How to install?</a></li>
        <li><a href="#manage-versions">Manage Versions</a></li>
        <li><a href="#install-mods">Install Mods</a></li>
        <li><a href="#install-maps">Install Maps</a></li>
        <li><a href="#one-click">One Click</a></li>
        <li><a href="#having-problems">Having problems?</a></li>
      </ul>
    <li><a href="#roadmap">Roadmap</a></li>
  </ol>
</details>

<h1> </h1>

# <div align="center"><b>About The Project</b></div>
<div align="center">
<img src="resources/readme/wip.gif" alt="(WIP) home interface with multiple instance dl and steam & oculus.">
</div>
<br>
<p><a href="../../">Beat Saber Manager</a> was created to unify and improve the two most used tools in the community (<a href="https://github.com/RiskiVR/BSLegacyLauncher">BS legacy launcher</a> and <a href="https://github.com/Assistant/ModAssistant">Mod Assistant</a>).

<h4><a href="../../">Beat Saber Manager</a> will allow you to:</h4>
<ul>
<li><b>Manage instances of multiple versions</b>, designed for people who need to play on different versions or have multiple profiles for the same version.</li>
<li><b>Download your maps in the same way</b>, in addition to that, the maps are not version dependent, so you will be able to find your maps whatever version you are using without having to transfer them.</li>
<li><b>Install your mods in one click</b>, just like <a href="https://github.com/Assistant/ModAssistant">Mod Assistant</a>, <a href="../../">Beat Saber Manager</a> will allow you to install your mods quickly and securely depending on the version you choose.</li>
<li><b>Customize your interface</b>, we know that some of you like to customize your interfaces to the maximum. That's why <a href="../../">Beat Saber Manager</a> brings you peace of mind on this point, you can change the name of the versions, their color, and you can even change the color of the logo! Of course, a dark theme has been added to protect your eyes at night.</li>
</ul>
</p>
<br>
  
## <b>Built With</b>
<ul>
  <li><a href="https://electron-react-boilerplate.js.org/">
    <img src="https://img.shields.io/badge/-Electron%20React%20Boilerplate-black?style=for-the-badge&logo=Electron" alt="Electron React Boilerplate">
  </a></li>
  <li><a href="https://github.com/SteamRE/DepotDownloader">
    <img src="https://img.shields.io/badge/-Depot%20Downloader-2a475e?style=for-the-badge&logo=steam" alt="Depot Downloader">
  </a></li>
  <li><a href="https://rxjs.dev/">
    <img src="https://img.shields.io/badge/-RxJs-purple?style=for-the-badge&logo=ReactiveX" alt="RxJs">
  </a></li>
  <li><a href="https://tailwindcss.com/">
    <img src="https://img.shields.io/badge/-Tailwind%20CSS-white?style=for-the-badge&logo=Tailwind%20CSS" alt="TailWind CSS">
  </a></li>
</ul>
<p align="right">[<a href="#readme-top">Return to top</a>]</p>

## <b>Contributing</b>

<div align="center">
    <h3><b><u>Main Developer</u></b></h3>
    <br>
    <a href="https://github.com/Zagrios"><img src="https://images.weserv.nl/?url=avatars.githubusercontent.com/u/40181755?v=4&h=150&w=150&fit=cover&mask=circle&maxage=7d"></a>
    <br><br>
    <h3><b><u>Support Developer</u></b></h3>
    <br>
    <a href="https://github.com/Zagrios"><img src="https://images.weserv.nl/?url=avatars.githubusercontent.com/u/92525749?v=4&h=150&w=150&fit=cover&mask=circle&maxage=7d"></a>‎ ‎ ‎ ‎ ‎ 
    <a href="https://github.com/Zagrios"><img src="https://images.weserv.nl/?url=avatars.githubusercontent.com/u/40648115?v=4&h=150&w=150&fit=cover&mask=circle&maxage=7d"></a> 
</div>
<p align="right">[<a href="#readme-top">Return to top</a>]</p>
  
<h1> </h1>

# <div align="center"><b>Usage</b></div>

## <b>How to install?</b>
<br>
<ul>
	<li>
		Download the latest release from <a href="https://github.com/Zagrios/bs-manager/releases">Releases</a>.
	</li>
	<li>Execute the installer and BSManager will start itself.</li>
	<li>Once its done if you want to download a version, select a version and download it!</li>
	<li>From the version page you can choose launch options, launch the version, and more from the dropdown menu!</li>
</ul>
<p align="right">[<a href="#readme-top">Return to top</a>]</p>

## <b>Manage Versions</b>
<br>
<p><a href="../../">Beat Saber Manager</a> allows you to manage your versions of Beat Saber. It gives you the ability to download any version of Beat Saber as long as you have a Steam account that already owns the game. Using <a href="../../">Beat Saber Manager</a>, you can easily manage and update your collection of Beat Saber versions.</p>
<br>
<div align="center">
<img src="resources/readme/wip.gif" alt="(WIP) gif with show how to DL and manage version :)">
</div>
<p align="right">[<a href="#readme-top">Return to top</a>]</p>


## <b>Install Mods</b>
<br>
<p><a href="../../">Beat Saber Manager</a> allows you to manage Beat Saber mods in a quick and easy way. It uses the BeatMod API to allow you to install, update or uninstall mods for each version of your collection. So the tool can help you manage them efficiently.</p>
<br>

<div align="center">
<img src="resources/readme/wip.gif" alt="(WIP) gif with show how to dl and update mods">
</div>
<p align="right">[<a href="#readme-top">Return to top</a>]</p>


## <b>Install Maps</b>
<br>
<p>In addition to managing mods, the tool that allows you to manage and organize custom beatmaps existing on Beat Saver, a popular site for sharing custom beatmaps for beat Saber. The tool allows you to view and organize your beatmaps, as well as link different versions of the game to share all your maps together. </p>
<br>

<div align="center">
<img src="resources/readme/wip.gif" alt="(WIP) gif with show how to dl map :D">
</div>

<p align="right">[<a href="#readme-top">Return to top</a>]</p>

## <b>One Click</b>

<div align="center">
<h3>Coming soon</h3>
<img src="resources/readme/wip.gif" alt="(WIP) gif with oneclick interface an use it">
</div>

<p align="right">[<a href="#readme-top">Return to top</a>]</p>

## <b>Having problems?</b>
<br>
<p>
See the <a href="https://github.com/Zagrios/bs-manager/issues">open issues</a> for a list of known issues, from there you can create a new issue for the problem you have!  
Otherwise you can add on to existing issues if one matches what you're encountering.
</p>
<p align="right">[<a href="#readme-top">Return to top</a>]</p>

<h1> </h1>

# <div align="center"><b>RoadMap</b></div>

<div align="center">
<h3>Coming soon</h3>
<img src="resources/readme/wip.gif" alt="(WIP) RoadMap img">
</div>
<p align="right">[<a href="#readme-top">Return to top</a>]</p>

<a name="readme-bot"></a>