How To Install Custom Songs & Mods On Beat Saber For Oculus Quest

The Oculus Quest hasn’t even been out for a week and yet, after a LOT of work from so many incredible modders, we’ve finally created a fairly easy way to get custom songs on the Oculus Quest version of Beat Saber!

Last week, emulamer and I got a proof of concept working, replacing an OG song in the Quest version. Someone leaked the video on Reddit.

That garnered a bit of attention and various articles from news sites like RoadToVR and VRScout reported about it.

Since then, emulamer and other extremely talented modders such as trishume have done some incredible work to add new songs instead of just replacing the OG ones. Also, much of the process has been automated to allow for almost anyone to do it!

It’s hard to describe how amazing having the FULL Beat Saber experience on a completely portable system is. I have all of the Fantastic Flow playlists, the 100k contest playlist and the Anniversary playlist on my Quest and had an amazing time playing through them in an abandoned Tennis court yesterday evening.


How To Install Custom Songs


One of the easiest way to get going is to download SideQuest here

SideQuest is extremely easy to use and supports Windows, Mac and Linux! We’ll have a full text guide up soon for it. You can jump into the app to get started or watch this fantastic tutorial video by Virtual Reality Oasis here:


One thing that makes SideQuest so easy to use is the direct integration into where you can use the “One Click To Install” button to easily get more songs into your Quest. It also has a song manager to easily removed songs you no longer want too.


To request new features or get help, join the SideQuest Discord here or open an issue on Github

Once you have SideQuest installed, we highly recommend installing BeatOn to add more songs from your Quest without needing to hook up your Quest to your PC each time.

BeatOn Dark.png

Refer to the BeatOn guide here


Other, Alternative Methods

BeatSaber Quest Installer by NyanBlade

You can watch one of the videos below for an alternative installer by NyanBlade


Here is a link to download NyanBlade’s GUI Installer for Emulamer’s code shown in the video.

Emulamer’s Command Line Installer

Use this if a command line doesn’t scare you! It also supports playlists!

Trishume’s Command Line Patcher

This is the patcher that SideQuest uses. If you don’t know what you’re doing, use SideQuest instead!

Status of Other Mods

Right now, full modding support isn’t available, only custom song loading, so you won’t have mods like SyncSaber or even ScoreSaber to track your scores online (local leaderboards will have to do for the moment). We do have a custom color mod and custom saber / environment mod that we’ll be releasing soon.

The good news for feature rich mods like Scoresaber is that some extremely smart people are working on it now and those types of mods should only be a matter of time. It’s an exciting time that we live in and with the Quest costing on $399 for a full Beat Saber platform, we could easily see the size of our massive community triple as I know SO many people buying one who couldn’t afford to get into VR before.

Update Log

June 1, 2019:

Several mod installers continue to be refined including SideQuest and Quest support directly from BeatDrop 2!

We also got Custom Saber’s working, so look for options to install those in the Quest installers soon!

June 2, 2019: 

Custom Colors mod created by leo60228! It’s the first example of a more advanced mod and is a fantastic example of what other mods we can start to see soon! We’ll be updating it into the installers soon.

June 3, 2019

SideQuest now has Beat Saber Quest Mod Installing with support for Mac, Windows and Linux along with song management and “one click” installing of songs from Download SideQuest here

June 4, 2019

A sneak peek at custom colors, custom text and playlist support that will be in the installers soonish

June 5, 2019

New Beat Saber version 1.0.1 released for Quest! Updates include:

  • Fixed sound glitch in some Expert+ levels.
  • Removed ambient lighting. Total darkness is possible again.
  • Fixed mirror rendering bug.
  • New precise scoring system.

New Beat Saber version 1.0.2 hotfix released!

  • DLC Downloading Fix
  • Official Casting Support!

To get custom songs working again, you’ll need to download the latest update of SideQuest or alternative Quest mod installer.

1.0.2 SideQuest Update Instructions:

