https://github.com/zagrios/bs-manager

An all-in-one tool that lets you easly manage BeatSaber versions, maps, mods, and even more.
https://github.com/zagrios/bs-manager

beatsaber beatsaber-mods downgrade launcher launcher-application modding-tools

Last synced: 14 days ago
JSON representation

An all-in-one tool that lets you easly manage BeatSaber versions, maps, mods, and even more.

Host: GitHub
URL: https://github.com/zagrios/bs-manager
Owner: Zagrios
License: gpl-3.0
Created: 2022-05-12T20:49:42.000Z (almost 3 years ago)
Default Branch: master
Last Pushed: 2025-04-12T09:04:26.000Z (14 days ago)
Last Synced: 2025-04-13T07:52:21.015Z (14 days ago)
Topics: beatsaber, beatsaber-mods, downgrade, launcher, launcher-application, modding-tools
Language: TypeScript
Homepage:
Size: 254 MB
Stars: 775
Watchers: 12
Forks: 60
Open Issues: 138
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md

Awesome Lists containing this project

README

BSManager

Download, manage and customize your versions of Beat Saber with a simple click!

Report
Bug
·
Request
Feature
·
Report a security vulnerability

Table of Contents

BSManager: Your Beat Saber Assistant

Version Management

Download and Installation
- Features

Customization
- Tool
- Beat Saber Instance

More Information

[Go to bottom]

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.

Start your enhanced experience with Beat Saber and explore all the features
offered by BSManager!

Built With

How to install?

Windows Installation

Download and install BSManager from one of the following sources:

GitHub

Official Website

Nexus Mods

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!

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:

👉 Install Any Map

👉 Install Playlists

👉 Install Mods

👉 Manage Models

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!

[Return to top]

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome