SyncSaber is the ultimate plugin for getting amazing new Beat Saber songs to play. It allows you to:
- Magically send any song from bsaber.com to your game with a single click of a button
- Follow mappers you enjoy and automatically have it download new maps of theirs when they release them
- Keep your songs up to date! If a mapper updates one of your maps, SyncSaber fetches the update and lets you play with the latest and greatest.
- Create playlists from your bsaber favorites to share with others.
Important for Beat Saber 1.0+:
Since we’re getting ready to change the format of songs on beatsaver, SyncSaber has not been updated yet to work with version 1.0 and above. Please check back here for updates on the in-game version. For now, you can use the standalone version to use SyncSaber.
To get it working now, instead download the standalone version of SyncSaber
- Download the SyncSaberService.zip
- Next, extract the zip to any folder that you want to store it and open up the SyncSaberService.ini with notepad or a similar text editor
- You’ll want to make sure that the “BeatSaberPath” is correctly set. If you have the Oculus Home version of the game instead of the Steam version, it will probably beC:\Program Files\Oculus\Software\Software\hyperbolic-magnetism-beat-saber instead.
- Next you’ll just need to put in your bsaber.com username and adjust the rest of the settings.
NOTE: If you keep all the settings default, it will download a LOT of songs.
Perhaps consider learning about each option before enabling them all. Here are some good settings to start out with:
(I’m not sure why there’s a place for your password, but you don’t need to put anything in there)
Here are some of the options you can set:
AutoDownloadSongs: Options: 1=yes 0=no. If you want SyncSaber to simply add your songs you favorite to a playlist file and not download them, set this to no. This might be useful if you favorite a lot of songs and later just want to download a couple at a time from the playlist it creates to try them.
AutoUpdateSongs: Options: 1=yes 0=no. If you want SyncSaber to check to see if any of your songs have been updated by the original mapper, set this to 1. If you’ve been really practicing on a specific version of a song and don’t want to chance it being changed, you might consider disabling this.
BeastSaberUsername: Options: Your bsaber.com username. This should be the username you used to create your account (not your email address)
MaxBeastSaberPages: Options: The maximum number of pages to scan for new songs on BeastSaber, 0 is unlimited.
DeleteOldVersions: Options: 1=yes 0=no. Whether or not SyncSaber should keep or delete old versions of songs upon updating them, or when a new release is downloaded from one of your favorite mappers.
As long as you’ve added your bsaber.com username in the config file, you’re ready to get started!
2. Sending Songs From Bsaber.com
1. Adding Bookmarks
While browsing any map on bsaber, you can preview a song with the play button and then you can send it to your bookmarks with the “Bookmark” button if it’s one you want to bookmark. Once “Bookmarked,” the icon will turn black to show it’s been bookmarked.
You can also bookmark maps from the map’s detail page. Click on the map.
And then choose the “Save Bookmark” button at the top. If you want to “Unbookmark it,” you can simply choose “Remove Bookmark.” You can also manage your bookmarks from your profile’s Bookmark page.
2. Managing Bookmarks From Your Profile
When you log into the site, you can get to your profile a few different ways.
- You can click on your name at the top:
- You can click on your name on the right side:
- Or under the “Social” menu, you can click on “My Profile”
Let’s go to your Bookmarks section. On your profile, click on the “Bookmarks” tab. You can also go straight there by pressing the “Bookmarks” button from the “Social” menu at the top.
Here, you can browse through all the songs you’ve bookmarked. This list is shared publicly so you can also go to other user’s pages and see what songs they’re enjoying and bookmarking (there is an option to make your profile private if you so choose)
In addition to removing bookmarks from each map’s page, you can remove bookmarks from this page. Click on the options toggle on each map in your list, then choose “Remove Bookmark.”
If you want SyncSaber to automatically download new maps from a mapper you like, just follow them!
Lets start by looking at a list of “confirmed” good mappers. Click on “Mappers” from the “Social” menu.
We can scroll through a list of mappers, see reviews that have been left for that mapper, click on their profiles to see all the maps they’ve done and then click “Follow” if we want to follow them:
If you want to follow a mapper while you’re browsing their songs, click on the Mapper’s name or avatar:
And then press the “Follow” button from their profile
You can manage all the mappers you are following from your profile, under the “Follows” tab:
From the top menu of the site, you can click on the “Feed” to view any maps that have come out from anyone that you are following:
3. SyncSaber Magic
Once you’ve properly installed SyncSaber and either 1. followed a mapper or 2. added some maps to your bookmarks, you can launch Beat Saber.
You’ll immediately notice some new information at the bottom of your screen. SyncSaber will let you know what songs it’s fetching from your bookmarks or following list and the progress of each download.
Once done, you’ll notice the maps now in your songs list along with a new playlist created of those new songs (so you can easily see what’s new from the rest of your maps.)
This section is extremely short because that’s all there is to it! The rest is magic.
Please let us know if you have any issues or feedback on the BeastSaber Discord: https://discord.gg/cZpFayw