You will need to reset your beat saber install by uninstalling and reinstalling from the oculus store. Lots of people have issues uninstalling on the actual headset so we recommend that you use the uninstall feature in SideQuest – it should always work.

Uninstall Image

In order to upgrade everything you will need to open the backups screen

Backup Screen

You then need to select the “REDOWNLOAD PATCHER” button

Backup Screen

After a moment to download the patcher you will see this screen. It is important that before you click “BACKUP NEW MASTER” that you have already downloaded a fresh copy of beat saber from the oculus store. Remember to use SideQuest to uninstall first ( See Above )

Backup Screen

Still not working?:

IF you still see an error after this, please start by first redownloading beat saber from the oculus store. Remember to use SideQuest to uninstall first ( See Above ). Then you can reset from master again in the backup screen. Select “BACKUP NEW MASTER” and then “RESET PATCHED TO BASE” and then try to sync again.


June 7, 2019

Lots of work being done to improve modding and copying large libraries in addition to other modding breakthroughs. Now, as an alternative to SideQuest, NyanBlade updated his installer to support Beat Saber 1.0.2.

Pro tip for competitive play until Scoresaber is modded into Quest Beat Saber – battle yourself! Play the party mode instead of the single player mode. Each day that you play, write the current day’s date as your name so you can compete against yourself.

The leaderboard will be filled with your scores you placed on each day and you’ll be battling to try to beat that high score you somehow managed to get that one time when there was a full moon and you had just the right amount to drink 😉

June 8, 2019

Custom Saber Colors, Custom Text and Playlist support is here! Right now, you’ll need to use the command line installers to get these features, but they’ll be added to SideQuest in the next update! (hopefully later today)



June 9, 2019

SideQuest now has custom colors, custom text and playlist support! To get started, you’ll need to download the latest version of SideQuest here

Once you open SideQuest from the update, you’ll also need to click the “Redownload Patcher” button.


Here’s a great overview video about the update!

If you want to change any text in the game, here is a list of some of the variables you can use

June 11

Beat Saber 1.1.0 is released! With it comes some interesting changes from a code perspective that could make things easier for us. It also includes the second official DLC pack – the Imagine Dragons DLC. There’s an amazing showcase of fantastic mapping in it, so I highly recommend checking it out.

There’s a new version of SideQuest that works with this new Beat Saber version. Here’s the change-log notes for SideQuest

Hi Folks!

This update brings with it support for the new Beat Saber 1.1.0. After you download and open SideQuest you will need to redownload your patcher to get the latest support for beat saber 1.1.0
If you have the latest beat saber you might want to click “backup new master” in the backups screen too!
Other changes:

  • Fixed a bug causing an Ionic.Zip error.
  • Fixed a bug causing songs not to be added to the default Custom Songs pack

NOTE: We’re in the middle of implementing a brand new version of beatsaver, so downloading is still down until later today

June 12

The new Beatsaver rewrite is up and downloading is working again! You’ll need to download the latest SideQuest update here to start downloading songs again (once you do, everything should work like it did before)

The new Beatsaver rewrite now stores songs in the official Beat Saber Custom Songs format, so it’s one less step that SideQuest needs to do when copying songs to your device. Beatsaver has been rewritten from the ground up and is the solution to a lot of bugs we’ve been dealing with for a while now. Whenever the official support for custom songs lands on the Quest, you won’t even need a mod to copy songs over (though SideQuest will always be a fantastic manager to make that process as easy as possible).

July 10

The release version of BeatOn is finally here! You no longer need a PC to install new songs, sabers and mods, you can do it all from your Quest now!

Go here to get started!

