From 6beb67513916d8a005ee30a9aed67332dc05ca4f Mon Sep 17 00:00:00 2001 From: Shidorien Date: Sat, 4 Jan 2025 16:10:23 +0100 Subject: [PATCH] Add Oculus sideloading activation guide and restructure documentation --- ...n.md => Install-or-import-a-version bk.md} | 0 .../Install-or-import-a-version copy.md | 110 ++++++++++++++++++ docs/wiki/Home.md | 1 + .../Activate-Oculus-sideloading.md | 0 4 files changed, 111 insertions(+) rename docs/wiki/Guides/Installation-and-updates/Install-or-import-a-version/{Install-or-import-a-version.md => Install-or-import-a-version bk.md} (100%) create mode 100644 docs/wiki/Guides/Installation-and-updates/Install-or-import-a-version/Install-or-import-a-version copy.md rename docs/wiki/{ => Troubleshoots/Debugging-tips/Activate-Oculus-sideloading}/Activate-Oculus-sideloading.md (100%) diff --git a/docs/wiki/Guides/Installation-and-updates/Install-or-import-a-version/Install-or-import-a-version.md b/docs/wiki/Guides/Installation-and-updates/Install-or-import-a-version/Install-or-import-a-version bk.md similarity index 100% rename from docs/wiki/Guides/Installation-and-updates/Install-or-import-a-version/Install-or-import-a-version.md rename to docs/wiki/Guides/Installation-and-updates/Install-or-import-a-version/Install-or-import-a-version bk.md diff --git a/docs/wiki/Guides/Installation-and-updates/Install-or-import-a-version/Install-or-import-a-version copy.md b/docs/wiki/Guides/Installation-and-updates/Install-or-import-a-version/Install-or-import-a-version copy.md new file mode 100644 index 00000000..8af0920b --- /dev/null +++ b/docs/wiki/Guides/Installation-and-updates/Install-or-import-a-version/Install-or-import-a-version copy.md @@ -0,0 +1,110 @@ + +[!toc] + +## Windows Installation + +### Install a Version with Steam + +1. Download and install [BSManager](https://www.bsmanager.io) from [GitHub](https://github.com/Zagrios/bs-manager/releases/latest), [Nexus Mods](https://www.nexusmods.com/beatsaber/mods/18?tab=images), or the [official website](https://www.bsmanager.io). +2. Open the **`Add Versions`** interface and select the version you wish to download. +3. Choose **`Steam`** as your platform. +4. Enter your Steam credentials (ID and password) or scan the QR code using the Steam app on your phone. +5. Once logged into Steam, the download will start automatically. Please wait for it to complete. +6. When the download is finished, select the downloaded version and click the **`Launch`** button to verify that the game launches correctly. + +
+ SteamLogin.png +
+ +### Install a Version with Oculus Store (PCVR) + +> **Important** +> - Ensure that Beat Saber is in your **Oculus PCVR** library to enable downgrading. +> - You must run Beat Saber at least once on your computer before attempting to launch retrograde Oculus versions from [BSManager](https://www.bsmanager.io). + +1. Download and install [BSManager](https://www.bsmanager.io) from [GitHub](https://github.com/Zagrios/bs-manager/releases/latest), [Nexus Mods](https://www.nexusmods.com/beatsaber/mods/18?tab=images), or the [official website](https://www.bsmanager.io). +2. Open the **`Add Versions`** interface and select the version you wish to download. +3. Choose **`Oculus Store`** as your platform. +4. Follow [this guide](Get-your-Oculus-token) to obtain your Oculus token. +5. Once logged into Oculus, the download will start automatically. Please wait for it to complete. +6. When the download is finished, select the downloaded version and click the **`Launch`** button to verify that the game launches correctly. + +
+ OculusLogin.png +
+ +## Linux Installation + +### Using Ubuntu, Debian (deb) + +#### PPA Repository + +Refer to [bs-manager-deb](https://github.com/silentrald/bs-manager-deb). + +Add the BSManager PPA repository to your system with the following commands: + +```bash +curl -fsSL https://raw.githubusercontent.com/silentrald/bs-manager-deb/refs/heads/main/KEY.gpg | sudo gpg --dearmor -o /usr/share/keyrings/bs-manager.gpg +echo "deb [signed-by=/usr/share/keyrings/bs-manager.gpg] https://raw.githubusercontent.com/silentrald/bs-manager-deb/refs/heads/main ./" | sudo tee /etc/apt/sources.list.d/bs-manager.list +sudo apt update +``` + +Install the `bs-manager` package using `apt`: + +```bash +sudo apt install bs-manager +``` + +#### dpkg Install + +Download the `.deb` file from the releases page and run the following command: + +```bash +dpkg -i ./bsmanager.deb +``` + +> **Note:** When installed using dpkg, BSManager will not automatically update to the latest version. You need to either: +> - Download the latest `.deb` file from the releases page; or +> - Install through the PPA repository to enable automatic updates with `sudo apt update && sudo apt upgrade`. + +### Using 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). + +### Using Flatpak (Universal) + +This method works on any Linux distribution. Ensure `flatpak` is installed on your system. If not, visit [Flatpak](https://flatpak.org/setup/) for a setup guide tailored to your distro. + +After installing `flatpak`, download the `.flatpak` file from the releases page and run the following command: + +```bash +flatpak install --user ./bsmanager.flatpak +``` + +If you encounter errors like missing packages, run the following commands to add the correct repositories: + +```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 +``` + +## Shared: How to Import a Version + +> **Important** +> - You will need to download a version of Beat Saber yourself before you can import it. +> - The [BSManager](https://www.bsmanager.io) team provides tutorials like [this one](https://steamcommunity.com/sharedfiles/filedetails/?id=1805934840) to help you download official versions of Beat Saber. However, no team member will offer assistance for cracked versions. + +1. Launch [BSManager](https://www.bsmanager.io). +2. Click the gear icon in the top-right corner of the interface. +3. Select the **`Import a Version`** option. +4. Choose the file containing the version to be imported. +5. Wait a few moments. The imported version should appear alongside the others in the version list. + +
+
diff --git a/docs/wiki/Home.md b/docs/wiki/Home.md index 634ea955..6c1e9c09 100644 --- a/docs/wiki/Home.md +++ b/docs/wiki/Home.md @@ -35,6 +35,7 @@ Information on how to contribute to the development and improvement of BSManager - [Help us update the wiki](help-us-update-the-wiki) - [Contribute to the project](https://github.com/Zagrios/bs-manager/blob/master/CONTRIBUTING.md) +- [Activate Oculus Sideloading](Activate-Oculus-sideloading) ## 🐞 Troubleshooting diff --git a/docs/wiki/Activate-Oculus-sideloading.md b/docs/wiki/Troubleshoots/Debugging-tips/Activate-Oculus-sideloading/Activate-Oculus-sideloading.md similarity index 100% rename from docs/wiki/Activate-Oculus-sideloading.md rename to docs/wiki/Troubleshoots/Debugging-tips/Activate-Oculus-sideloading/Activate-Oculus-sideloading.md