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>BS Manager</b></h2>
  <i align="center">(Beat Saber Manager)</i>
  <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>
<a href="https://discord.gg/uSqbHVpKdV"><img src ="https://img.shields.io/badge/-DISCORD-5865f2?style=for-the-badge&logo=discord&logoColor=ffffff" alt="discord"/></a>
<a href="https://mee6.xyz/fr/m/bsmanager"><img src ="https://img.shields.io/badge/-🥰%20Support%20BSM-EC4546?style=for-the-badge" alt="Donation"/></a>
<a href="https://discord.gg/uSqbHVpKdV"><img src ="https://img.shields.io/badge/-Twitter-F5F8FA?style=for-the-badge&logo=Twitter" alt="Twitter"/></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>
  </ol>
</details>

<h1> </h1>

# <div align="center"><b>About The Project</b></div>
<div align="center">
<img src="resources/readme/preview.png" alt="(WIP) home interface with multiple instance dl and steam & oculus.">
</div>
<br>
<p><a href="../../">BS 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="../../">BS 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="../../">BS 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="../../">BS 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="../../">BS 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="../../">BS Manager</a>, you can easily manage and update your collection of Beat Saber versions.</p>
<br>
<div align="center">
<img src="resources/readme/manageVersion.gif" alt="gif with show how to DL and manage version :)">
</div>
<p align="right">[<a href="#readme-top">Return to top</a>]</p>

## <b>Customize your instances</b>
<p>The tool will allow you to completely customize each of your downloadable versions, you can change the color of the icon, choose a name for the instance and finally install your mods and map according to the Beat Saber version! </p>
<br>
<div align="center">
<img src="resources/readme/customVersion.gif" alt="gif with show how to custom your version :)">
</div>
<p align="right">[<a href="#readme-top">Return to top</a>]</p>

## <b>Install Mods</b>
<br>
<p><a href="../../">BS 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/installMods.gif" alt="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/installMaps.gif" alt="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>

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