Comments (33)
  1. This is so amazing! I knew custom songs would come to the Quest, but certainly didn’t expect them this quickly! The modders – all of them – are just amazing, putting in so much time and effort just to benefit the rest of us! Did you know you can donate to the modders? Check it out over on the Beat Saber Modding Group discord!

  2. baxter395 says:

    This is beyond amazing!

    1. Hvirin says:

      Hi Baxter!
      Thank you for your maps and sorry for asking, but I really like your coldplay map (“something just like this”). Unfortunately, after the site update, I cannot find your version anymore :(. Do you happen to know why? Because it really is a shame that it isn’t here anymore :(((

  3. chris cranford says:

    hi im chris i just downloaded sidequest and a pparently there was an update for beatsaber and when i try to sent the songs i got yo the quest it says we are working on an update do i have to reinstall this again to the latest version or will the update appear on the sidequest app

    1. JaaayTk says:

      I’m having the same problem. I’ve fully updated and have done as said in the instructions and for some reason it says on the bottom left of sidequest that “we are rolling out with a new beatsaver update” and that downloading is disabled. I’ve tried redownloading everything and it does not fix it.

      1. lolroflbbq says:

        I’m having the same issue today, I’m hoping as they said in their update that the site will be up again today and it’ll be working again, finally got the damn thing to work yesterday right before the site update then it went down for the update and couldn’t add anymore songs lol. I was sad. I’ve also updated to the latest version this morning and downloaded the latest patch through the app but now when you try to add a song it just gets stuck on adding song to your library.

  4. Bret Neiderman says:

    My install failed with Sidequest.

    Got this error:

    System.IO.InvalidDataException: End of Central Directory record could not be found. at System.IO.Compression.ZipArchive.ReadEndOfCentralDirectory() at System.IO

    1. Seth says:

      Same. Did you find a fix?

      1. elliotttate says:

        I saw someone mention that here:

        Can you try the latest update to see if that fixed it?

    2. Andrew says:

      Hey there,
      I also had the same issue. I followed the instructions step by step and kept getting the same error message. I tried it again with only one song and it worked! No error message. I then added a few more songs each time, and it worked great. I was initially trying to send over 36 songs on first shot — maybe that’s why it was giving me that message?? Whatever the case may be, I tried with one, worked great, and now I have over 50+ songs sent over to the Quest. Yay!!!

  5. Bret Neiderman says:

    Oops not the entire error: This is the entire error.

    System.IO.InvalidDataException: End of Central Directory record could not be found. at System.IO.Compression.ZipArchive.ReadEndOfCentralDirectory() at System.IO.Compression.ZipArchive.Init(Stream stream, ZipArchiveMode mode, Boolean leaveOpen) at System.IO.Compression.ZipArchive..ctor(Stream stream, ZipArchiveMode mode, Boolean leaveOpen, Encoding entryNameEncoding) at System.IO.Compression.ZipFile.Open(String archiveFileName, ZipArchiveMode mode, Encoding entryNameEncoding) at jsonApp.Program.RunInvocation(Invocation inv) in C:\projects\QuestSaberPatch\jsonApp\Program.cs:line 60, Error: /data/local/tmp/_stream.apk could not be installed [INSTALL_PARSE_FAILED_UNEXPECTED_EXCEPTION: Failed to parse /data/app/vmdl963894843.tmp/base.apk: AndroidManifest.xml]

    1. Seth says:

      Same. Did you ever figure this out?

  6. Anon says:

    I found the answer on a reddit post so I thought I’d come back and let everyone know here as well.

    had this problem and managed to fix it using a solution mentioned on the discourse server.

    Open the backups page, and click the button to select a new base apk. Then navigate to and select the beatsaber backup file you created before attempting to sync, which should located in c:/users//appdata/roaming/sidequest/beatsaber backups (something like that).

    After setting this as your base apk, try to sync the songs again. It will fail and give you the same error, but this time click the button to “reset to base apk”. Before, this function wouldn’t work, but now having selected the backup file as your base apk, it’ll work. When it finishes, try again to sync the songs. This time the patching process should succeed, and allow you to install the patched apk.

    I think this error everyone is getting has to do with the program not recognizing where the base apk is for it to patch.

    Let me know if this works for you.

  7. Justin says:

    I need help. I keep trying to sync songs but it keeps telling me i have the wrong beat saber version. I have uninstalled and reinstalled the game and still i get this error. Please help me with this. Thanks

    1. Justin says:

      Ok sorry everybody. I got the problem fixed and the song transferring is working great. I just had to reinstall the program on the computer from scratch and now it works great. Thankyou and i will be supporting this group.

  8. baxter395 says:

    The Nintendo of VR has arrived.

  9. TaiShu says:

    Hey Brian. How did you manage to get the 100k contest playlist and others uploaded to the Quest? Is it a piece by piece approach or is there a “the whole playlist at once” approach?

  10. James says:

    Same error here:

    End of Central Directory record could not be found

    Any advice?

  11. lolroflbbq says:

    Can anyone help since the site update yesterday everytime I try to add a song in the app it just sits there and spins on ‘Saving to my Custom Levels’ is this because I’m doing something wrong? I downloaded the patch. Is it because the sites being updated?

  12. 8bitninja says:

    Im having trouble previewing songs on the site. Keep getting “zip requires CORS headers” error message.
    Any help would be very much appreciated. Thanks!

  13. Jules lewis says:

    Can I pay someone to put my ministry songs as custom songs? I am extremely willing to pay and keep supporting financially just to have my ministry songs on BeatSaber.

  14. CheapAF says:

    Do you need to purchase the full game to sideload custom tracks, or can you do so with just the demo?

  15. Linus says:

    Awesome! Thanks to all people making this possible for us.

  16. Anthony Price says:

    Any news on a new version of the Quest Song Loader by Nyan Blade? It’s only been a day since I updated Beat Saber and I’m missing it like crazy!!! I have also started making my own maps and want to test my first one 😁

    1. elliotttate says:

      Nyan’s hasn’t been updated yet, but have you tried SideQuest yet?

  17. Tower72 says:

    Looking at the underlined list for the text variables, clicking it does nothing at all, is it supposed to be a link? Wanted to change some things but the list doesnt open.

  18. Phil says:

    Hey there!

    Buying a Quest just for this. Is there any way of using the easy method through side quest to install songs downloaded from Beat Saver? There are songs on that site I would like to try but the tutorial doesn’t show how to do that? I am sure it is going to be something stupid like dragging and dropping something into a folder but any help would be greatly appreciated!

  19. ThroChainWinLane says:

    The only reason i was holding back on getting a quest was the lack of custom songs

    I guess now I have everything I need

  20. Amit says:

    I tried 6 times and it does not work when I tries to play beat saber than it saing that it has a update and if I say yes ut stop the hole system

  21. Daniel Bruch says:

    I’ve got it running. But is it possible to save the score in custom beat saber songs, which i’ve imported via SideQuest + Beat On?

    My version doens’t count any scores. I’ve bought an original copy of the game. Thanks for your help!

  22. Samuel Baker says:

    Hello! I’m having SERIOUS problems with Beat Saber and really hoping someone in this awesome community can help. First of all, I haven’t turned my VR on in about 4-5 months. When I tried it again, Beat Saber is seemingly having numerous problems. The problems include not being able to select anything in the menu other than SPECIFIC elements like mods and scoreboards. If I try to start the game on Solo or Campaign, it will act like it’s clicking but not do anything. It’s not hardware–checked other games. What’s weird is after multiple restarts sometimes I get into a song. But then EVERY time my Sabre goes right through the notes with no contact–similar to the bug that happened waaay earlier if you tried playing after an update with mods installed. I’ve tried reinstalling entirely. I’ve tried deleting the Hyperbolic Magnetism folder in AppData. I just now tried turning on the Beta in the game properties–but too exhausted to keep troubleshooting. Will the Beta toggle have done it? Is there anything else I can try? AM I NEVER PLAYING BEAT SABRE AGAIN? (feelsbadman)

  23. Good morning

    I trust that this message finds you well. I have tried to contact you via email but it has bounced twice now so I am giving your contact form a go.

    I enjoy blogging in my spare time and I have written a couple of articles for your blog

    Please find them attached on my Google drive:

    Do let me know what you think and do send me the links to the articles once you have managed to publish them.

    Also, do let me know if you would like me to write some more articles for your blog.




Leave a Reply

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