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


How To Install Custom Songs

SideQuest & BMBF

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! Think of SideQuest as the “Alternative App Store.” It also makes sideloading apps from APK’s very easy to install.


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

Once you have SideQuest installed, you’ll need to install BMBF.

The Unicorns have been hard at work once again, and bring us BMBF for the latest Beat Saber! We at the BSMG have reviewed the source and can confirm it’s 100% safe.
Make sure you follow these instructions carefully:
  1. Make sure to run Beat Saber UNMODDED FIRST. 
  2. Then install BMBF. Do this by dragging and dropping the BMBF APK file on the top left corner of Sidequest.

Download BMBF

You can find the BMBF 1.12.1 release here for Beat Saber 1.12.1

To install, simply drag it into Sidequest, then launch it from within unknown sources on your Quest. BMBF will prompt you through a couple steps and get you all setup to get started!

If you want more guidance, watch one of the fantastic tutorials here:



For a fantastic written guide, visit our friends at!


Managing BMBF on your PC (optional)

To view BMBF on your PC or Mac and manage your songs and mods there, type in  your Quest’s IP address along with :50000 at the end. Example: or

To find your Quest’s IP, you can look at the top of Sidequest.


Downloading Mods

There’s a lot of mods to do really fantastic things that you can find in the #quest-mods section of the BSMG Discord or in the Released mods tab of QuestBoard.

To install mods, either download it on your PC and drag it into BMBF (See “Managing BMBF On Your PC” above) or click on the mod download links on QuestBoard from within BMBF, then toggle it on in the BMBF mod section.


Easily Download Songs From Bsaber using SyncSaber / BeatSync

BeatSync is the ultimate plugin for getting amazing new Beat Saber songs to play. It’s built into BMBF and allows you to:

  1. Magically send any song from to your game with a single click of a button (and from any device, whether that’s from your phone, your work computer, the library, etc.)
  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.

Create playlists from your bsaber favorites to share with others.

Need additional help?

Find troubleshooting steps on the BSMG Wiki or ask in the #quest-help channel in the BSMG Discord!

