BeatDownloader 1.1.3

This utility allows you to download all of the ranked custom levels that you don't currently have for Beat Saber.

Installation

npm i beat-downloader

Prerequisites

ModAssistant

If you haven't used this before, make sure to run ModAssistant.exe and click the "Install or Update" button in the bottom right.

On the Options page, make sure the "BeatSaver" option is checked on the "Enable OneClick Installs" dropdown. This actually didn't work for me at first and I needed to uncheck "BeatSaver" and check it again before they were working as expected. I would recommend doing this just to be on the safe side.

Also on the Options page, change the "Show OneClick Installer Window" from the default "Yes" to "Close" or "No". Otherwise you will be left at the end with many open windows of the OneClick Installer.

Current release: https://github.com/Assistant/ModAssistant/releases/download/v1.1.27/ModAssistant.exe

Usage

• Want to use the default Beat Saber install directory (C:/Program Files (x86)/Steam/steamapps/common/Beat Saber/Beat Saber_Data/CustomLevels)?

  • npx beat-downloader

• Prefer to provide your own? (Please include /Beat Saber_Data/CustomLevels)

  • npx beat-downloader "C:/Beat Saber/Beat Saber_Data/CustomLevels"
  • After providing the directory, you can call just npx beat-downloader. This will be saved until you pass a new directory or if there was an error finding the directory.

Credits

Beat Saver: https://beatsaver.com/
Beat Savior: https://beat-savior.herokuapp.com/
ModAssistant: https://github.com/Assistant/ModAssistant

Everything below is now deprecated and no longer needed

BeatDownloader.bat

This can be used as-is if you have used ModAssistant before. BeatDownloader will use the same install directory as set in ModAssistant.

Xidel

This is used for JSON parsing and only needs to be copied into the same folder that BeatDownloader.bat will run in. There is no installation needed for it.

Current release: https://github.com/benibela/xidel/releases/download/Xidel_0.9.8/xidel-0.9.8.win32.zip

Downloading

With all that out of the way, just double-click BeatDownloader.bat and the command prompt window will display showing the current progress! You can close the command prompt window and continue later on as well.

Note: As of writing there are currently 689 ranked custom levels, so this will take a while to complete. Closing the command prompt window will stop the process from running, but this can be restarted at a later time skipping the custom levels that have already been downloaded.

Credits

Xidel: https://github.com/benibela/xidel