SyncSaber – Send Maps to Your Game from Bsaber.com


SyncSaber is the ultimate plugin for getting amazing new Beat Saber songs to play. It allows you to:

  1. Magically send any song from bsaber.com to your game with a single click of a button
  2. Follow mappers you enjoy and automatically have it download new maps of theirs when they release them
  3. 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.
  4. Create playlists from your bsaber favorites to share with others.


1. Installing

To get started, head over to https://github.com/brian91292/SyncSaber/releases/latest


1. Download the latest plugin DLL and copy it to your game’s “Plugin” folder



2. Once copied, you can go ahead and launch your game and then close it. Doing this will create some new settings for you to configure in your “modprefs.ini”


You will find the Modprefs.ini inside your game install folder, inside the “UserData” folder. Once there, open modprefs.ini in your favorite text editor (if you don’t have one, notepad works just fine)

3. Scroll down until you see the settings for [SyncSaber]


Here are all 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.

  1. You can click on your name at the top:

  1. You can click on your name on the right side:

  1. 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.”


Following Mappers:


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


Comments (9)
  1. Kolezan says:

    This mod is such a quality of life improver and coupled with BSaber.com it’s one of the best mods for Beat Saber. It’s so easy and powerful!

  2. Seems like this doesn’t work.. :/

    1. Hey! Are you on Discord? I’d be happy to help get it working for you! There’s a couple common problems with easy fixes that I’ve seen from a few users that I’ll probably be adding to this page too.

      1. Got it working, I needed to restart Oculus Home to get it working. Just closing the game didn’t work. SyncSaber always said “All songs updated”.

        Or maybe it just needed some time to sync because this is a new account? However it works now.

        1. Glad to hear! Here’s the advanced trouble shooting guide here if you run into any other issues! https://www.notion.so/beastsaber/Common-Issues-With-Easy-Solutions-f99bdd13b13a4dfc82cafaf506e1ee1c

  3. Nine says:

    Any way to sync bookmarked playlists?

  4. JeffCraig says:

    I really like this plugin and I have a feature request!

    I have mods in my stream chat that bookmark music when viewers request songs. I would really love to have a button that would sync any pending music to be downloaded without having to restart the game!

    If there’s a place I can make a formal feature request, please let me know!

  5. phwoaaa says:

    Does this automatically delete any doubles we have ?

    And can anyone explain how the map packs?

    example : https://bsaber.com/maps-for-new-players/

    It just gives me a .json file? do i somehow input the file into the game for it to start downloading?

    Thanks in advance 🙂


Leave a Reply

Your email address will not be published. Required fields are marked *