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: about 17 hours 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 (over 2 years ago)
• Default Branch: master
• Last Pushed: 2024-04-11T17:11:55.000Z (8 months ago)
• Last Synced: 2024-04-11T19:37:26.615Z (8 months ago)
• Topics: beatsaber, beatsaber-mods, downgrade, launcher, launcher-application, modding-tools
• Language: TypeScript
• Homepage:
• Size: 189 MB
• Stars: 387
• Watchers: 7
• Forks: 32
• Open Issues: 69
• 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

          


            
What is it?

            
Why use it?

            
Built with

            
How to install

          

        

      

      


        

          Version Management

          


            


              

                Downloading multiple versions

                


                  
via Steam account

                  
via Oculus (PCVR) account

                

              

            

            
Multi-version Sharing

            


Importing an existing version of Beat Saber

            

            
Launch arguments

            
Shortcut creation

          

        

      

      


        

          Download and Installation

          


            
Maps

            
Playlists

            
Mods

            
Models

          

        

      

      


        

          Customization

          


            
Tool

            
Beat Saber Instance

          

        

      

      


        

          More Information

          


            
Support

            
Credits

            
Contributing

          

        

      

    

  

  


    [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 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!

  





  





  
Linux installation

  
Refer to Linux wiki





  


  
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.

    


Insprill - Co-Developer, Linux Developer, AUR Maintainer.

    


silentrald - Co-Developer, Linux Developer, deb and 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]