Beat Saber Song and Mod Installer is a tool that allows you to easily install Beat Saber songs and mods in only a few clicks.
Note: If you are only installing songs from BeatSaver or BeastSaber, try turning on OneClick™ install inside of ModAssistant instead as it may be easier. You can also install mods inside of ModAssistant, but not all mods are available so dont turn this tool down immediately.
Note: This tool only works on Windows.
1. Click the Download button above, right click on the file, and click Extract All...
2. Open the extracted folder and the folder inside of that and open !ChangeToBeatSaberFolder.txt. Replace the text inside of that file with the directory of your Beat_Saber folder. If you are using the Steam version of Beat Saber installed in the default location, you can skip this step. You can find your directory by opening the Beat_Saber folder and copying the text in the address bar.
Warning: In the text file, make sure the directory does not include extra spaces at the beginning or end of it
(it is okay for the folder names to have spaces though). Also make sure it does not end in a \
3. Now open !Install.bat and your done! Make sure no errors appear in the cmd window before you click Ok. If an error stays there, refer to the issues section before continuing.
Warning: If the file path to the folder containing these .bat files is ever changed (like if the folder is moved
or renamed), you must run !Install.bat again or an error will appear when using the tool.
Note: When opening the .bat files in this repo, or when using the installer, you may see a message saying
"Windows protected your PC". This will happen to most programs you download from Github, even if they are
completly safe. You can read the source code above to check for yourself. To make this message go away,
click "More info" and then "Run anyway"
To use the installer, right click on the zip file of a song or mod, click Send to, and then choose Beat Saber Song Folder or Beat Saber Mod Folder respectively.
Note: If you are on Windows 11, you must click "Show more options" before you can see the "Send to" button.
Once again, if an error stays in the cmd window refer to the issues section before continuing.
Now, to check if the install worked, open Beat Saber and the song or mod should appear.
To uninstall the tool, simply open !Uninstall.bat and make sure no errors appear again. Once you do this, the Beat Saber Song Folder and Beat Saber Mod Folder will no longer appear in the Send to menu. The songs and mods you installed using this tool will not be uninstalled.
Tip: If you ever forget where the these .bat files are, type
%USERPROFILE%\AinyakuBeatSaberSongandModInstallerFileLocation.txt into the address bar in file explorer
(the same place you copied the Beat_Saber directory) and a window with the directory to the .bat
files will appear.
To update the installer, uninstall the old tool and reinstall the updated version and you should be good to go. You can then delete the files for the old version as they are no longer needed. You can check if you have the latest version by comparing what is in the Version.txt file on your computer with the latest release shown here.
If you would like to get notified when a new release is out, click Watch in the top right of this page, click Custom, and check Releases.
If there is an error message staying in the cmd window when opening the .bat files or when using the installer, do not close the window or click Ok yet.
Note:
If you see a flash or loading bar in the window while it is running, that is normal.
A window saying that the song or mod was installed or that the install/uninstall of the tool was successful will
always appear even if it failed. If it actualy worked there should be nothing in the cmd window when it is finished.
First, copy everything in the cmd window then click Ok. Try opening !Install.bat again to see if that fixes it. If that does not fix it, create a new issue here and make sure to include all of the text that you copied from the cmd window. I will make sure to attempt to help you as soon as possible (even though i dont know what im doing either).