Zagrios
BSManager
Download, manage and customize your versions of Beat Saber with a simple click!
Report Bug · Request Feature · Report a security vulnerability
-
<summary>BSManager: Your Beat Saber Assistant</summary>
-
<summary>Version Management</summary>
-
<summary>Downloading multiple versions</summary>
- via Steam account
- via Oculus (PCVR) account
- Multi-version Sharing
- Importing an existing version of Beat Saber
- Launch arguments
- Shortcut creation
-
-
<summary>Download and Installation</summary>
-
<summary>Customization</summary>
-
<summary>More Information</summary>
BSManager: Your Beat Saber Assistant
What is it?
BSManager simplifies your Beat Saber experience by centralizing the management of mods, maps, and game versions in one place.
Why use it?
- Easy: Manage and switch between different instances of Beat Saber simply.
- Accessibility: Access a multitude of content with just a few clicks.
- Customization: Adapt BSManager to your tastes without technical hassles.
Built With
How to install?
- Download the latest release from Releases.
- Execute the installer and BSManager will start itself.
- Once it's done, if you want to download a version, select a version and download it!
- From the version page you can choose options, launch the version, and more!
Version management
With BSManager, manage your Beat Saber versions with ease, allowing the download of new versions and preserving existing ones, provided that you own the game on a Steam or Oculus (PC) account.
Downloading Multiple Versions
BSManager provides two authentication methods to access your Steam account, ensuring safe and flexible access to different game versions:
- via Steam: Use either your credentials, which will not be stored by BSManager or DepotDownloader, or opt for a quick and secure authentication via QR with the Steam Guard app.
- via Oculus: For Oculus users, BSManager requires you to retrieve a connection token by following the instructions in this guide: How to obtain your Oculus Token. Once obtained, please insert it into the form.
Multi-Version Sharing
BSManager facilitates the sharing of your maps, models, and custom files between different versions of Beat Saber. Thanks to an intuitive user interface, you can easily share your files from one version to another, ensuring a consistent and continuous gaming experience across all your installations.
Importing an Existing Version of Beat Saber
BSManager allows easy importing and organizing of your existing versions of Beat Saber, enabling you to retain all your previously downloaded or created data while taking advantage of BSManager's management features.
Launch Arguments
BSManager provides efficient management of Beat Saber launch arguments, including three predefined ones to enhance your gaming experience:
- Oculus Mode: Launches the game directly in Oculus mode, avoiding the use of STEAM VR.
- FPFC Mode: Enables "FPFC" mode, allowing you to control the game without using a VR headset.
- Debug Mode: Activates debugging mode, generating Windows log outputs for IPA.
You also have the freedom to add your own custom launch arguments by inserting them into "Advanced Launch" and separating them with a semicolon (;).
Shortcut Creation
Create shortcuts to easily access your different versions of Beat Saber with BSManager. After selecting your version, go to the version settings, click on "Create a Shortcut", and then select your launch options. Thus, you can quickly and easily launch your preferred version of Beat Saber with the desired settings.
Download and Installation
BSManager provides centralized and organized management of beatmaps, mods, and models, integrating download features and sharing between Beat Saber versions.
Maps
BSManager integrates the Beat Saver API to provide you with a comprehensive list of maps downloadable directly from its interface. Moreover, the OneClick feature allows you to download maps with one click from various sources such as Beat Saver, BeastSaber, ScoreSaber, and Beat Leader. To add maps, simply select the desired version or the "shared" tab, then click "ADD".
Playlists
Although the playlist management interface is not yet developed, BSManager offers a OneClick feature for playlists from Beat Saver.
Mods
Manage your mods easily with BSManager. After downloading a version, navigate to the "Mods" tab of the selected version to manage and install mods. BSManager operates similarly to Mod Assistant and offers the same mods as this tool.
Models
Add and manage models simply via the corresponding tab on the desired version or by going to the "shared" tab. The Model Saber API is integrated to provide easy and direct access to models available for Beat Saber.
Customization
BSManager offers various options to customize both the tool itself and your Beat Saber instances, allowing you to create a user experience that is uniquely yours.
Tool
Adjust the appearance of BSManager to your preferences with a variety of customization options available in the tool's settings:
- Theme: Choose between a light or dark theme, or follow the system settings for seamless integration into your work environment.
- Color: Select your preferred primary and secondary colors using hexadecimal codes, allowing you to customize the visual appearance of the tool to your liking.
Beat Saber Instance
For each Beat Saber instance, BSManager offers customization options accessible via the version settings and by clicking on "Edit":
- Name: Name your instances in a way that distinguishes and identifies them easily when switching from one to another.
- Color: Customize the appearance of your instances by choosing a specific color for each of them.
More Information
BSManager has an active community and a support team ready to assist you with any questions or issues you may encounter.
Support
For quick and interactive support, it is recommended to join our Discord server. For bugs or more complex issues, you can also submit an issue on GitHub.
Credits
- Zagrios - Mathieu Gries - Lead Developer & Founder.
- Iluhadesu - Co-Developer & Co-Founder, Discord Bot Developer.
- GaetanGrd - Co-Developer & Co-Founder, Documentation Lead.
- cheddZy - Icon Creator.
Contributing
If you'd like to contribute, check out the contributing guide.
Thank you to all the people who already contributed to BSManager!