## Table of Contents

- [With BSManager](#with-bsmanager)
- [Manual Installation](#manual-installation)
- [One-Click Installation](#one-click-installation)

## With BSManager

1. Download and install [BSManager](https://www.bsmanager.io) from [GitHub](https://github.com/Zagrios/bs-manager/releases/latest).
2. Launch [BSManager](https://www.bsmanager.io) and select the Beat Saber version where you want to install maps from the list on the left of the interface.
3. Go to maps by clicking on the __`Maps`__ tab.
4. Click on the __`Add`__ button to access the list of online maps.
5. Find the maps that you want to install from the provided list. You can use the search bar at the top of the interface to filter maps by __`name`__, __`type`__, __`mods`__, __`tags`__, __`notes per second`__, __`duration`__, and order the list by __`latest`__, __`relevance`__, __`rating`__, or __`curated`__.
6. Double-click on the map or simply click on the download button to install the map.
7. Wait for the installation to complete. Once it's finished, you can launch Beat Saber directly from [BSManager](https://www.bsmanager.io) to enjoy your new maps!

## Manual Installation

1. Find the map you want to install on a site like [BeatSaver](https://beatsaver.com).
2. Download the map to your computer.
3. Open [BSManager](https://www.bsmanager.io) and select the version of Beat Saber to which you want to install the map.
4. Click on the version options at the top-right corner of the interface, then select __`Open Folder`__.
5. Move the downloaded map `.zip` file into the __`CustomLevels`__ folder, which is located at `Beat Saber_Data\CustomLevels`.
6. Right-click the `.zip` file, select __`Extract All`__, then press __`Extract`__ in the popup. You can then delete the `.zip` file.
7. Launch Beat Saber, and the map should now be available to play.

## One-Click Installation

1. Launch [BSManager](https://www.bsmanager.io) and make sure that the One-Click installation feature is enabled for maps.
2. Go to one of the supported websites and search for the map you want to install.
3. Once you've found the map, click on the __`One-Click`__ or __`Install`__ button on the website.
4. A pop-up window will appear, asking for confirmation. Click on __`Yes`__ to proceed with the installation.
