mirror of
https://github.com/Zagrios/bs-manager.git
synced 2026-07-03 14:08:25 +02:00
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
64 lines
2.4 KiB
Markdown
64 lines
2.4 KiB
Markdown
# Linux Guide
|
|
|
|
## Installation
|
|
|
|
Go to [Releases](https://github.com/Zagrios/bs-manager/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:
|
|
```bash
|
|
dpkg -i ./bsmanager.deb
|
|
```
|
|
|
|
### Arch (AUR)
|
|
|
|
Refer to [bs-manager-git](https://aur.archlinux.org/packages/bs-manager-git).
|
|
|
|
To install AUR packages, you need to install [yay](https://github.com/Jguer/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](https://flatpak.org/setup/) 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:
|
|
|
|
```bash
|
|
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.
|
|
|
|
```bash
|
|
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](https://github.com/ValveSoftware/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"
|
|
|
|
<pre>
|
|
Unhandled Exception UnhandledRejection Error: EACCES: permission denied, open '/opt/BSManager/resources/assets/jsons/bs-versions.json'
|
|
</pre>
|
|
|
|
To fix this issue, the current user must have write permissions to the "bs-versions.json". To correct the permissions do command below:
|
|
|
|
```bash
|
|
chmod +002 /opt/BSManager/resources/assets/jsons/bs-versions.json
|
|
|
|
# or
|
|
|
|
chown $(whoami) /opt/BSManager/resources/assets/jsons/bs-versions.json
|
|
```
|
|
|