silentrald
82a19c0c8b
- updated flatpak installation - moved deb and AUR above flatpak so users with appropriate distros will install those first - idiot-proofing on how to install flatpak on different distros
2.4 KiB
Linux Guide
Installation
Go to Releases page and go to the latest release. Download the necessary build installer for your distro (see below).
Ubuntu, Debian (deb)
Download the .deb file in the releases and run the following command:
dpkg -i ./bsmanager.deb
Arch (AUR)
Refer to bs-manager-git.
To install AUR packages, you need to install yay.
Universal (flatpak)
This should work on any linux distribution. You are only required to have flatpak installed in your system. If it is not installed, then go to flatpak to look for a guide on how to install it on your distro.
After installing, download the .flatpak file in the releases and run the following command:
flatpak install --user ./bsmanager.flatpak
If you are getting errors like packages not existing, run the command below so that it finds the correct packages.
sudo flatpak remote-add --if-not-exists --system flathub https://flathub.org/repo/flathub.flatpakrepo
# or
flatpak remote-add --if-not-exists --user flathub https://flathub.org/repo/flathub.flatpakrepo
Proton Setup
Proton is needed to run the Beat Saber executable under Linux. You need to download this from either from Steam or building it from their GitHub repo.
Once Proton is installed, when you open your BSManager application for the first time, it will ask you to link the Proton Folder. The Proton Folder also verifies if the proton and files/bin/wine64 binaries exists. Once set, you should be able to launch the Beat Saber (using proton) and install mods (using files/bin/wine64). You can still change the Proton Folder in the settings page if any new version of Steam Proton is downloaded.
Troubleshooting
Permission denied on "bs-version.json"
Unhandled Exception UnhandledRejection Error: EACCES: permission denied, open '/opt/BSManager/resources/assets/jsons/bs-versions.json'
To fix this issue, the current user must have write permissions to the "bs-versions.json". To correct the permissions do command below:
chmod +002 /opt/BSManager/resources/assets/jsons/bs-versions.json
# or
chown $(whoami) /opt/BSManager/resources/assets/jsons/bs-versions.json