# Welcome to the BSManager Wiki

BSManager is your all-in-one tool designed to simplify and enhance your Beat Saber experience. With BSManager, you can effortlessly manage game versions, mods, maps, and more, ensuring a seamless and enjoyable gameplay journey.

## 📚 Guides

Our comprehensive guides are crafted to assist you in maximizing BSManager's capabilities:

### 🛠️ Installation and Updates

Step-by-step instructions to install BSManager on your system and keep it up to date

- [Install BSManager on linux](install-bsmanager-on-linux)
- [Install or import a version](install-or-import-a-version)
- [Create a shortcut](create-a-shortcut)

### 🔑 Login

Guidance on logging into BSManager to access all features

- [Get your Oculus token](get-your-oculus-token)

### 🎮 Content Management

- __🗺️ Maps__: Learn how to download and organize custom maps for endless entertainment.
    - [Install any map](install-any-map)
    - [Install all playlists you want](install-all-playlists-you-want)
- __🧩 Mods__: Discover how to install, update, and manage mods to enhance your gameplay.
    - [Install mods on your version](install-mods-on-your-version)
- __🖼️ Models__: Find out how to integrate custom models into your Beat Saber experience.
    - [Modify models in your Beat Saber](modify-models-in-your-beat-saber)

### 🤝 Contribution

Information on how to contribute to the development and improvement of BSManager

- [Help us update the wiki](help-us-update-the-wiki)
- [Contribute to the project](https://github.com/Zagrios/bs-manager/blob/master/CONTRIBUTING.md)
- [Activate Oculus Sideloading](Activate-Oculus-sideloading)

## 🐞 Troubleshooting

Our troubleshooting section is here to help you resolve common issues quickly and efficiently:

<!-- ### ⚙️ Connection Issues: Solutions for problems related to connecting BSManager to required services. -->

### 💾 Installation Problems

Guidance on fixing errors during setup or version updates

- __🐧Linux__:
    - [Missing Icons in Game]([Linux]-Missing-Icons-in-Game)
    - [Permission Denied on "bs-versions.json"]([Linux]-Permission-Denied-on-bs-version.json)
    - [[deb] The SUID Sandbox Helper Binary Was Found]([Linux]-[deb]-The-SUID-Sandbox-Helper-Binary-Was-Found)
    - [[Flatpak] Steam Beat Saber Version Not Showing / Proton Not Detected]([Linux]-[Flatpak]-Steam-Beat-Saber-Version-Not-Showing-Proton-Not-Detected)
    - [[Flatpak] Changing Installation Folder]([Linux]-[Flatpak]-Changing-Installation-Folder)

<!-- ### 🎮 Gameplay Issues: Fixes for issues impacting Beat Saber performance. -->

### 🔍 Debugging Tips

Steps to gather logs and identify specific issues

- [How to find your logs](how-to-find-your-logs)
- [Submitting a bug report](https://github.com/Zagrios/bs-manager/issues/new?assignees=Zagrios&labels=bug&projects=&template=1-bug-report.yaml&title=%5BBUG%5D+%3A+)

***

We are committed to keeping this wiki up to date with the latest information and best practices. Your contributions are welcome; please refer to our [Help us update the wiki](help-us-update-the-wiki) to get started.

For additional support and community interaction, join our [Discord server](https://discord.gg/uSqbHVpKdV).

Thank you for using BSManager!
