elliotttate Tutorials

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, simply open up the ModSaber Installer (download here if you don’t already have it) and check the SyncSaber mod and press install / update.

CleanShot 2019-02-10 at 21.58.19@2x.jpg


Next, launch your game, go into “settings” and choose the “SyncSaber” settings. Here, you can set quite a few options:

CleanShot 2019-02-10 at 22.01.32@2x.jpg

If you hover over each option, you’ll get a description of what they do. The main things that you’ll need to set are your BeastSaber Username and the setting to sync your Bookmarks.


To set your SyncSaber settings outside of the game (optional) 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 (20)
  1. Nine says:

    Any way to sync bookmarked playlists?

  2. 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!

  3. zerogravity says:

    Seems like this doesn’t work.. :/

    1. elliotttate says:

      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. zerogravity says:

        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. elliotttate says:

          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

  4. Jcs says:

    still not available for 0.13.0?

    1. elliotttate says:

      Here is the download link for the new version that works with .13 https://www.modsaber.org/mod/syncsaber/1.3.5

  5. 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!

  6. 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 🙂

    1. elliotttate says:

      Yes, just copy the JSON file to your Playlists folder in your game directory. Here’s a more in-depth tutorial: https://www.notion.so/beastsaber/Playlists-BeatDrop-Tutorial-e3faf856c3b14b08a51190d8a65a033c

  7. ramingham says:

    Is this being updated for the new version of beatsaber?

    1. elliotttate says:

      Hey! It actually just got updated yesterday

  8. Hamiwami says:

    Where can i request songs >-<

    1. elliotttate says:

      Request them in either the Discord in the #song-requests channel or on the /r/beatsabersongs subreddit

  9. Carmella Alt says:

    I know this web site presents quality dependent content and extra stuff, is there any other web page which offers these kinds of stuff in quality?

  10. Hmm it seems like your website ate my first comment (it was super long) so I guess I’ll just sum it up what I had written and say, I’m thoroughly enjoying your blog. I too am an aspiring blog blogger but I’m still new to the whole thing. Do you have any tips and hints for first-time blog writers? I’d certainly appreciate it.

  11. Tristan Beet says:

    I’ve been exploring for a little bit for any high-quality articles or blog posts on this kind of area . Exploring in Yahoo I finally stumbled upon this site. Studying this information So i’m glad to express that I’ve a very excellent uncanny feeling I found out exactly what I needed. I such a lot for sure will make sure to do not fail to remember this web site and give it a glance regularly.

  12. At this time I am going away to do my breakfast, afterward having my breakfast coming over again to read more news.


Leave a Reply

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