Comments (124)
  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!

    1. Bennett H says:

      Even though I don’t have a quest It’s still pretty amazing how fast the beat saber mod devs are. There are so many useful mods and everything is quickly updated. It’s especially impressive for a vr game.

    2. robert says:

      Hi you know where we can request a song to be mapped,. Alan Walker 135. Thanks

  2. baxter395 says:

    The Nintendo of VR has arrived.

    1. rodent says:

      but nintendo labo vr flopped

      1. captasti says:

        … so what??

  3. Steven Coyle says:

    i must be the only one to have ever recieved this message for trying to install the resigned APK.

    Restore App

    our platform abuse policy prohibits piracy, illicit modding, cheating, and other unauthorised usage.

    if this unofficial version of Beat Saber is not for development purposes, please restore the app to the oculus store version now.

    is BMBF illegal now? happened on May 5th, 2020

    1. Bearrunner10 says:

      nah because its modded the quest thinks its a pirated copy of beatsaber sometimes but its legal in the Ts and Cs to have bmbf so dont press restore

  4. 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 :(((

  5. yukine9673 says:

    sorry please upload newest mapping extensions downloading URL? i bought bs yesterday and tried to install mods andcustom songs but above url that for bs ver1.5.0 so i hope uploading for newcomer or new bs ver

  6. Dan says:

    Does this still work after all the changes with the Panic at the disco update?
    This was my single reason to get a quest. Otherwise I’ll just stay with my vive and custom beat saber songs on PC.

  7. Wouter says:

    Does this method still work after Oculus’ policy update?

    1. Androidappbd says:

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

      1. Dude, what do you think? no. the demo doesn’t have half of the code needed for the game, is outdated, and piracy is literally illegal.

  8. Avi Bouhadana says:

    Does BMBF support latest version of Beat Saber?

  9. 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.

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

  11. numnums says:

    any chance on making a mod to easily install custom sabers directly on the quest?

  12. Dave says:

    This is great, thank you. Just a word of warning to other thought – you will lose you current scores in party mode. My family weren’t best impressed 😀

  13. Matteus says:

    Does this not work on the Quest 2? It dosen’t seem to want to uninstall Beatsaber for me.. It just gets stuck on “please wait”

  14. Linus says:

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

  15. 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?

  16. James says:

    Same error here:

    End of Central Directory record could not be found

    Any advice?

  17. 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.

  18. 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?

  19. 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.

    1. Colleen Williams says:

      Me, too. I’m dying to play to Amerikkkant and KEAH.

  20. lethe300 says:


    Many thanks to all the things you do to have custom songs available for Oculus Quest!

    I am having trouble detecting my Quest device with SideQuest. Meanwhile my computer recognize it, but sidequest does not…no matter how many times I disconnect and reconnect it and allow computer to read it. Any suggestions?


  21. Jowwn says:

    Hello, I’m trying to install BMBF on my Quest, I followed the tutorial of this video:
    but that does not seem to work. In loading configuration (3min12 of the video), it gives me and error saying “Something has gone wrong” and “BMBF can not function. Try Reset Assets in the tool menu. “But I cant find reset assets. Can you help me?

    1. deconomist says:

      I am having this same exact issue and cannot get BMBF to work. Any ideas on how to fix this?

    2. Mike says:

      Same issue here, I started to have this same error message after I installed the latest Beat Saber from oculus store.

  22. Ryan says:

    I have the BMBF app on the Quest but it keeps saying it takes 5-90 seconds to load everytime I go into the app. I waited more than 5 minutes and it still never loaded up. Any help would be much appreciated.

  23. The official place to get SideQuest is
    Which comes with proper install instructions unlike the GitHub and it is easier for users to see which one they need to install.

    1. Dan says:

      lots of info on sideloading but I don’t see even a mention of beat saber.

  24. ouweRammer says:

    Besides the installation instructions, can we get some upgrade instructions as well?
    It all worked out in the end, but I ended up installing BS 6 times before I got it all going as it should.

  25. beater123 says:

    Does this still work with the update that came today. 13.12.2019?
    i cant update beat saber so i guess i need uninstall first. but am i going to lose custom song ability?

  26. Hunter says:

    Hi there! I have followed all of the steps, but after the modded version of beatsaber is downloaded three dots show up and after a few minutes a black screen appears. Before and after downloading songs this issue is still there. I also do have the storage permissions on for beatsaber and I have redownloaded everything from scratch again. Please if anyone finds a fix for this lmk!

  27. mike.haxby says:

    **HELP **

    BMBF Quest’s IP:5000 error

    This was working fine until yesterday evening (2 February 2020) now whenever I put http://IP ADDRESS:50000 I get INET_E_RESOURCE_NOT_FOUND” or “The remote device or resource won’t accept the connection” (they are essentially the same error). I have tried everything google search can suggest, so wondering if anyone else has encountered this issue? thanks

  28. tvc15 says:

    BMBF isn’t downloading my bookmarks for me. It will remove songs if I delete them from my bookmarks, though. Was working fine a few days ago. This is 1.8, the latest BMBF release. Won’t stay logged into on Quest either.

    Any help is appreciated. Considering doing a wipe but I’m afraid of losing all my songs and not being able to get them back.

  29. Sam says:

    Can someone please help?

    I have oculus quest and i try to download custom songs to beat sabor. i have downloaded the sidequest, but i can´ t connect my quest to sidequest…. i have the usb connected to my computer and quest (and it haven´ t gotten asked the: do you trust this computer, on my quest) Can someone help me?

    1. Shivvani Sharma says:

      You have to turn on developer mode in the Oculus app. . You have to become a developer first tho. Here is how to do it follow all directions, create and name your organization and wait a few seconds before you try to turn on developer mode on the Oculus app. Restart your headset before doing anything else. Hope this helps!

  30. Alibas05 says:

    The IP mod manager won’t load, anything i can do?

  31. Jack says:

    Hey BMBF team. I have a problem with the site for oculus quest beat saber modding. I go to the tools bar and copy the exact web address on google chrome but it just times out. I have no idea why and I really want to start modding my beat saber game so please get back to me.

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

      1. JoeyCM says:

        I am willing to pay someone to call me and walk me through this step by step. I’m reading all the info here and it has got me very confused. This is for my son

  33. 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?

  34. 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.

  35. 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.

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

  37. 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

  38. 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

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

  40. 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)

  41. Magnus Ravn says:

    When i pressed “install BMBF” it uninstalled Beat Saber, and reset all of my progress! WTF, you did´ not mention this!

  42. Will Kriski says:

    You need to install the bmbf app and launcher to get it to work. I had originally just installed the launcher but it keeps crashing if you do that.

  43. choice2099 says:

    is it possible to load in more than 200 custom songs? i looked back and 4 months ago it was possible to load about 300.

    im using syncsaber

  44. Janene R says:

    I’ve gone through this tutorial and updated everything, but when I try to download a song on my computer, I get an error that I don’t have BeatOn installed? I’d rather browse songs on my computer.

  45. shawn says:

    my songs show up with the new update but I cant play them it just has the loading screen icon and doesn’t load.

    1. Prem says:

      Same here, any thought how to fix?

      1. Yogin says:

        Same issue. I tried using the tools in BMBF to fix it and it just still spins like it is loading when selecting the custom songs…

        1. PREM says:

          I think the problem is limited to Mapping Extensions mod , we use 1.5.0 and I can’t seem to load version 1.6 through BMBF . I followed this guide and tried downloading a zip but BMBF does not load it via headset or manually via pc (using http://:50000) as Mapping Extensions cannot be installed via Sidequest and we need to install that by downloading the zip file from the GitHub link above and drag it into your BMBF web application’s Upload tab — just like aesthetic mods.( I tried this but it gives me error: Unable to import the file there was an error importing the File: isn’t a known type that BMBF can use!
          File Failed to process! The file could not be processed: File isn’t a known type that BMBF can use!

        2. Zenitsu says:

          Doesn’t work for me either, does it still not work you any of you either?

          1. barry says:

            same for me, just tried and got the same reset assets in the tools menu with no idea where that is located

  46. Richard Garabedian says:

    No fix yet after 360 degreee update? I really dislike the 360 songs and now cant play custom levels

  47. avia says:

    There’s any way do download custom songs from my PC and sync them to my oculus quest? the BMBF is cool, but it more easy to me to use my pc.

  48. Tobias says:

    Nach installierten des BMBF und Songs synchronisiert starten Beat Saber nicht mehr hängt im Lade Bildschirm was kann ich da machen. Mfg

  49. Max says:

    Hi! After I did this, everything worked EXCEPT now all of my notes are way off to the left and really low, so I can’t reach or his them. This includes songs that aren’t modded in, help!

  50. MAX says:

    I was successful in putting custom songs in the game,
    I can’t play.
    What is the cause?

  51. jadeokaybye says:

    Hello Im having trouble downloading songs, a message pops up saying “404 Not Found” on any song that i try to download, is there any way to fix that?

  52. happyandroid says:

    Great Mod app, thank you for sharing this is an addictive game for me.

  53. davidhill says:

    Thank you for sharing so much. I often download the Mod apk for my mobile phone on Blog: Gameschurch, it’s very easy to install, for more details you learn Here.

  54. arithmetic says:

    Any idea on if or when custom mapping will be updated for the timberland update or beyond? feeling real dumb for updating.

  55. Ricardo says:

    My highscores don’t work since i’ve installed this, is that correct?

  56. Paul says:

    Can’t download songs anymore. updated to BS1.9 and BMBF 1.8. Still get this error when I click Quick Download in the headset…
    Download failed

    Any help?

  57. iamhja says:

    end watching one of those video tutorials. There’s a lot more ways to get songs on your Quest than just with SyncSaber. For Syn

  58. loud updates says:

    end watching one of tho

  59. Hatchet8501 says:

    Thank you so much, I got the custom songs, but when I try to record, it doesn’t work! Any help please?

  60. Niall says:


    I’ve already purchased a couple of official song packs for Beat Saber and wanted to confirm whether installing custom tracks is likely to cause problems.

    Like… I can see that Beat Saber regularly verifies my license and validates my downloads (leading to annoying pauses) and I’m just worried that modifying the APK will result in a checksum fail and my tracks ceasing to work.

    Can anyone confirm whether they’ve had any problems like this with BMBF?


  61. Sam says:

    I have oculus quest and i try to download custom songs to beat sabor. i have downloaded the sidequest, but i can´ t connect my quest to sidequest…. i have the usb connected to my computer and quest (and it haven´ t gotten asked the: do you trust this computer, on my quest) Can someone help me?

  62. Robin Steve says:

    You must check out this as well. Thank you so much!

  63. Maxwell says:

    So amazing, thanks for putting out this here

  64. Ok, thanks.
    I proud to be a visitor of your website

  65. Apkeditor says:

    Thanks for your tips

  66. Netflix Apk says:

    thanks for sharing god post. I read everything from beginning to end like i’ve never done before. Thanks for sharing this.

  67. mADDEN nFL says:

    thank you for the post and i hope someday iam gonna buy oculus 🙂

  68. Prabin says:

    Thanks for this wonderful guide. It helped me a lot.

  69. Oh thats good article about songs. I like it so much because i love the songs. and that is also more informative then any other blog to make the questions about songs. thanks admin and make many more like that.

  70. Gbwhatsapp says:

    I have all the songs.

  71. Jobadung says:

    Thanks for the guidelines

  72. Techcrunch says:

    Wow I really learned much

  73. Chidey says:

    This is niceee, thanks for sharing

  74. Mp3 Sam says:

    It actually works great. find a song drag it to your playlist and sync to beat saber. Don’t download the song from your computer do it in the BMBF launcher inside the Quest.

  75. David says:

    Awesome! Thanks to all people making this possible!!!

  76. tiktok names says:

    thanks for sharing an awesome post

  77. Thorn says:

    Welp. Latest update broke everything, Beat Saber won’t even launch, it’s stuck forever on a black screen. I tried uninstalling everything and redoing the setup, same result. The only thing different from other updates is that now the Quest tells me “this isn’t the official Beat Saber, please restore the store version”, which I can just ignore.

    It just decided to not work this time.

    1. Balu says:

      Had the same problem… You have to grant file access to the app. On patches before the question was popping up. Now you have to set it manually in the quest-app-settings.
      But the warning while launching will remain. Hopefully not the first step to block accounts… 🙁

  78. Corsina says:

    Hello all. I am new to the point where I don’t even have a VR yet, but my son and I are considering getting the Oculus 2. Will this all still be workable to use these songs on the 2 or do you not know yet? He has a psvr, but wants a pc vr. TIA!!

  79. Scholartico says:

    complete and accurate. Perfection

  80. 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?

  81. CheapAF says:

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

  82. Jimtolate says:

    Is it safe to sideload custom songs with bmbf? Has your headset anything to suffer because you are modding?

  83. Faiz ali says:

    thanks for sharing god post

  84. cassidyL says:

    Oculus Quest user.

    I’ve got SideQuest and BMBF running but this plain just doesn’t work. SyncSaber is trash. Nothing gets added to the Playlists no matter what you click on. This all seems like a really poorly thought out way of adding songs. Nothing downloads from BMBF, basically. Maybe BMBF is broken? This is a really frustrating and poor user experience.

    There needs to be a guide on how to add songs manually via SideQuest because I can download the song zip files manually just fine on my computer, but I don’t know how to get that content from my computer to the Quest in a way that BMBF would understand.

    1. Will Kriski says:

      It actually works great. find a song drag it to your playlist and sync to beat saber. Don’t download the song from your computer do it in the BMBF launcher inside the Quest.

  85. m says:

    I’m sorry.
    But why is this so fucking complicated.
    Can you make a STEP BY STEP process for complete idiots who have no fucking clue what the fuck you are doing?
    LIKE. If I download a FILE. I -need- to fucking know, where the fuck I need to put it and how the fuck do I get it to start.


  86. cassidyL says:

    bullshit. does not work.

    1. elliotttate says:

      @cassidyl I recommend watching one of those video tutorials. There’s a lot more ways to get songs on your Quest than just with SyncSaber. For SyncSaber to work, you need to enter in your username in BMBF and click the “sync button” after bookmarking songs. You can also just press the download button from BMBF on your Quest and the songs download. Thirdly, you can drag and drop them into BMBF through the web interface as explained in the videos.

      1. cassidyL says:

        Okay weird.

        Well… maybe it was the recent website update or something, but I was able to get it to work after spamming the ‘download’ button enough times from the browser.

        A frustrating experience, but I’m just glad it’s working now.

        ps: Lose Yourself to Dance is really really good.

Leave a Reply

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