BSManager
Download, manage and customize your versions of Beat Saber with a simple click!
Report Bug · Request Feature · Report a security vulnerability
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?
Windows Installation
Linux Installation
BSManager is also available on Linux! Follow the step-by-step guide in our Linux installation wiki to set it up properly.
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 allows you to safely and easily access different versions of Beat Saber, ensuring flexibility for modding or version-specific preferences.
To download a version, you can authenticate using two methods:
- via Steam: Authenticate securely using your Steam credentials or by scanning a QR code with the Steam Guard app.
- via Oculus: BSManager redirects you to the official Oculus website for authentication to retrieve your token securely. Alternatively, you can follow this guide to obtain your token manually and paste it into BSManager.
For detailed instructions on installing versions, follow this tutorial: 👉 How to install or import a version
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 advanced management of launch arguments for Beat Saber, allowing you to customize your gaming experience.
Predefined Arguments
- Oculus Mode: Allows you to use Oculus's VR composer while bypassing SteamVR, which may improve performance. (Only useful if you launch the game via Steam).
- FPFC Mode: Enables "First Person Flying Controller" mode, allowing you to navigate menus using the keyboard (WASD) and mouse without a VR headset.
- Debug Mode: Activates the IPA debug console, displaying logs used by mods.
- Skip Steam: Prevents Steam from opening automatically with Beat Saber, useful if you use an alternative VR runtime like WIVRn or Monado.
- Map Editor: Launches the official Beat Saber map editor instead of the game.
Custom Arguments
You can also add your own custom launch arguments by inserting them into "Advanced Launch" and separating them with a semicolon (;).
Pinning Arguments
You can now pin your favorite launch arguments for quick access. By default, only Oculus Mode and Debug Mode are pinned.
Shortcut Creation
Create shortcuts to easily access your different versions of Beat Saber with BSManager.
To learn how to create a shortcut, follow the tutorial available here: 👉 Shortcut Creation Guide
This allows you to quickly and easily launch your preferred version of Beat Saber with the desired settings.
Download and Installation
BSManager centralizes and simplifies the management of beatmaps, playlists, mods, and models, offering seamless downloads and sharing between different Beat Saber versions.
Features
With BSManager, you can manage your:
- Maps: Browse and download maps directly from sources like Beat Saver, BeastSaber, ScoreSaber, and Beat Leader.
- Playlists: Search for and download playlists directly from BSManager, just like maps. 😉
- Mods: Manage and install mods via the "Mods" tab, offering the same features as Mod Assistant.
- Models: Add and manage models easily with the integration of the Model Saber API.
For detailed instructions on each feature, check the following guides:
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 - Lead Developer & Founder.
- Iluhadesu - Co-Developer & Co-Founder, Discord Bot Developer.
- GaetanGrd - Co-Developer & Co-Founder, Documentation Lead.
- cheddZy - Icon Creator.
- Insprill - Co-Developer, Linux Developer, AUR Maintainer.
- silentrald - Co-Developer, Linux Developer, deb/rpm/flatpak Maintainer.
Contributing
If you'd like to contribute, check out the contributing guide.
Thank you to all the people who already contributed to BSManager!