todo

* [fix/634] fixed issue on hovering on last song element

* restore itemHeight and add a bottom padding

---------

Co-authored-by: Zagrios <40181755+Zagrios@users.noreply.github.com>

.editorconfig

@@ -2,7 +2,7 @@ root = true
 
 [*]
 indent_style = space
-indent_size = 2
+indent_size = 4
 end_of_line = lf
 charset = utf-8
 trim_trailing_whitespace = true

.erb/configs/webpack.config.base.ts

@@ -6,8 +6,20 @@ import webpack from "webpack";
 import webpackPaths from "./webpack.paths";
 import { dependencies as externals } from "../../release/app/package.json";
 
+function createExternals(): string[] {
+    const webpackExternals: string[] = [...Object.keys(externals || {})];
+    const excludedExternals: string[] = [];
+
+    if (process.platform === "linux") {
+        // Linux only uses regedit-rs types
+        excludedExternals.push("regedit-rs");
+    }
+
+    return webpackExternals.filter(external => !excludedExternals.includes(external));
+}
+
 const configuration: webpack.Configuration = {
-    externals: [...Object.keys(externals || {})],
+    externals: createExternals(),
 
     stats: "errors-only",
 

.erb/configs/webpack.config.main.dev.ts

@@ -0,0 +1,64 @@
+/**
+ * Webpack config for development electron main process
+ */
+
+import path from 'path';
+import webpack from 'webpack';
+import { BundleAnalyzerPlugin } from 'webpack-bundle-analyzer';
+import { merge } from 'webpack-merge';
+import checkNodeEnv from '../scripts/check-node-env';
+import baseConfig from './webpack.config.base';
+import webpackPaths from './webpack.paths';
+
+// When an ESLint server is running, we can't set the NODE_ENV so we'll check if it's
+// at the dev webpack config is not accidentally run in a production environment
+if (process.env.NODE_ENV === 'production') {
+  checkNodeEnv('development');
+}
+
+const configuration: webpack.Configuration = {
+
+  devtool: 'inline-source-map',
+
+  mode: 'development',
+
+  target: 'electron-main',
+
+  entry: {
+    main: path.join(webpackPaths.srcMainPath, 'main.ts'),
+    preload: path.join(webpackPaths.srcMainPath, 'preload.ts'),
+  },
+
+  output: {
+    path: webpackPaths.dllPath,
+    filename: '[name].bundle.dev.js',
+    library: {
+      type: 'umd',
+    },
+  },
+
+  plugins: [
+    // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+    // @ts-ignore
+    new BundleAnalyzerPlugin({
+      analyzerMode: process.env.ANALYZE === 'true' ? 'server' : 'disabled',
+      analyzerPort: 8888,
+    }),
+
+    new webpack.DefinePlugin({
+      'process.type': '"browser"',
+    }),
+  ],
+
+  /**
+   * Disables webpack processing of __dirname and __filename.
+   * If you run the bundle in node.js it falls back to these values of node.js.
+   * https://github.com/webpack/webpack/issues/2010
+   */
+  node: {
+    __dirname: false,
+    __filename: false,
+  },
+};
+
+export default merge(baseConfig, configuration);

.erb/configs/webpack.config.main.prod.ts

@@ -40,6 +40,7 @@ const configuration: webpack.Configuration = {
     },
 
     optimization: {
+        minimize: true,
         minimizer: [
             new TerserPlugin({
                 parallel: true,

.erb/configs/webpack.config.renderer.dev.ts

@@ -1,3 +1,4 @@
+/* eslint-disable import/no-import-module-exports */
 import "webpack-dev-server";
 import path from "path";
 import fs from "fs";

.erb/configs/webpack.paths.ts

@@ -2,6 +2,9 @@ const path = require("path");
 
 const rootPath = path.join(__dirname, "../..");
 
+const erbPath = path.join(__dirname, '..');
+const erbNodeModulesPath = path.join(erbPath, 'node_modules');
+
 const dllPath = path.join(__dirname, "../dll");
 
 const srcPath = path.join(rootPath, "src");
@@ -22,6 +25,7 @@ const buildPath = path.join(releasePath, "build");
 
 export default {
     rootPath,
+    erbNodeModulesPath,
     dllPath,
     srcPath,
     srcMainPath,

.erb/scripts/build-rust-scripts.js

@@ -0,0 +1,33 @@
+import path from 'path';
+import { copyFileSync, existsSync, readdirSync } from 'fs-extra';
+import { execSync } from 'child_process';
+
+const eternalsFolder = path.join(__dirname, '..', '..', 'externals');
+
+// Get rust project folders from externals
+const rustProjects = readdirSync(eternalsFolder).filter(folder => existsSync(path.join(eternalsFolder, folder, 'Cargo.toml')));
+
+// Build each rust project in release mode
+rustProjects.forEach(project => {
+    console.log(`Building ${project}`);
+    execSync(`cargo build --release`, {
+        cwd: path.join(eternalsFolder, project),
+        stdio: 'inherit',
+    });
+});
+
+// Copy the built files exe to the assests/scripts folder
+rustProjects.forEach(project => {
+    // read the project name from Cargo.toml using toml parser
+    const projectMetadata = execSync('cargo metadata --no-deps --format-version 1', {
+        cwd: path.join(eternalsFolder, project),
+        stdio: 'pipe',
+    });
+    const projectMetadataJson = JSON.parse(projectMetadata);
+    const projectName = projectMetadataJson.packages[0].name;
+
+    const source = path.join(eternalsFolder, project, 'target', 'release', `${projectName}.exe`);
+    const destination = path.join(__dirname, '..', '..', 'assets', 'scripts', `${projectName}.exe`);
+    console.log(`Copying ${source} to ${destination}`);
+    copyFileSync(source, destination);
+});

.erb/scripts/clean.js

@@ -1,17 +1,13 @@
-import rimraf from "rimraf";
-import process from "process";
-import webpackPaths from "../configs/webpack.paths";
+import { rimrafSync } from 'rimraf';
+import fs from 'fs';
+import webpackPaths from '../configs/webpack.paths';
 
-const args = process.argv.slice(2);
-const commandMap = {
-    dist: webpackPaths.distPath,
-    release: webpackPaths.releasePath,
-    dll: webpackPaths.dllPath,
-};
+const foldersToRemove = [
+  webpackPaths.distPath,
+  webpackPaths.buildPath,
+  webpackPaths.dllPath,
+];
 
-args.forEach(x => {
-    const pathToRemove = commandMap[x];
-    if (pathToRemove !== undefined) {
-        rimraf.sync(pathToRemove);
-    }
+foldersToRemove.forEach((folder) => {
+  if (fs.existsSync(folder)) rimrafSync(folder);
 });

.erb/scripts/delete-source-maps.js

@@ -1,8 +1,15 @@
-import path from "path";
-import rimraf from "rimraf";
-import webpackPaths from "../configs/webpack.paths";
+import fs from 'fs';
+import path from 'path';
+import { rimrafSync } from 'rimraf';
+import webpackPaths from '../configs/webpack.paths';
 
 export default function deleteSourceMaps() {
-    rimraf.sync(path.join(webpackPaths.distMainPath, "*.js.map"));
-    rimraf.sync(path.join(webpackPaths.distRendererPath, "*.js.map"));
+  if (fs.existsSync(webpackPaths.distMainPath))
+    rimrafSync(path.join(webpackPaths.distMainPath, '*.js.map'), {
+      glob: true,
+    });
+  if (fs.existsSync(webpackPaths.distRendererPath))
+    rimrafSync(path.join(webpackPaths.distRendererPath, '*.js.map'), {
+      glob: true,
+    });
 }

.erb/scripts/link-modules.ts

@@ -1,9 +1,12 @@
-import fs from "fs";
-import webpackPaths from "../configs/webpack.paths";
+import fs from 'fs';
+import webpackPaths from '../configs/webpack.paths';
 
-const { srcNodeModulesPath } = webpackPaths;
-const { appNodeModulesPath } = webpackPaths;
+const { srcNodeModulesPath, appNodeModulesPath, erbNodeModulesPath } = webpackPaths;
 
 if (!fs.existsSync(srcNodeModulesPath) && fs.existsSync(appNodeModulesPath)) {
-    fs.symlinkSync(appNodeModulesPath, srcNodeModulesPath, "junction");
+  fs.symlinkSync(appNodeModulesPath, srcNodeModulesPath, 'junction');
+}
+
+if (!fs.existsSync(erbNodeModulesPath) && fs.existsSync(appNodeModulesPath)) {
+  fs.symlinkSync(appNodeModulesPath, erbNodeModulesPath, 'junction');
 }

.erb/scripts/notarize.js

@@ -1,28 +1,32 @@
-const { notarize } = require("electron-notarize");
-const { build } = require("../../package.json");
+const { notarize } = require('@electron/notarize');
+const { build } = require('../../package.json');
 
 exports.default = async function notarizeMacos(context) {
-    const { electronPlatformName, appOutDir } = context;
-    if (electronPlatformName !== "darwin") {
-        return;
-    }
+  const { electronPlatformName, appOutDir } = context;
+  if (electronPlatformName !== 'darwin') {
+    return;
+  }
 
-    if (process.env.CI !== "true") {
-        console.warn("Skipping notarizing step. Packaging is not running in CI");
-        return;
-    }
+  if (process.env.CI !== 'true') {
+    console.warn('Skipping notarizing step. Packaging is not running in CI');
+    return;
+  }
 
-    if (!("APPLE_ID" in process.env && "APPLE_ID_PASS" in process.env)) {
-        console.warn("Skipping notarizing step. APPLE_ID and APPLE_ID_PASS env variables must be set");
-        return;
-    }
+  if (
+    !('APPLE_ID' in process.env && 'APPLE_APP_SPECIFIC_PASSWORD' in process.env)
+  ) {
+    console.warn(
+      'Skipping notarizing step. APPLE_ID and APPLE_APP_SPECIFIC_PASSWORD env variables must be set',
+    );
+    return;
+  }
 
-    const appName = context.packager.appInfo.productFilename;
+  const appName = context.packager.appInfo.productFilename;
 
-    await notarize({
-        appBundleId: build.appId,
-        appPath: `${appOutDir}/${appName}.app`,
-        appleId: process.env.APPLE_ID,
-        appleIdPassword: process.env.APPLE_ID_PASS,
-    });
+  await notarize({
+    appBundleId: build.appId,
+    appPath: `${appOutDir}/${appName}.app`,
+    appleId: process.env.APPLE_ID,
+    appleIdPassword: process.env.APPLE_APP_SPECIFIC_PASSWORD,
+  });
 };

.eslintrc.js

@@ -46,15 +46,33 @@ module.exports = {
         "react/prop-types": "off",
         "import/no-cycle": "off",
         "prefer-promise-reject-errors": "off",
-        "react/jsx-no-target-blank": "off"
+        "react/jsx-no-target-blank": "off",
+        "import/extensions": "off",
+        "lines-between-class-members": "off",
+        "no-throw-literal": "warn",
+        "no-use-before-define": "off",
+        "no-useless-constructor": "off",
+        "no-unused-vars": "off",
+        "@typescript-eslint/no-unused-vars": "error",
+        'react/jsx-filename-extension': [2, { 'extensions': ['.js', '.jsx', '.ts', '.tsx'] }],
+        "no-shadow": "off",
+        "react/function-component-definition": "off",
+        "jsx-a11y/control-has-associated-label": "off",
+        "react/button-has-type": "off",
+        "max-classes-per-file": "off",
+        "jest/no-standalone-expect": "off",
+        "no-bitwise": "off",
     },
     parserOptions: {
         ecmaVersion: 2020,
         sourceType: "module",
-        project: "./tsconfig.json",
         tsconfigRootDir: __dirname,
         createDefaultProgram: true,
     },
+    globals: {
+        JSX: true,
+        NodeJS: true
+    },
     settings: {
         "import/resolver": {
             // See https://github.com/benmosher/eslint-plugin-import/issues/1396#issuecomment-575727774 for line below
@@ -68,4 +86,5 @@ module.exports = {
             "@typescript-eslint/parser": [".ts", ".tsx"],
         },
     },
+    "plugins": ["@typescript-eslint"]
 };

.gitattributes

@@ -15,3 +15,5 @@
 *.ttf   binary
 *.woff  binary
 *.woff2 binary
+assets/scripts/* binary
+*.zip binary

.github/ISSUE_TEMPLATE/-bug--bug-report.md

@@ -1,35 +0,0 @@
----
-name: "[BUG] Bug report"
-about: Create a report to help us improve
-title: "[BUG] : "
-labels: bug
-assignees: Zagrios
----
-
-## Bug Description
-<!-- A clear and concise description of what the bug is. -->
-
-## Reproduction Steps
-<!-- Steps to reproduce the behavior:
-
-1. Go to '...'
-2. Click on '....'
-3. Scroll down to '....'
-4. See error
--->
-
-## Expected Behavior
-<!-- A clear and concise description of what you expected to happen. -->
-
-## Screenshots
-<!-- If applicable, add screenshots to help explain your problem. -->
-
-## System Specs
-<!-- **Desktop (please complete the following information):**
-
--   OS: [e.g. iOS]
--   Version [e.g. 22]
--->
-
-## Additional context
-<!-- Add any other context about the problem here. -->

.github/ISSUE_TEMPLATE/-feat---feature-request.md

@@ -1,22 +0,0 @@
----
-name: "[FEAT.] Feature request"
-about: Suggest an idea for this project
-title: "[FEAT.] : "
-labels: enhancement
-assignees: Zagrios
----
-
-## Problem
-<!-- **Is your feature request related to a problem? Please describe.** -->
-<!-- A clear and concise description of what the problem is. Ex. I'm always frustrated when [...] -->
-
-## Solution
-<!-- **Describe the solution you'd like** -->
-<!-- A clear and concise description of what you want to happen. -->
-
-## Alternative solutions (if any)
-<!-- **Describe alternatives you've considered** -->
-<!-- A clear and concise description of any alternative solutions or features you've considered. -->
-
-## Additional context
-<!-- Add any other context or screenshots about the feature request here. -->

.github/ISSUE_TEMPLATE/1-bug-report.yaml

@@ -0,0 +1,56 @@
+
+
+name: "[BUG] Bug report"
+description: Create a report to help us improve
+title: "[BUG] : "
+labels: bug
+assignees: Zagrios
+body:
+    - type: markdown
+      attributes:
+        value: |
+          ## Thanks for taking the time to fill out this bug report! 😊
+    - type: textarea
+      id: description
+      attributes:
+        label: Issue encountered
+        description: Tell us what issue you've encountered.
+      validations:
+        required: true
+    - type: textarea
+      id: expected
+      attributes:
+        label: Expected Behavior
+        description: Tell us what should expected to happen.
+    - type: textarea
+      id: replication
+      attributes:
+        label: Steps to Reproduce
+        description: Provide a link to a live example, or an unambiguous set of steps to reproduce this bug.
+            Include code to reproduce, if relevant.
+        placeholder: |
+            1. Go to '...'
+            2. Click on '....'
+            3. Scroll down to '....'
+            4. See error
+    - type: dropdown
+      id: os
+      attributes:
+        label: Operating System
+        options:
+          - Windows 10
+          - Windows 11
+          - Linux
+    - type: input
+      id: version
+      attributes:
+        label: Version
+        description: What version of BSManager are you running?
+        placeholder: eg. 1.4.8 or 1.5.0-alpha-4
+    - type: textarea
+      id: additional-context
+      attributes:
+        label: Additional Context
+        description: Any other context that you may share about the issue such as logs.
+            To get the logs, follow these steps `Open BSManager -> Go to settings -> Scroll down -> Open Logs`.
+

.github/ISSUE_TEMPLATE/2-feature-request.yaml

@@ -0,0 +1,45 @@
+
+name: "[FEAT.] Feature request"
+description: Suggest an idea for this project
+title: "[FEAT.] : "
+labels: enhancement
+assignees: Zagrios
+body:
+    - type: markdown
+      attributes:
+        value: |
+          ## Thanks for taking the time to fill out this feature request! 😊
+    - type: textarea
+      id: problem
+      attributes:
+        label: Problem
+        description: Is your feature request related to a problem? Please describe.
+        placeholder: Ex. I'm always frustrated when [...]
+      validations:
+        required: true
+    - type: textarea
+      id: solution
+      attributes:
+        label: Solution
+        description: Describe the solution you'd like.
+      validations:
+        required: true
+    - type: textarea
+      id: alternative-solution
+      attributes:
+        label: Alternative Solution
+        description: Describe alternatives you've considered.
+    - type: dropdown
+      id: os
+      attributes:
+        label: Operating System
+        description: If the feature is only applicable to a specific OS. Leave it to `None` if it's applicable to all OS'es.
+        options:
+          - Windows
+          - Linux
+    - type: textarea
+      id: additional-context
+      attributes:
+        label: Additional Context
+        description: Add any other context or screenshots about the feature request here.
+

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+    - name: Discord Support
+      url: https://discord.gg/uSqbHVpKdV
+      about: You can join our Discord server for a quick and interactive support.

.github/workflows/build.yaml

@@ -0,0 +1,58 @@
+# This workflow will...
+
+name: Build
+
+on:
+    push:
+        branches: ["master"]
+    workflow_dispatch:
+
+jobs:
+    release:
+        runs-on: ${{ matrix.os }}
+
+        strategy:
+            matrix:
+                os: [windows-latest, ubuntu-latest]
+
+        steps:
+            - name: Check out Git repository
+              uses: actions/checkout@v4
+
+            - name: Use Node.js
+              uses: actions/setup-node@v4
+              with:
+                  node-version: 22.11.0
+                  cache: "npm"
+
+            # Update package lists
+            - name: update apt-get
+              if: matrix.os == 'ubuntu-latest'
+              run: sudo apt-get update
+
+            # Install and setup rpm/Flatpak for Ubuntu
+            - name: Install rpm/flatpak packages (Ubuntu only)
+              if: matrix.os == 'ubuntu-latest'
+              run: sudo apt-get install -y flatpak flatpak-builder rpm libarchive-tools
+
+            - run: npm ci
+            - run: npm run package
+
+            - name: Setup flatpak repo (Ubuntu only)
+              if: matrix.os == 'ubuntu-latest'
+              run: |
+                flatpak remote-add --if-not-exists --user \
+                  flathub https://flathub.org/repo/flathub.flatpakrepo
+
+            # Build Flatpak package
+            - name: Build Flatpak (Ubuntu only)
+              if: matrix.os == 'ubuntu-latest'
+              run: |
+                  env DEBUG="@malept/flatpak-bundler" \
+                  npx electron-builder --config electron-builder.config.js --publish never --linux flatpak
+
+            - name: Upload artifact
+              uses: actions/upload-artifact@v4
+              with:
+                  name: release-${{ matrix.os }}
+                  path: release

.github/workflows/docs.yaml

@@ -0,0 +1,21 @@
+name: Publish wiki
+on:
+  push:
+    branches: [master]
+    paths:
+      - docs/wiki/**
+      - .github/workflows/docs.yml
+concurrency:
+  group: publish-wiki
+  cancel-in-progress: true
+permissions:
+  contents: write
+jobs:
+  publish-wiki:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - uses: Andrew-Chen-Wang/github-wiki-action@v4
+        with:
+          path: docs/wiki/
+          strategy: init

.github/workflows/labeler.yaml

@@ -0,0 +1,26 @@
+name: Labeler
+
+on:
+  issues:
+    types: [opened, edited]
+
+jobs:
+  label-linux:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+
+    - name: Search Linux Term
+      uses: actions-ecosystem/action-regex-match@v2
+      id: regex-match
+      with:
+        text: ${{ github.event.issue.body }}
+        regex: '\# Operating System(\s*)Linux'
+        flags: m
+
+    - name: Add Linux label
+      uses: actions-ecosystem/action-add-labels@v1
+      if: ${{ steps.regex-match.outputs.match != '' }}
+      with:
+        github_token: ${{ secrets.GH_TOKEN }}
+        labels: linux

.github/workflows/lint.yaml

@@ -14,11 +14,11 @@ jobs:
         runs-on: ubuntu-latest
 
         steps:
-            - uses: actions/checkout@v3
+            - uses: actions/checkout@v4
             - name: Use Node.js
-              uses: actions/setup-node@v3
+              uses: actions/setup-node@v4
               with:
-                  node-version: 18.x
+                  node-version: 22.11.0
                   cache: "npm"
             - run: npm ci
             - run: npm run lint

.github/workflows/node.js.yaml

@@ -13,19 +13,20 @@ jobs:
     build:
         strategy:
             matrix:
-                os: [ubuntu-latest, windows-latest, macos-latest]
+                os: [ubuntu-latest, windows-latest]
 
         runs-on: ${{ matrix.os }}
 
         steps:
-            - uses: actions/checkout@v3
+            - uses: actions/checkout@v4
             - name: Use Node.js
-              uses: actions/setup-node@v3
+              uses: actions/setup-node@v4
               with:
-                  node-version: 18.x
+                  node-version: 22.11.0
                   cache: "npm"
             - run: npm ci
             - run: npm run build
-            - run: npm test
-              # Currently typescript, eslint, and prettier are unhappy
-              continue-on-error: true
+
+            - name: Unit tests
+              run: npm run test:unit
+

.github/workflows/release-linux.yaml

@@ -0,0 +1,55 @@
+# This workflow will...
+
+name: Release Linux
+
+env:
+  GH_TOKEN: ${{ secrets.GH_TOKEN }}
+
+on:
+    workflow_dispatch:
+
+jobs:
+    release:
+        runs-on: ${{ matrix.os }}
+
+        strategy:
+            matrix:
+                os: [ubuntu-latest]
+
+        steps:
+            - name: Check out Git repository
+              uses: actions/checkout@v4
+
+            - name: update apt-get
+              run: sudo apt-get update
+
+            - name: Install rpm/flatpak packages
+              run: sudo apt-get install -y flatpak flatpak-builder rpm libarchive-tools
+
+            - name: Setup flatpak repo
+              run: |
+                flatpak remote-add --if-not-exists --user \
+                  flathub https://flathub.org/repo/flathub.flatpakrepo
+
+            - name: Use Node.js
+              uses: actions/setup-node@v4
+              with:
+                  node-version: 22.11.0
+                  cache: "npm"
+            - run: npm ci
+            - run: npm run build
+
+            - name: Build deb
+              run: npx electron-builder --config electron-builder.config.js --publish always --linux deb --x64
+
+            - name: Build rpm
+              run: npx electron-builder --config electron-builder.config.js --publish always --linux rpm --x64
+
+            - name: Build flatpak
+              run: env DEBUG="@malept/flatpak-bundler" npx electron-builder --config electron-builder.config.js --publish always --linux flatpak
+
+            - name: Upload artifact
+              uses: actions/upload-artifact@v4
+              with:
+                  name: release
+                  path: release

.gitignore

@@ -27,3 +27,6 @@ npm-debug.log.*
 *.css.d.ts
 *.sass.d.ts
 *.scss.d.ts
+
+# externals
+externals/**/target/**

.markdownlint.json

@@ -0,0 +1,8 @@
+{
+    "MD007": { "indent": 4 },
+    "MD013": false,
+    "MD041": false,
+    "MD024": false,
+    "MD033": false,
+    "MD023": false
+}

.nvmrc

@@ -0,0 +1 @@
+20.11.0

.vscode/extensions.json

@@ -1,3 +1,7 @@
 {
-    "recommendations": ["dbaeumer.vscode-eslint", "EditorConfig.EditorConfig"]
+    "recommendations": [
+        "dbaeumer.vscode-eslint",
+        "EditorConfig.EditorConfig",
+        "davidanson.vscode-markdownlint"
+    ]
 }

CHANGELOG.md

@@ -1,4 +1,457 @@
-## [0.2.0](https://github.com/Zagrios/bs-manager/releases/tag/v0.2.0) (October 23, 2022)
+## Not released yet ~
+[PR Merged since the last release](https://github.com/Zagrios/bs-manager/pulls?q=is%3Apr+is%3Amerged+merged%3A%3E2025-02-03)\
+[PR Merged since the last alpha](https://github.com/Zagrios/bs-manager/pulls?q=is%3Apr+is%3Amerged+merged%3A%3E2025-02-03)
+
+## [1.5.2](https://github.com/Zagrios/bs-manager/releases/v1.5.2) (Feb 3, 2025)
+
+### Fixes
+- Fixed an issue where BSManager was unable to load mods #786 
+
+## [1.5.1](https://github.com/Zagrios/bs-manager/releases/v1.5.1) (Jan 31, 2025)
+
+### Fixes
+- Fixed an issue where playlist files were wiped when linking the playlist folder #769 (Thanks to @silentrald)
+- Fixed missing translations when deleting duplicate maps #774
+
+### Other changes
+- Added more logs for file and folder manipulations #772 (Thanks to @silentrald)
+
+## [1.5.0](https://github.com/Zagrios/bs-manager/releases/v1.5.0) (Jan 30, 2025)
+
+### Features
+- A notification for outdated mods now appears when navigating to a Beat Saber version #755
+- Added Brazilian Portuguese translation #751 (Thanks to @arthurmluz)
+- Advanced launch arguments now accept environment variables #749 (Thanks to @silentrald)
+- Added the ability to create shortcuts in the Steam library to launch different versions of Beat Saber #731 
+- Added Italian translation #721 (Thanks to @Davitekk)
+- Added the ability to log in directly with Meta within BSManager to download Beat Saber #716 
+- Added an advanced setting on Windows to use the system proxy #704 (Thanks to @GoldJohnKing)
+- Added an advanced launch option to skip starting Steam before launching Beat Saber #664 (Thanks to @LiamillionSS)
+- You can now filter maps by leaderboard (Beatleader/ScoreSaber/All) #623 (Thanks to @silentrald)
+- BSManager now goes to the latest launched version page on startup #603 (Thanks to @silentrald)
+- Drag and drop your mods to install them #575 (Thanks to @silentrald)
+- Added Korean translation #641 (Thanks to @izunya)
+- Drag and drop your maps to import them #575 (Thanks to @silentrald)
+- Added playlist support #503
+- Added Linux support (Thanks to @silentrald and @Insprill) 
+- Added reset button to reset values when editing a Beat Saber version #438 (Thanks to @Liborsaf)
+- You can now choose to install only needed mods or reinstall all mods #540
+- The installation location for contents downloaded by BSManager is now asked after the installation of BSManager or when the previous location can no longer be accessed #566 (Thanks to @silentrald)
+- Added an advanced setting to disable hardware acceleration for BSManager #572
+- Added an advanced setting to use symlinks instead of junctions #572
+
+### Fixes
+- Fixed an issue where, under certain conditions, BSManager could crash if an error occurred while downloading Beat Saber from Steam #722 (Thanks to @silentrald)
+- Fixed an issue where switching between Beat Saber versions too quickly displayed mods for the wrong version #472
+- Fixed an issue where the launch window from a shortcut would never close #485
+- Advanced launch arguments are used even when the input field is closed #496
+- Fixed an issue where having many maps caused some maps to not have their information loaded #503
+- Fixed an issue where downloading maps sometimes resulted in a timeout error #524
+- Fixed an issue where the duration of maps could be wrong in some cases #522
+- Fixed missing styles on the "add" and "setting" buttons in the nav bar #530 
+- Fixed an issue where switching between two Beat Saber versions didn't clear the selected content of the previous version #557
+- Fixed a potential crash when BeatMods cloud contained invalid mod dependencies #558
+- Fixed an issue where the folder location for the contents downloaded by BSManager could not be changed if the previous location was unreachable #566 (Thanks to @silentrald)
+
+### Other changes
+- A new log file is now created each time BSManager is launched #750 (Thanks to @silentrald)
+- The advanced launch panel has been completely reworked #709 
+- Link and Unlink modals have been reworked to provide more detailed information to users #699 
+- Some folders are now blacklisted to prevent issues caused by linking incorrect folders #691 (Thanks to @silentrald)
+- .NET Framework is no longer required #489
+- Clear English translations for the Steam credentials popup #476 (Thanks to @Aeywoo)
+- NSFW models are now blurred when browsing for models #493
+- If map stars are unavailable, NPS or NJS of the map is now used to indicate its difficulty #553 
+- When no mods are available for a Beat Saber version, the version number is now shown #507
+- After a first full maps loading, maps loads almost instantly #503
+- Improved performance in lists with lot of contents #503
+- Improved German translation #559 (Thanks to @kgabriel-dev)
+- Updated the icon for the button to un-maximize the BSManager window #562 (Thanks to @joriskleiber)
+
+## [1.4.18](https://github.com/Zagrios/bs-manager/releases/v1.4.18) (Jan 18, 2025)
+
+### Fixes
+- Fixed an issue where enabling Oculus sideloading was not working if BSManager installation path contained spaces #735 
+- The IPA folder is now cleared each time BSIPA is installed to prevent potential crashes caused by conflicts with old BSIPA files #746 
+- Added a check to ensure the file system supports symlinks before moving contents to the shared folder #739 
+
+### Other changes
+- Events occurring in `bs-admin-start.exe` and `oculus-allow-dev-sideloaded.exe` are now logged #735
+
+## [1.4.17](https://github.com/Zagrios/bs-manager/releases/v1.4.17) (Jan 2, 2025)
+
+### Fixes
+- Fixed an issue where original Steam installations of Beat Saber did not have any mods available
+- Mod descriptions should no longer contain HTML tags
+
+## [1.4.16](https://github.com/Zagrios/bs-manager/releases/v1.4.16) (Jan 2, 2025)
+
+### Fixes
+- Fixed infinite mod loading when a mod file could not be found on BeatMods #725 (Thanks to @silentrald)
+- Fixed an issue where no mods were shown as installed when a mod dependency could not be found #726 (Thanks to @silentrald)
+- Fixed minor UI issues
+
+## [1.4.15](https://github.com/Zagrios/bs-manager/releases/v1.4.15) (Jan 2, 2025)
+
+### Fixes
+- Use the sideloading feature of Oculus to prevent errors when launching Oculus versions of Beat Saber #720
+- Oculus token starting with `OC` are now accepted
+
+### Other changes
+- Mods now load faster #508 
+- Switched to the new BeatMods API for loading mods
+
+
+## [1.4.14](https://github.com/Zagrios/bs-manager/releases/v1.4.14) (Dec 2, 2024)
+
+### Fixes
+- Fixed an issue where downloading private playlists through OneClick was always resulting in an error #679 (Thanks to @Top-Cat)
+- Beat Saber file verification was broken due to an error in DepotDownloader #677
+
+
+## [1.4.13](https://github.com/Zagrios/bs-manager/releases/v1.4.13) (Nov 26, 2024)
+
+### Features
+- Added the possibility to unselect all mods from the mods panel #666
+
+### Fixes
+- Fixed an issue where downloading maps with subfolders was not possible #649 (Thanks to @silentrald)
+- Corrected the mods search bar color in the light theme #660 (Thanks to @chk1)
+
+### Other changes
+- Added the BeatLeader icon to the OneClick playlist settings #653
+- A warning now appears before downloading an outdated BeatSaber version #654
+- Oculus BeatSaber versions no longer launch if the Oculus library is not found #657 (Thanks to @LiamillionSS)
+- Maps from BeatSaver are now sorted by relevance by default #662 (Thanks to @Top-Cat)
+- Removed the `--no-yeet` argument when launching original copies of BeatSaber #667
+- Added warnings for outdated versions in the versions view #673 
+
+
+## [1.4.12](https://github.com/Zagrios/bs-manager/releases/v1.4.12) (Nov 6, 2024)
+
+### Fixes
+- Fixed OneClick playlist download that has been broken in the previous release #645 
+- Fixed an issue where downloading playlists could fail if the playlist's file contained special characters #645 
+
+## [1.4.11](https://github.com/Zagrios/bs-manager/releases/v1.4.11) (Nov 4, 2024)
+
+### Fixes
+- BSManager was not working if the path to BSM's installation folder contained URL special characters #636 
+- Linking folders was no longer working if the folders contained files
+- Under certain conditions, loading maps could result in a black screen
+
+### Other changes
+- The "Broken Models" notification has been removed #640 
+
+
+## [1.4.10](https://github.com/Zagrios/bs-manager/releases/v1.4.10) (Oct 27, 2024)
+
+### Fixes
+- Mods using a manifest file were sometimes not detected as installed #564
+- BSIPA installation was always considered as successfull even if an error occured #511
+- Some map filter tags were no longer working #619 (Thanks to @silentrald)
+- Fixed an issue where, under certain conditions, linking a folder could result in the loss of its contents #568 
+
+### Other changes
+- Default mods are no longer reselected when mods are already installed #535 
+- The `DLC` folder has been removed from the default list of folders that can be linked #628 
+- The naming scheme for downloaded maps and playlists has been updated to prevent duplicates when downloading maps or playlists from Beat Saber or other tools
+
+
+## [1.4.9](https://github.com/Zagrios/bs-manager/releases/v1.4.9) (Oct 15, 2024)
+
+### Fixes
+- Updated DepotDownloader dependency to fix connection errors with Steam
+
+### Other changes
+- Added support for `info.dat` v4
+
+
+## [1.4.8](https://github.com/Zagrios/bs-manager/releases/v1.4.8) (Aug 1, 2024)
+
+### Other changes
+- Added checks to avoid logging sensitive data in log files
+- The oldest log files are deleted to retain a maximum of 5 log files
+
+
+## [1.4.7](https://github.com/Zagrios/bs-manager/releases/v1.4.7) (Mar 13, 2024)
+
+### Fixes
+- Fixed being unable to download models with BSManager #436 
+
+### Other changes
+- Fixed a typo in german translation (Thanks to @fllppi)
+
+## [1.4.6](https://github.com/Zagrios/bs-manager/releases/v1.4.6) (Mar 6, 2024)
+
+### Features
+- It's now possible to exclude already installed maps when downloading maps from BSManager #426 (Thanks to @Liborsaf)
+
+### Fixes
+- Fixed an issue where BSManager couldn't get path to user's documents under certain conditions, preventing any action from the user #431
+- To prevent the last launched Beat Saber version getting wiped by Oculus auto-updates, the symlink  created to launch the version is now deleted after the game stops #432
+
+## [1.4.5](https://github.com/Zagrios/bs-manager/releases/v1.4.5) (Feb 12, 2024)
+
+### Fixes
+- Fixed an issue preventing launching downgraded Steam versions under certain conditions #415 
+- Fixed an issue preventing launching downgraded Oculus versions under certain conditions #421
+- Fixed an issue where SteamVR was not properly restored after launching Beat Saber from a shortcut with FPFC mode #417 (Thanks to @slinkstr)
+
+## [1.4.4](https://github.com/Zagrios/bs-manager/releases/v1.4.4) (Feb 1, 2024)
+
+### Fixes
+- When launching an Oculus Beat Saber version, the Oculus app is also started if needed to avoid crashes #405 
+- If Steam is running as admin, Beat Saber is now also started as admin to avoid crashes #404 
+- Fixed the issue where BSManager could fail to start due to a missing DLL #400 
+- Fixed the issue where BSManager could not locate the Oculus library #398 
+
+### Other changes
+- Added some tooltips to the maps UIs #397 
+- Updated the maps panel UI for consistency with the rest of BSManager UIs #399 
+
+## [1.4.3](https://github.com/Zagrios/bs-manager/releases/tag/v1.4.3) (Dec 27, 2023)
+
+### Features
+- It's now possible to save Oculus token entered manually with a password #383
+
+### Fixes
+- Fixed issue where the latest Beat Saber version was misordered #379 
+
+### Other changes
+- Re-enabled Oculus downgrade with manual token input #383 
+
+## [1.4.2](https://github.com/Zagrios/bs-manager/releases/tag/v1.4.2) (Dec 17, 2023)
+
+### Features
+- Added Traditional Chinese translation (thanks to @mant0u0) #372
+
+### Fixes
+- Fixed an issue with keyboard navigation in the downloadable versions list [344e7ab](https://github.com/Zagrios/bs-manager/commit/344e7abc95130cfa44d9fa51365a5161c9f378a6)
+- Fixed an issue where automatic Steam version detection  was not working for some users  #375
+
+### Other changes
+- Temporarily disabled Oculus downgrade #377
+- Recommended version now appears first in the versions list #376 
+- Updated the "Broken Models" notification #378 
+
+## [1.4.1](https://github.com/Zagrios/bs-manager/releases/tag/v1.4.1) (Dec 5, 2023)
+
+### Features
+- Added Japanese translation (thanks to @emesan22) #365
+
+### Fixes
+- Fixed a JavaScript error that occurred when closing a window during a download #366
+- Resolved text overflow issue with the Spanish translation #367
+- Fixed an issue where downloading a playlist was not possible if a version do not has the "CustomLevel" folder #368
+- Installing a playlist now doesn't download maps that are already present #369 
+
+## [1.4.0](https://github.com/Zagrios/bs-manager/releases/tag/v1.4.0) (Nov 28, 2023)
+
+### Features
+- Oculus PCVR support #346 
+- The most moddable version now have a “Recommended” banner #354 
+- Chinese translation has been added (thanks to @ktKongTong)
+
+### Fixes
+- BSManager crashes if too many OneClick downloads are done at the same time #340
+- Unable to download playlists with OneClick from some websites #349
+- "Refresh list" was updating available versions but not installed versions #351
+- Prevent launching a version that is currently downloading #355 
+- Prioritize IPv4 to avoid IPv6 issues #353 
+- Import version progress bar is now accurate #358
+
+### Other changes
+- Fix french translation misspelling and standardize the "Beat Saber" name #341 (Thanks to @Synaelle)
+
+## [1.3.2](https://github.com/Zagrios/bs-manager/releases/tag/v1.3.2) (Oct 8, 2023)
+
+### Fixes
+- Maps or Playlists couldn't be downloaded with OneClick if maps were linked #331 #337 
+- Mishandling of additional launch arguments when launching from a shortcut #335 
+- Incorrect English translation #336 
+
+## [1.3.1](https://github.com/Zagrios/bs-manager/releases/tag/v1.3.1) (Oct 2, 2023)
+
+### Features
+- Beat Saber versions now automatically sync with LIV #320
+- Use ArcViewer to preview maps #312 
+
+### Fixes
+- SteamVR backup folder is now restored when disabling FPFC Mode #314 
+- OneClick installs now correctly place contents in user-defined symlinks #311
+- Currently downloading Beat Saber version no longer disappears on uninstalling a version #307 
+- Add "no-yeet" argument when launching Beat Saber to prevent mods to be removed if "UserData" is linked #321
+- Fixed a rare bug that prevent BSManager from launching due to a missing DLL #328 
+- Increase the SteamVR restore timeout to prevent it from launching in FPFC Mode #330 
+
+### Other changes
+- Improved Spanish translation #309 (Thanks to @GabiRP)
+- For new installations, the default folder for BSManager contents has been moved from "Documents" to the "User" directory to avoid OneDrive conflicts #319 
+
+## [1.3.0](https://github.com/Zagrios/bs-manager/releases/tag/v1.3.0) (Aug 10, 2023)
+
+### Features
+- Steam now launches automatically if needed when starting a version of Beat Saber #255
+- Create shortcuts to launch Beat Saber more quickly without going through BSManager #282
+- Russian translation has been added (thanks to @Dead0Duck)
+- Download Beat Saber versions without enter your credentials using QR code to login #293 
+- Login approval from the Steam app is now being handled #293 
+
+### Fixes
+- Unable to delete maps from shared content #262
+- Maps are no longer loaded unnecessarily when not accessing the map tab #261
+- BSManager no longer crashes when it loads tons of maps #288 
+- Loading maps is faster and consumes a lot less memory #288
+- Prevent installed mods from being downgraded after mods installation #291
+- Window title of BSManager no longer become "index.html" after closing settings #290 
+- Models' texts color within the download modal in light theme is now correct #296 
+- Downloading versions of Beat Saber now works on Linux #297 (thanks to @Insprill)
+- Fix the ability to focus on non-visible elements #299 
+
+### Other changes
+- Corrections and adjustments of some translations for better clarity #249 #279 (Thanks to @AltyFox and @KnuckleDF)
+- Improved compatibility with Linux (Thanks to @RedlineTriad and @Insprill)
+- Alpha versions should now update to the latest Stable version when its available #294 
+
+## [1.2.0](https://github.com/Zagrios/bs-manager/releases/tag/v1.2.0) (Jun 16, 2023)
+
+### Features
+- Add models management #218
+- Hexadecimal field has been added in color pickers #236 
+- "Show Password" button has been added in the login modal #244 
+
+### Fixes
+- Made permission error not possible when installing mods #219
+- Fix progress collision when switching versions while maps are being loaded #220 
+- Some mods do not show as installed after an update #231
+- Some mods are not marked as updated, after a mods update #229 
+- Shortcut to BSManager had an incorrect description #240 
+- Mod LookupID was never shown as installed #242 
+- Usernames with spaces were not supported for Steam login #243 
+- Can't clone Steam version without renaming it #248 
+
+### Other changes
+- Some UI elements have been reorganized to make usage more pleasant #218 
+- Initial loading of mods is now faster #232 
+- A warning has been added when the Steam password exceeds 64 characters #225 
+
+## [1.1.1](https://github.com/Zagrios/bs-manager/releases/tag/v1.1.1) (Apr 13, 2023)
+
+### Features
+- Add German translation #198 #199 (thanks @XCraftTM)
+- Add message when no mods are available #197 
+- Add button to link all folders at once #204 
+- Add indicator when a supporter is clickable #208 
+
+### Fixes
+- Fix error with mods management when offline #202
+- Can't open supporter link #207 
+- Change color of diamond supporters to match the discord role color #208 
+- Error when spaces are present in Steam Guard code #209 
+- Unable to move contents folder of BSManager when parent folder is named "BSManager" #210 
+- Unable to move contents folder of BSManager to another drive if symlinks are present #210 
+- Improve resilience to errors when moving contents folder of BSManager #210 
+- A strange bug prevents the launch of Beat Saber for some people #215 
+
+### Other changes
+- Add BeatLeader icon in OneClicks settings #193 
+
+## [1.1.0](https://github.com/Zagrios/bs-manager/releases/tag/v1.1.0) (Mar 24, 2023)
+
+### Features
+- Custom folders can now be shared between BeatSaber versions #176  
+- Advanced launch options to add custom launch arguments for BeatSaber #179 
+- Added an indicator if the current version is a preview #185 
+
+### Fixes
+- Disable SteamVR when "Desktop Mode" is enabled #181 
+- Fix some UI bugs #175 
+- Reactivate support button #183 
+- Installing an older version of a mod overwrites the most recent version installed #186
+- On version cloning, contents of linked folders no longer duplicate #189 
+- Now, the content of a shared folder is moved instead of being duplicated if no other version uses this shared folder #191 
+
+## [1.0.4](https://github.com/Zagrios/bs-manager/releases/tag/v1.0.4) (Mar 4, 2023)
+
+### Features
+- Add volume control #154 
+
+### Fixes
+- Fix some English translations #153 #151 #167 
+- The debug console does not open #158 
+- Can't enable Oculus and Desktop mode in the same time #159 
+- Pause Map song on open preview #160 
+- Reduces map loading time by 20 to 40% depending on configuration (still work on that) #161 
+- Mods menu partially hidden when no mods listed #165 
+- Fix light theme issues #168 
+- The .NET installation request notification sometimes does not appear #170 
+- Change Oculus Mode description #166 
+
+### Other changes
+- We have added an explanation of why we need your Steam credentials to download a BeatSaber version #164 
+
+## [1.0.3](https://github.com/Zagrios/bs-manager/releases/tag/v1.0.3) (Feb 28, 2023)
+
+### Fixes
+- Can't download Beat Saber version if there are spaces in the folder path
+
+## [1.0.2](https://github.com/Zagrios/bs-manager/releases/tag/v1.0.2) (Feb 24, 2023)
+
+### Fixes
+- Huge RAM usage optimization in maps list #140 
+- Maps deletion is way faster #140 
+- Maps progress bars are now accurate #140 
+- Maps loading is slightly faster #140 
+- Other little optimizations for the Maps management feature #140 
+- OneClick install for Maps not work if no Beat Saber version is installed #141
+- Little English translation fix #143 
+
+## [1.0.1](https://github.com/Zagrios/bs-manager/releases/tag/v1.0.1) (Feb 6, 2023)
+
+### Fixes
+- Some French translation corrections #133 
+- Update the default Mods to be more consistent with ModAssistant #132 #135 
+- Disable the `Support BSManager` button due to the change of the donation platform #134 
+
+## [1.0.0](https://github.com/Zagrios/bs-manager/releases/tag/v1.0.0) (Jan 26, 2023)
+
+### Breaking Change
+
+- Config file have been moved to contents folder of BSManager to keep user config even if it exports the contents folder to another pc #55
+- Versions file system have been modified to be more reliable #118 
+
+### Features
+
+- Maps Management #35 
+- OneClick installs (maps, playlists, models) #35
+- Oculus BeatSaber detection #17 
+- Lunch Steam from BSManager #37 
+- Alert if dotnet is not installed #54 
+- Swipe notification to close it #40 
+- Add discord button in settings #46 
+- Add Mods disclaimer #50 
+- Some UI tweaks #39 #51
+- Moving from Patreon to Mee6 #86 
+- Add launch mod infos #11 
+- Can import external BeatSaber installs #121
+- Add Web installer
+
+### Fixes
+
+- Outdated mod not seen as outdated #36 
+- Settings close button was stuck when scrolling #85 
+- Error when try to loading mods without internet #87 
+- Can't manage any version if Oculus app is not installed #101 
+- Download version button overlap with the spin loader #99 
+- After uninstall last BeatSaber version we stay on the same page #105 
+- No more files verification in available versions list #126 
+
+### Other Changes
+
+- Fix high CPU usage #121 
+
+## [0.2.0](https://github.com/Zagrios/bs-manager/releases/tag/v0.2.0) (Oct 23, 2022)
 
 ### Features
 

CONTRIBUTING.md

@@ -1,32 +1,108 @@
-## Contributing
+# Contributing to BSManager
 
 [code-of-conduct]: CODE_OF_CONDUCT.md
 [fork]: https://github.com/Zagrios/bs-manager/fork
 [pr]: https://github.com/Zagrios/bs-manager/compare
 [style]: https://github.com/basarat/typescript-book/blob/master/docs/styleguide/styleguide.md
 
-Hi there! We're thrilled that you'd like to contribute to this project. Your help is essential for keeping it great.
+Hello! We’re delighted that you’re interested in contributing to **BSManager**. Your help is essential to maintaining and improving this project.
 
-Please note that this project is released with a [Contributor Code of Conduct][code-of-conduct]. By participating in this project you agree to abide by its terms.
+> [!NOTE]  
+> This project is released with a [Contributor Code of Conduct][code-of-conduct]. By participating, you agree to abide by its terms.
 
-## Issues and PRs
+---
 
-If you have suggestions for how this project could be improved, or want to report a bug, open an issue! We'd love all and any contributions. If you have questions, too, we'd love to hear them.
+## Opening Issues
 
-We'd also love PRs. If you're thinking of a large PR, we advise opening up an issue first to talk about it, though! Look at the links below if you're not sure how to open a PR.
+- **Reporting Bugs**  
+  If you find a bug or any unexpected behavior, feel free to open an issue. Be sure to include steps to reproduce it, relevant logs, versions, and any other pertinent details.
+- **Suggesting Enhancements**  
+  Have an idea for improving BSManager? We welcome all suggestions—open an issue to discuss your proposal.
 
-## Submitting a pull request
+> [!TIP] 
+> Before opening a new issue, please check if there’s already an existing one for the same topic to avoid duplicates.
 
-1. [Fork][fork] and clone the repository.
-1. Configure and install the dependencies: `npm install`.
-1. Create a new branch following naming convention: `git checkout -b (feature|bugfix|hotfix|chore)/(short-description)(/issue-id)`.
-1. Make your change, test, and make sure BSManager work fine.
-1. Push to your fork and [submit a pull request][pr].
-1. Pat your self on the back and wait for your pull request to be reviewed and merged.
+---
 
-Here are a few things you can do that will increase the likelihood of your pull request being accepted:
+## Submitting Pull Requests
 
--   Follow the [style guide][style] which is using standard.
--   Keep your changes as focused as possible. If there are multiple changes you would like to make that are not dependent upon each other, consider submitting them as separate pull requests.
+### Before You Begin
 
-Work in Progress pull requests are also welcome to get feedback early on, or if there is something blocked you.
+1. **[Fork the repository][fork]** and **clone** your fork locally.  
+2. **Install the required Node.js version** (we recommend using [Volta](https://volta.sh/) to manage Node versions).  
+3. **Install project dependencies**:
+   ```bash
+   npm install
+   ```
+
+### Create a Dedicated Branch
+
+Use a clear naming convention for your branch:
+
+```bash
+git checkout -b (feature|bugfix|hotfix|chore)/(short-description)(/issue-id)
+```
+
+> [!NOTE]  
+> Exemple : `git checkout -b feature/update-docs/42`
+
+### Develop and Test
+
+> [!TIP] 
+> - Follow the [style guide][style] which is using standard.
+> - Keep your changes as focused as possible. If there are multiple changes you would like to make that are not dependent upon each other, consider submitting them as separate pull requests.
+
+- Make the necessary changes on your new branch.
+- Test your changes manually to ensure everything is working correctly.
+- Verify that your updates do not introduce regressions or break existing functionality.
+
+### Open a Pull Request
+
+1. **Push** your branch to your fork.  
+2. Visit the main **BSManager** repository and click “Compare & pull request” or use [this link][pr].  
+3. Provide a **clear description** of your changes (the context, what problem it solves, etc.).  
+4. **Submit** your pull request. A maintainer will review it and may ask for adjustments or clarifications.
+
+---
+
+## Useful Commands
+
+### Development
+
+```bash
+npm start
+```
+
+> Runs the application in development mode.
+
+### Packaging
+
+```bash
+npm run package  
+```
+
+> Packages the application using Electron Builder.
+
+```bash
+npm run build && electron-builder --config electron-builder.config.js --publish never --x64 --linux <deb/rpm/pacman>
+```
+
+> Package for Linux distros (deb, rpm, pacman)
+
+```bash
+npm run publish
+```
+
+> Publishes the application (primarily for Windows).
+
+```bash
+npm run publish:flatpak
+```
+
+> Build a Flatpak package
+
+## Need Help?
+
+If you have any questions or need further assistance, feel free to **open an issue** or reach out via our [discord](https://discord.gg/uSqbHVpKdV). We appreciate any and all contributions you make to BSManager!
+
+Thank you for your interest in making BSManager better!

README.md

@@ -36,7 +36,6 @@
   <hr>
 </div>
 
-
 <!--
 ----------------------------------------
     BADGES
@@ -57,10 +56,12 @@
   <a href="https://discord.gg/uSqbHVpKdV"><img
       src="https://img.shields.io/badge/-DISCORD-5865f2?style=for-the-badge&logo=discord&logoColor=ffffff"
       alt="discord" /></a>
-  <a href="https://www.patreon.com/bsmanager"><img
-      src="https://img.shields.io/badge/-🥰%20Support%20BSM-EC4546?style=for-the-badge" alt="Donation" /></a>
   <a href="https://twitter.com/BSManager_"><img
-      src="https://img.shields.io/badge/-Twitter-F5F8FA?style=for-the-badge&logo=Twitter" alt="Twitter" /></a>
+      src="https://img.shields.io/badge/-Twitter-black?style=for-the-badge&logo=X" alt="Twitter" /></a>
+<a href="https://www.bsmanager.io">
+  <img src="https://img.shields.io/badge/-WebSite-00649c?style=for-the-badge&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAxMDAwIDEwMDAiPgogIDxnIGZpbGw9IiMzYjgyZmYiPgogICAgPHBhdGggZD0ibTYyNi43NSA0ODUuOTEgMjAuODIgMzUxLjk0YTM1LjIxIDM1LjIxIDAgMCAxLTE1LjQ5IDMxLjM2bC0xNDQuNzEgOTYuMTRoLS4wNmEzNS41NiAzNS41NiAwIDAgMS0xMS4zMSA0Ljc3IDM0Ljg1IDM0Ljg1IDAgMCAxLTIzLjUxLTIuODdMMTM2LjU4IDgwOS45YTExNS40NSAxMTUuNDUgMCAwIDEtNjMuNzUtOTYuNDlMNTIgMzYxLjQ2YTM1LjI2IDM1LjI2IDAgMCAxIDE1LjIzLTMxLjIxbDE0NS4wNS05Ni4zNmEzNS43MiAzNS43MiAwIDAgMSAxMS4yNy00LjcgMzQuODcgMzQuODcgMCAwIDEgMjMuNTEgMi44N0w1NjMgMzg5LjQyYTExNS40MSAxMTUuNDEgMCAwIDEgNjMuNzUgOTYuNDlaIi8+CiAgICA8cGF0aCBmaWx0ZXI9ImJyaWdodG5lc3MoMzAlKSIgZD0ibTYxMy43OCA0ODYuNjcgMjAuODIgMzUyYTIyLjM0IDIyLjM0IDAgMCAxLTMyLjI2IDIxLjMxTDI4Ni40IDcwMi41N0ExMDIuNDMgMTAyLjQzIDAgMCAxIDIyOS44MyA2MTdMMjA5IDI2NWEyMi4zNSAyMi4zNSAwIDAgMSAzMi4yNi0yMS4zMkw1NTcuMiA0MDEuMDVhMTAyLjQyIDEwMi40MiAwIDAgMSA1Ni41OCA4NS42MloiLz4KICA8L2c+CiAgPHBhdGggZD0iTTcxOC4yOSA3NzYuNDggNzAwIDgwNC4xOGMtNDAuNjMgMzkuNS04Ny4wNiA2Ny4yNS0xMzMuODEgOTAuNzUtODcuMzIgNDMuOS0yMDMuNjcgNzcuMTktMjQ5IDkwLjM0YTQ4IDQ4IDAgMCAxLTI2LjE3LjE2Yy02NC0xNy43Mi0xODguNjItNzItMjM2LjI4LTEyNS40OWE0LjIzIDQuMjMgMCAwIDEgNS4zLTYuNDVjMzUuNjQgMjAuODcgMTExLjIyIDU3LjY0IDE1Ni4zNyA3NC4yMiA0OS4xOCAxOC4wNiA4MS4yOSA4Ljc0IDkyLjI4LTMuMjZhNC43NyA0Ljc3IDAgMCAxIDcuMjQuMjFjMTkuNTEgMjQgMTA3LjI2IDQuNiAxNjYuNjQtMTMgNjQuMzQtMTkgMTg1Ljg1LTc2LjU2IDIzNS43Mi0xMzUuMThabS0xOTYuMiAxNTcuMzMtMTQ3LjQ1IDU1LjY4YTMuOTIgMy45MiAwIDAgMCAxLjQ0IDcuNThsNTQuNjItLjc3YTM1LjYzIDM1LjYzIDAgMCAwIDE5LTUuNzlsNzYtNDkuNTVhNCA0IDAgMCAwLTMuNjEtNy4xNVpNMjE4LjkyIDE5NS41NmMtMjEuMTQuMDctMzMuNTUgMzUuODYtMzMuMTYgODkuMDguMiAyOCAyLjU4IDkyLjc0IDQuNzkgMTQ3LjczLjIzIDUuNzEtOC4xOCA2LjQ4LTkgLjgxbC0zOC40Mi0yNzAuNzFhNC4zOCA0LjM4IDAgMCAxIDcuMTItNCA2My42MyA2My42MyAwIDAgMCAyMS45MyAxMS44NSA0LjYxIDQuNjEgMCAwIDAgNS45LTMuNzJjNC4yLTI3LjcgMTYuNjMtNTguNzQgMzcuMzUtODguNzRhNC4zNiA0LjM2IDAgMCAxIDcuNTYuNjljMTAuODYgMjMuODcgNDkgMTAzLjggOTMuMzQgMTUyLjc5YTQuNjUgNC42NSAwIDAgMS01LjYyIDcuMjJjLTM2LjU3LTE5LjM4LTgzLjAxLTQzLjAyLTkxLjc5LTQzWm0tMTUuNDcgMzg0LjhhNC41MSA0LjUxIDAgMCAxLTQuNDYtMy45MmwtMTMuODItMTA3LjI5YTQuNSA0LjUgMCAwIDEgOC45My0xLjE1bDEzLjgyIDEwNy4yOWE0LjUgNC41IDAgMCAxLTMuODkgNSAzLjg2IDMuODYgMCAwIDEtLjU4LjA3Wk01NzcuMDggNTQuNThjLTQ2Ljc5IDE1Ljg1LTExNS40NSA0MC41Ni0xNTguNzMgNjIuNzlhMzUuNSAzNS41IDAgMCAwLTE4LjU3IDI0LjUzYy0zLjk1IDE5LjQ5LTExIDU2LjA5LTE5IDEwNy4yNi0uNyA0LjQ4LTcuMzYgMy43OC03LjExLS43NWwxMC42Ni0xOTQuNzNhMy43OCAzLjc4IDAgMCAxIDcuNDYtLjY2bDMuNDkgMTQuODVhMi41NyAyLjU3IDAgMCAwIDQuNjkuNzdjNi4xOC0xMCAyMi4zNy0zMi43OSA1Ny4zMi02NWE0LjEzIDQuMTMgMCAwIDEgNi41NiA0LjcybC0zMi41NCA3Mi44OXM3OC43OC0xOS4zNyAxNDQtMzMuMDljNC4xMS0uODcgNS42OSA1LjA4IDEuNzcgNi40MloiIGZpbGw9IiNmZmYiIHN0cm9rZT0iYmxhY2siLz4KICA8ZyBmaWxsPSIjZjQ0Ij4KICAgIDxwYXRoIGZpbHRlcj0iYnJpZ2h0bmVzcyg2MCUpIHNhdHVyYXRlKDEyMCUpIiBkPSJtOTQ3LjA3IDQxMC4zNS01Ny43NSAzNDcuNzlhMzUuMTggMzUuMTggMCAwIDEtMjIuMDYgMjcuMTVsLTE2Mi40MyA2MS42NWgtLjA2YTM1LjUyIDM1LjUyIDAgMCAxLTEyLjA2IDIuMTEgMzQuODMgMzQuODMgMCAwIDEtMjIuMjktOGwtMjczLjE3LTIyMy41YTExNS40MyAxMTUuNDMgMCAwIDEtNDAuNzYtMTA4LjIybDU3Ljc1LTM0Ny44QTM1LjI1IDM1LjI1IDAgMCAxIDQzNiAxMzQuNDdsMTYyLjgzLTYxLjc5YTM1LjUxIDM1LjUxIDAgMCAxIDEyLTIuMDggMzQuODMgMzQuODMgMCAwIDEgMjIuMjkgOGwyNzMuMTkgMjIzLjUyYTExNS4zOCAxMTUuMzggMCAwIDEgNDAuNzYgMTA4LjIzWiIvPgogICAgPHBhdGggZD0iTTkzNC4yNSA0MDguMjIgODc2LjUgNzU2YTIyLjM0IDIyLjM0IDAgMCAxLTM2LjE4IDEzLjYzbC0yNzMuMTctMjIzLjVhMTAyLjQyIDEwMi40MiAwIDAgMS0zNi4xNy05Nmw1Ny43NS0zNDcuODNhMjIuMzQgMjIuMzQgMCAwIDEgMzYuMTgtMTMuNjNsMjczLjE3IDIyMy41MWExMDIuNDIgMTAyLjQyIDAgMCAxIDM2LjE3IDk2LjA0WiIvPgogIDwvZz4KICA8ZWxsaXBzZSBmaWxsPSIjZmZmIiBzdHJva2U9ImJsYWNrIiBjeD0iNzMyLjYxIiBjeT0iNDI5LjE2IiByeD0iNjIuODMiIHJ5PSIxMTAuNzMiIHRyYW5zZm9ybT0icm90YXRlKC0xNS40NSA3MzIuNzAzIDQyOS4xOTkpIi8+Cjwvc3ZnPg=="  alt="Website" /></a>
+  <a href="https://www.patreon.com/bsmanager"><img
+      src="https://img.shields.io/badge/-🤍%20Support%20BSM-EC4546?style=for-the-badge" alt="Donation" /></a>
 </div>
 
 <!--
@@ -70,76 +71,64 @@
 -->
 <div>
   <hr>
-  <details open>
+    <details open>
     <summary><b>Table of Contents</b></summary>
     <ul>
-      <li>
+        <li>
         <details>
-          <summary><a href="#bsmanager-your-beat-saber-assistant">BSManager: Your Beat Saber Assistant</a></summary>
-          <ul>
+            <summary><a href="#bsmanager-your-beat-saber-assistant">BSManager: Your Beat Saber Assistant</a></summary>
+            <ul>
             <li><a href="#what-is-it">What is it?</a></li>
             <li><a href="#why-use-it">Why use it?</a></li>
             <li><a href="#built-with">Built with</a></li>
-            <li><a href="#how-to-install">How to install</a></li>
-          </ul>
+            <li><a href="#how-to-install">How to install?</a></li>
+            </ul>
         </details>
-      </li>
-      <li>
+        </li>
+        <li>
         <details>
-          <summary><a href="#version-management">Version Management</a></summary>
-          <ul>
-            <li>
-              <details>
-                <summary><a href="#downloading-multiple-versions">Downloading multiple versions</a></summary>
-                <ul>
-                  <li>via Steam account</li>
-                  <li>via Oculus (PCVR) account</li>
-                </ul>
-              </details>
-            </li>
-            <li><a href="#multi-version-sharing">Multi-version Sharing</a></li>
-            <li><a href="#importing-an-existing-version-of-beat-saber">Importing an existing version of Beat Saber</a>
-            </li>
-            <li><a href="#launch-arguments">Launch arguments</a></li>
-            <li><a href="#shortcut-creation">Shortcut creation</a></li>
-          </ul>
+            <summary><a href="#version-management">Version Management</a></summary>
+            <ul>
+            <li><a href="#downloading-multiple-versions">Downloading Multiple Versions</a></li>
+            <li><a href="#multi-version-sharing">Multi-Version Sharing</a></li>
+            <li><a href="#importing-an-existing-version-of-beat-saber">Importing an Existing Version of Beat Saber</a></li>
+            <li><a href="#launch-arguments">Launch Arguments</a></li>
+            <li><a href="#shortcut-creation">Shortcut Creation</a></li>
+            </ul>
         </details>
-      </li>
-      <li>
+        </li>
+        <li>
         <details>
-          <summary><a href="#download-and-installation">Download and Installation</a></summary>
-          <ul>
-            <li><a href="#maps">Maps</a></li>
-            <li><a href="#playlists">Playlists</a></li>
-            <li><a href="#mods">Mods</a></li>
-            <li><a href="#models">Models</a></li>
-          </ul>
+            <summary><a href="#download-and-installation">Download and Installation</a></summary>
+            <ul>
+            <li><a href="#features">Features</a></li>
+            </ul>
         </details>
-      </li>
-      <li>
+        </li>
+        <li>
         <details>
-          <summary><a href="#customization">Customization</a></summary>
-          <ul>
+            <summary><a href="#customization">Customization</a></summary>
+            <ul>
             <li><a href="#tool">Tool</a></li>
             <li><a href="#beat-saber-instance">Beat Saber Instance</a></li>
-          </ul>
+            </ul>
         </details>
-      </li>
-      <li>
+        </li>
+        <li>
         <details>
-          <summary><a href="#more-information">More Information</a></summary>
-          <ul>
+            <summary><a href="#more-information">More Information</a></summary>
+            <ul>
             <li><a href="#support">Support</a></li>
             <li><a href="#credits">Credits</a></li>
-            <li><a href="#Contributing">Contributing</a></li>
-          </ul>
+            <li><a href="#contributing">Contributing</a></li>
+            </ul>
         </details>
-      </li>
+        </li>
     </ul>
-  </details>
-  <div align="right">
+    </details>
+    <div align="right">
     [<a href="#readme-bot">Go to bottom</a>]
-  </div>
+    </div>
 </div>
 
 
@@ -153,7 +142,6 @@
   <h1><b>BSManager: Your Beat Saber Assistant</b></h1>
 </div>
 
-
 <!--
     WHAT IS IT?
 ----------------------------------------
@@ -164,7 +152,6 @@
       Saber</a> experience by centralizing the management of mods, maps, and game versions in one place.</p>
 </div>
 
-
 <!--
     WHY USE IT?
 ----------------------------------------
@@ -187,7 +174,6 @@
   <video src="https://github.com/Zagrios/bs-manager/assets/40648115/012b0196-74ef-4ee5-86a4-49e835612f96"/>
 </div>
 
-
 <!--
     BUILT WITH
 ----------------------------------------
@@ -217,16 +203,23 @@
   </ul>
 </div>
 
-
 <!--
     HOW TO INSTALL
 ----------------------------------------
 -->
 <div>
   <h2><b>How to install?</b></h2>
+</div>
+
+<div>
+  <h3><b>Windows Installation</b></h3>
   <ul>
-    <li>Download the <a href="https://github.com/Zagrios/bs-manager/releases/latest">latest release</a> from <a
-        href="https://github.com/Zagrios/bs-manager/releases">Releases</a>.</li>
+    <li>Download and install <a href="https://www.bsmanager.io">BSManager</a> from one of the following sources:</li>
+        <ul>
+            <li><a href="https://github.com/Zagrios/bs-manager/releases/latest">GitHub</a></li>
+            <li><a href="https://www.bsmanager.io">Official Website</a></li>
+            <li><a href="https://www.nexusmods.com/beatsaber/mods/18?tab=files">Nexus Mods</a></li>
+        </ul>
     <li>Execute the installer and <a href="https://github.com/Zagrios/bs-manager">BSManager</a> will start itself.</li>
     <li>Once it's done, if you want to download a version, select a version and download it! </li>
     <li>From the version page you can choose options, launch the version, and more!</li>
@@ -237,6 +230,10 @@
   <video src="https://github.com/Zagrios/bs-manager/assets/40648115/4215384e-eb68-40da-884c-f21df491ef75" />
 </div>
 
+<div>
+  <h3><b>Linux Installation</b></h3>
+  <p>BSManager is also available on Linux! Follow the step-by-step guide in our <a href="https://github.com/Zagrios/bs-manager/wiki/Linux">Linux installation wiki</a> to set it up properly.</p>
+</div>
 
 <!--
 ----------------------------------------
@@ -254,50 +251,27 @@
     existing ones, provided that you own the game on a Steam or Oculus (PC) account.</p>
 </div>
 
-
 <!--
     DOWNLOADING MULTIPLE VERSIONS
 ----------------------------------------
 -->
 <div>
   <h2>Downloading Multiple Versions</h2>
-  <p><a href="https://github.com/Zagrios/bs-manager">BSManager</a> provides two authentication methods to access your
-    Steam account, ensuring safe and flexible access to
-    different game versions:</p>
-</div>
-
-<div align="center">
-  <img src="https://github.com/Zagrios/bs-manager/assets/40648115/09d579de-8b8e-45d3-8829-21a25cc7daf8"/>
-</div>
-
-<div>
+  <p><a href="https://github.com/Zagrios/bs-manager">BSManager</a> allows you to safely and easily access different versions of Beat Saber, ensuring flexibility for modding or version-specific preferences.</p>
+  <p>To download a version, you can authenticate using two methods:</p>
   <ul>
-    <li><strong>via Steam</strong>: Use either your credentials, which will not be stored by <a
-        href="https://github.com/Zagrios/bs-manager">BSManager</a> or
-      <a href="https://github.com/SteamRE/DepotDownloader">DepotDownloader</a>, or opt for a quick and secure
-      authentication via QR with the Steam Guard app.</li>
+    <li><strong>via Steam</strong>: Authenticate securely using your Steam credentials or by scanning a QR code with the Steam Guard app.</li>
+    <li><strong>via Oculus</strong>: BSManager redirects you to the official Oculus website for authentication to retrieve your token securely. Alternatively, you can follow <a href="https://github.com/Zagrios/bs-manager/wiki/How-to-obtain-your-Oculus-Token">this guide</a> to obtain your token manually and paste it into BSManager.</li>
   </ul>
+  <p>For detailed instructions on installing versions, follow this tutorial:  
+    👉 <a href="https://github.com/Zagrios/bs-manager/wiki/install-or-import-a-version">How to install or import a version</a>
+  </p>
 </div>
 
 <div align="center">
-  <img src="https://github.com/Zagrios/bs-manager/assets/40648115/26da3a19-a936-4e6b-b79b-a139d7bd55de" />
-
+  <img src="https://github.com/Zagrios/bs-manager/assets/40648115/09d579de-8b8e-45d3-8829-21a25cc7daf8" alt=""/>
 </div>
 
-<div>
-  <ul>
-    <li><strong>via Oculus</strong>: For Oculus users, <a href="https://github.com/Zagrios/bs-manager">BSManager</a>
-      uses authentication directly via the <a href="https://about.meta.com/fr/">META</a> website
-      to retrieve the connection token, ensuring reliable and secure access to your account data.</li>
-  </ul>
-</div>
-
-<div align="center">
-  <img height=450 src="https://github.com/Zagrios/bs-manager/assets/40648115/1e4a2f98-af16-45aa-821d-0c4e90e1e54b" />
-  <img height=450 src="https://github.com/Zagrios/bs-manager/assets/40648115/3674e629-542d-4de3-b8db-b248f25126d7" />
-</div>
-
-
 <!--
     MULTI-VERSION SHARING
 ----------------------------------------
@@ -312,10 +286,9 @@
 </div>
 
 <div align="center">
-  <video src="https://github.com/Zagrios/bs-manager/assets/40648115/ba39aceb-f55f-4e58-8386-51fcfaad4957"/> 
+  <video src="https://github.com/Zagrios/bs-manager/assets/40648115/ba39aceb-f55f-4e58-8386-51fcfaad4957"/>
 </div>
 
-
 <!--
     IMPORTING AN EXISTING VERSION OF BEAT SABER
 ----------------------------------------
@@ -332,49 +305,53 @@
   <video src="https://github.com/Zagrios/bs-manager/assets/40648115/cdedb951-d97a-474d-a217-2422be3919f7"/>
 </div>
 
-
 <!--
     LAUNCH ARGUMENTS
 ----------------------------------------
 -->
 <div>
   <h2>Launch Arguments</h2>
-  <p><a href="https://github.com/Zagrios/bs-manager">BSManager</a> provides efficient management of <a
-      href="https://beatsaber.com/">Beat Saber</a> launch arguments, including three predefined ones to
-    enhance your gaming experience:</p>
+  <p><a href="https://github.com/Zagrios/bs-manager">BSManager</a> provides advanced management of launch arguments for <a href="https://beatsaber.com/">Beat Saber</a>, allowing you to customize your gaming experience.</p>
+
+  <h3>Predefined Arguments</h3>
   <ul>
-    <li><strong>Oculus Mode</strong>: Launches the game directly in Oculus mode, avoiding the use of STEAM VR.</li>
-    <li><strong>FPFC Mode</strong>: Enables "FPFC" mode, allowing you to control the game without using a VR
-      headset.</li>
-    <li><strong>Debug Mode</strong>: Activates debugging mode, generating Windows log outputs for IPA.</li>
+    <li><strong>Oculus Mode</strong>: Allows you to use Oculus's VR composer while bypassing SteamVR, which may improve performance. (Only useful if you launch the game via Steam).</li>
+    <li><strong>FPFC Mode</strong>: Enables "First Person Flying Controller" mode, allowing you to navigate menus using the keyboard (WASD) and mouse without a VR headset.</li>
+    <li><strong>Debug Mode</strong>: Activates the IPA debug console, displaying logs used by mods.</li>
+    <li><strong>Skip Steam</strong>: Prevents Steam from opening automatically with Beat Saber, useful if you use an alternative VR runtime like WIVRn or Monado.</li>
+    <li><strong>Map Editor</strong>: Launches the official Beat Saber map editor instead of the game.</li>
   </ul>
-  <p>You also have the freedom to add your own custom launch arguments by inserting them into "Advanced Launch" and
-    separating them with a semicolon (;).</p>
+
+  <h3>Custom Arguments</h3>
+  <p>You can also add your own custom launch arguments by inserting them into "Advanced Launch" and separating them with a semicolon (;).</p>
+
+  <h3>Pinning Arguments</h3>
+  <p>You can now pin your favorite launch arguments for quick access. By default, only <strong>Oculus Mode</strong> and <strong>Debug Mode</strong> are pinned.</p>
 </div>
 
 <div align="center">
-  <img src="https://github.com/Zagrios/bs-manager/assets/40648115/1244d49f-20e1-400c-9818-528f05cfadf5" />
+  <img src="https://github.com/user-attachments/assets/c247b237-9c49-4e7b-9366-aeb1dd3b7b9a" alt="" />
 </div>
 
-
 <!--
     SHORTCUT CREATION
 ----------------------------------------
 -->
 <div>
   <h2>Shortcut Creation</h2>
-  <p>Create shortcuts to easily access your different versions of <a href="https://beatsaber.com/">Beat Saber</a> with
-    <a href="https://github.com/Zagrios/bs-manager">BSManager</a>. After selecting your
-    version, go to the version settings, click on "Create a Shortcut", and then select your launch options. Thus,
-    you can quickly and easily launch your preferred version of <a href="https://beatsaber.com/">Beat Saber</a> with the
-    desired settings.</p>
+  <p>Create shortcuts to easily access your different versions of <a href="https://beatsaber.com/">Beat Saber</a> with <a href="https://github.com/Zagrios/bs-manager">BSManager</a>.
+  </p>
+  <p>To learn how to create a shortcut, follow the tutorial available here:  
+    👉 <a href="https://github.com/Zagrios/bs-manager/wiki/create-a-shortcut">Shortcut Creation Guide</a>
+  </p>
+  <p>This allows you to quickly and easily launch your preferred version of <a href="https://beatsaber.com/">Beat Saber</a> with the desired settings.
+  </p>
 </div>
 
 <div align="center">
   <video src="https://github.com/Zagrios/bs-manager/assets/40648115/bfa1e97d-6392-4dec-a1fc-bb05048cf6d2" />
 </div>
 
-
 <!--
 ----------------------------------------
     DOWNLOAD AND INSTALLATION
@@ -384,79 +361,30 @@
   <hr>
   <h1><b>Download and Installation</b></h1>
 </div>
+
 <div>
-  <p><a href="https://github.com/Zagrios/bs-manager">BSManager</a> provides centralized and organized management of
-    beatmaps, mods, and models, integrating download features and sharing between <a href="https://beatsaber.com/">Beat
-      Saber</a> versions.</p>
+  <p><a href="https://github.com/Zagrios/bs-manager">BSManager</a> centralizes and simplifies the management of beatmaps, playlists, mods, and models, offering seamless downloads and sharing between different <a href="https://beatsaber.com/">Beat Saber</a> versions.</p>
 </div>
 
-<!--
-    MAPS
-----------------------------------------
--->
 <div>
-  <h2>Maps</h2>
-  <p><a href="https://github.com/Zagrios/bs-manager">BSManager</a> integrates the <a href="https://beatsaver.com">Beat
-      Saver</a> API to provide you with a comprehensive list of maps downloadable directly from its interface. Moreover,
-    the OneClick feature allows you to download maps with one click from various sources such as <a
-      href="https://beatsaver.com">Beat Saver</a>, <a href="https://bsaber.com">BeastSaber</a>, <a
-      href="https://scoresaber.com">ScoreSaber</a>, and <a href="https://www.beatleader.xyz">Beat Leader</a>. To add
-    maps, simply select the desired version or the "shared" tab, then click "ADD".</p>
+  <h2>Features</h2>
+  <p>With <a href="https://github.com/Zagrios/bs-manager">BSManager</a>, you can manage your:  
+  </p>
+  <ul>
+    <li><b>Maps:</b> Browse and download maps directly from sources like <a href="https://beatsaver.com">Beat Saver</a>, <a href="https://bsaber.com">BeastSaber</a>, <a href="https://scoresaber.com">ScoreSaber</a>, and <a href="https://www.beatleader.xyz">Beat Leader</a>.</li>
+    <li><b>Playlists:</b> Search for and download playlists directly from BSManager, just like maps. 😉
+    <li><b>Mods:</b> Manage and install mods via the "Mods" tab, offering the same features as Mod Assistant.</li>
+    <li><b>Models:</b> Add and manage models easily with the integration of the <a href="https://modelsaber.com">Model Saber</a> API.</li>
+  </ul>
+  <p>For detailed instructions on each feature, check the following guides:</p>
+  <ul>
+    <li>👉 <a href="https://github.com/Zagrios/bs-manager/wiki/install-any-map">Install Any Map</a></li>
+    <li>👉 <a href="https://github.com/Zagrios/bs-manager/wiki/install-all-playlists-you-want">Install Playlists</a></li>
+    <li>👉 <a href="https://github.com/Zagrios/bs-manager/wiki/install-mods-on-your-version">Install Mods</a></li>
+    <li>👉 <a href="https://github.com/Zagrios/bs-manager/wiki/modify-models-in-your-beat-saber">Manage Models</a></li>
+  </ul>
 </div>
 
-<div align="center">
-  <video src="https://github.com/Zagrios/bs-manager/assets/40648115/3f9f9968-ac55-465e-bc28-17aebfc787ea"/>
-
-</div>
-
-<!--
-    PLAYLISTS
-----------------------------------------
--->
-<div>
-  <h2>Playlists</h2>
-  <p>Although the playlist management interface is not yet developed, <a
-      href="https://github.com/Zagrios/bs-manager">BSManager</a> offers a OneClick feature for playlists from <a
-      href="https://beatsaver.com">Beat Saver</a>.</p>
-</div>
-
-<div align="center">
-  <video src="https://github.com/Zagrios/bs-manager/assets/40648115/733fe6bb-c157-4c47-8a79-f8062380bcc8" />
-</div>
-
-<!--
-    MODS
-----------------------------------------
--->
-<div>
-  <h2>Mods</h2>
-  <p>Manage your mods easily with <a href="https://github.com/Zagrios/bs-manager">BSManager</a>. After downloading a
-    version, navigate to the "Mods" tab of the selected version to manage and install mods. <a
-      href="https://github.com/Zagrios/bs-manager">BSManager</a> operates similarly to Mod Assistant and offers the same
-    mods as this tool.</p>
-</div>
-
-<div align="center">
-  <video src="https://github.com/Zagrios/bs-manager/assets/40648115/ca8f0727-b2dd-41f3-bbea-9bcaf61a89f1"/>
-
-</div>
-
-<!--
-    MODELS
-----------------------------------------
--->
-<div>
-  <h2>Models</h2>
-  <p>Add and manage models simply via the corresponding tab on the desired version or by going to the "shared" tab. The
-    <a href="https://modelsaber.com">Model Saber</a> API is integrated to provide easy and direct access to models
-    available for <a href="https://beatsaber.com/">Beat Saber</a>.</p>
-</div>
-
-<div align="center">
-  <video src="https://github.com/Zagrios/bs-manager/assets/40648115/d983b34b-9f4c-4274-aee4-4c1c03dd90d0"/>
-</div>
-
-
 <!--
 ----------------------------------------
     CUSTOMIZATION
@@ -487,7 +415,7 @@
   </ul>
 </div>
 
-<div align="center"> 
+<div align="center">
   <video src = "https://github.com/Zagrios/bs-manager/assets/40648115/d2c1b0ec-a2f5-41b5-99d5-c4c2cd34cbd4" />
 </div>
 
@@ -512,7 +440,6 @@
   <video src="https://github.com/Zagrios/bs-manager/assets/40648115/f66a2c99-770e-42ca-9a71-b1806946ad0c" />
 </div>
 
-
 <!--
 ----------------------------------------
     MORE INFORMATION
@@ -538,7 +465,6 @@
       GitHub</a>.</p>
 </div>
 
-
 <!--
     CREDITS
 ----------------------------------------
@@ -550,6 +476,8 @@
     <li><a href="https://github.com/Iluhadesu">Iluhadesu</a> - Co-Developer & Co-Founder, Discord Bot Developer.</li>
     <li><a href="https://github.com/GaetanGrd">GaetanGrd</a> - Co-Developer & Co-Founder, Documentation Lead.</li>
     <li><a href="https://github.com/cheddZy">cheddZy</a> - Icon Creator.</li>
+    <li><a href="https://github.com/Insprill">Insprill</a> - Co-Developer, Linux Developer, AUR Maintainer.</li>
+    <li><a href="https://github.com/silentrald">silentrald</a> - Co-Developer, Linux Developer, deb/rpm/flatpak Maintainer.</li>
   </ul>
 </div>
 
@@ -565,12 +493,11 @@
       href="https://github.com/Zagrios/bs-manager">BSManager</a>!</p>
   <div align="center">
     <a href="https://github.com/Zagrios/bs-manager/graphs/contributors">
-      <img src="https://contrib.rocks/image?repo=Zagrios/bs-manager" />
+      <img src="https://contrib.rocks/image?repo=Zagrios/bs-manager" alt="Contributor list" />
     </a>
   </div>
 </div>
 
-
 <!-- 
 ----------------------------------------
     Others

assets/jsons/bs-versions.json

@@ -598,8 +598,7 @@
 		"ReleaseURL": "https://steamcommunity.com/games/620980/announcements/detail/6169409105101272202",
 		"ReleaseImg": "https://cdn.akamai.steamstatic.com/steamcommunity/public/images/clans/32055887/c328e407367e9914abaf92f609501877ee5abb63.png",
 		"ReleaseDate": "1680623885",
-		"year": "2023",
-		"recommended": true
+		"year": "2023"
 	},
 	{
 		"BSVersion": "1.29.4",
@@ -681,5 +680,192 @@
 		"ReleaseImg": "https://clan.akamai.steamstatic.com/images/32055887/ae11d195bbe41a0f244d7b4d055a0ab89f88e5bb.png",
 		"ReleaseDate": "1702309893",
 		"year": "2023"
+	},
+	{
+		"BSVersion": "1.34.5",
+		"BSManifest": "7413405154512822201",
+		"OculusBinaryId": "6639053626194360",
+		"ReleaseURL": "https://steamcommunity.com/games/620980/announcements/detail/4036983137766828694",
+		"ReleaseImg": "https://clan.cloudflare.steamstatic.com/images/32055887/925e60f14c6815f7617fde11a894ed20f54a0846.png",
+		"ReleaseDate": "1707745958",
+		"year": "2024"
+	},
+	{
+		"BSVersion": "1.34.6",
+		"BSManifest": "4398761375819224126",
+		"OculusBinaryId": "6682206641879058",
+		"ReleaseURL": "https://store.steampowered.com/news/app/620980/view/7595953477644376720",
+		"ReleaseImg": "https://clan.cloudflare.steamstatic.com/images/32055887/e7c75bdfc76d00713adc3fbdf221c9ce8ab3620d.png",
+		"ReleaseDate": "1708091473",
+		"year": "2024"
+	},
+	{
+		"BSVersion": "1.35.0",
+		"BSManifest": "1490986193481243578",
+		"OculusBinaryId": "6720809361352119",
+		"ReleaseURL": "https://store.steampowered.com/news/app/620980/view/4142820264819707009",
+		"ReleaseImg": "https://clan.cloudflare.steamstatic.com/images//32055887/9a141be5c44ca6fc81551a2c7e7f28407df413ed.png",
+		"ReleaseDate": "1709831174",
+		"year": "2024"
+	},
+	{
+		"BSVersion": "1.36.0",
+		"BSManifest": "8533509040167838423",
+		"OculusBinaryId": "6863072637125790",
+		"ReleaseURL": "https://store.steampowered.com/news/app/620980/view/4205873192610459250",
+		"ReleaseImg": "https://clan.akamai.steamstatic.com/images//32055887/b8bd8a050e2bc3903cf18a277c5489ade01f7e75.png",
+		"ReleaseDate": "1712681263",
+		"year": "2024"
+	},
+	{
+		"BSVersion": "1.36.2",
+		"BSManifest": "4832237377879752064",
+		"OculusBinaryId": "6983660338400352",
+		"ReleaseURL": "https://store.steampowered.com/news/app/620980/view/4181105931135110118",
+		"ReleaseImg": "https://clan.cloudflare.steamstatic.com/images//32055887/74541417f14dee210bcfd89eefeabd7c0cc27c7d.png",
+		"ReleaseDate": "1715008020",
+		"year": "2024"
+	},
+	{
+		"BSVersion": "1.37.0",
+		"BSManifest": "7270690075584855288",
+		"OculusBinaryId": "7062062833893435",
+		"ReleaseURL": "https://store.steampowered.com/news/app/620980/view/4161968170153497460",
+		"ReleaseImg": "https://clan.akamai.steamstatic.com/images//32055887/f82d34c7582137a6748a28c5b02670ff4b235356.png",
+		"ReleaseDate": "1717513346",
+		"year": "2024"
+	},
+	{
+		"BSVersion": "1.37.1",
+		"BSManifest": "9129356330007601179",
+		"OculusBinaryId": "7313068492126200",
+		"ReleaseURL": "https://steamcommunity.com/games/620980/announcements/detail/4253168598913260422",
+		"ReleaseImg": "https://clan.akamai.steamstatic.com/images/32055887/039be718c1494f948257cd5b09f0082986484a58.png",
+		"ReleaseDate": "1720710529",
+		"year": "2024"
+	},
+	{
+		"BSVersion": "1.37.2",
+		"BSManifest": "6848299977215652352",
+		"OculusBinaryId": "7438773609555687",
+		"ReleaseURL": "https://steamcommunity.com/games/620980/announcements/detail/4349999161850643744",
+		"ReleaseImg": "https://clan.akamai.steamstatic.com/images/32055887/7c03af6d12fad23f1d439666d4be86b492d40003.png",
+		"ReleaseDate": "1722945814",
+		"year": "2024"
+	},
+	{
+		"BSVersion": "1.37.3",
+		"BSManifest": "5834150512217183366",
+		"OculusBinaryId": "7553569971409383",
+		"ReleaseURL": "https://steamcommunity.com/games/620980/announcements/detail/6808965920900622902",
+		"ReleaseImg": "https://clan.akamai.steamstatic.com/images/32055887/a1c9a6737cc5182fca8cddc7c8088eda6dd4d82d.png",
+		"ReleaseDate": "1724061712",
+		"year": "2024"
+	},
+	{
+		"BSVersion": "1.37.4",
+		"BSManifest": "7585106640515547731",
+		"OculusBinaryId": "7630971613669218",
+		"ReleaseURL": "https://steamcommunity.com/games/620980/announcements/detail/4601078012425941968",
+		"ReleaseImg": "https://clan.akamai.steamstatic.com/images/32055887/23e6e6f219a56d2f9ea4a27b560c54ac1214aec3.png",
+		"ReleaseDate": "1725548547",
+		"year": "2024"
+	},
+	{
+		"BSVersion": "1.37.5",
+		"BSManifest": "3122533396458693889",
+		"OculusBinaryId": "7685108391588873",
+		"ReleaseDate": "1725628356",
+		"year": "2024"
+	},
+	{
+		"BSVersion": "1.38.0",
+		"BSManifest": "3482902979520746178",
+		"OculusBinaryId": "7834818833284494",
+		"ReleaseURL": "https://steamcommunity.com/games/620980/announcements/detail/4669760442595134838",
+		"ReleaseImg": "https://clan.akamai.steamstatic.com/images/32055887/57cfa043407c091e67b7e0a8ae86fe5590deae33.png",
+		"ReleaseDate": "1728399815",
+		"year": "2024"
+	},
+	{
+		"BSVersion": "1.39.0",
+		"BSManifest": "5365094543246905054",
+		"OculusBinaryId": "7978663688900007",
+		"ReleaseURL": "https://steamcommunity.com/games/620980/announcements/detail/4451339035198095638",
+		"ReleaseImg": "https://clan.cloudflare.steamstatic.com/images/32055887/fd8e2c783e46decdf5e10fed1e16f124616d9321.png",
+		"ReleaseDate": "1731426932",
+		"year": "2024"
+	},
+	{
+		"BSVersion": "1.39.1",
+		"BSManifest": "2179614296547473280",
+		"OculusBinaryId": "8189133517853022",
+		"ReleaseURL": "https://steamcommunity.com/games/620980/announcements/detail/4451340304252928024",
+		"ReleaseDate": "1732107748",
+		"year": "2024"
+	},
+	{
+		"BSVersion": "1.40.0",
+		"BSManifest": "8455036253884215709",
+		"OculusBinaryId": "8259984977434542",
+		"ReleaseURL": "https://steamcommunity.com/games/620980/announcements/detail/507314379973199787",
+		"ReleaseImg": "https://clan.fastly.steamstatic.com/images/32055887/65df6b24c3b8a7f415080ac01394917cedabf9fc.png",
+		"ReleaseDate": "1733846128",
+		"year": "2024"
+	},
+	{
+		"BSVersion": "1.40.1",
+		"BSManifest": "8655702238937650396",
+		"OculusBinaryId": "8526525354113835",
+		"ReleaseURL": "https://steamcommunity.com/games/620980/announcements/detail/510696972023234581",
+		"ReleaseImg": "https://clan.fastly.steamstatic.com/images/32055887/5cc1ca353151ed31da2764716cdcbe89442aeeeb.png",
+		"ReleaseDate": "1738144954",
+		"year": "2025"
+	},
+	{
+		"BSVersion": "1.40.2",
+		"BSManifest": "5496832903170665287",
+		"OculusBinaryId": "8626990240734012",
+		"ReleaseURL": "https://steamcommunity.com/games/620980/announcements/detail/510697606000673692",
+		"ReleaseImg": "https://clan.fastly.steamstatic.com/images/32055887/04ad25256ffc2686f4ea19830e70df6b2752f728.png",
+		"ReleaseDate": "1738951837",
+		"year": "2025"
+	},
+	{
+		"BSVersion": "1.40.3",
+		"BSManifest": "2468336483467342711",
+		"OculusBinaryId": "8747607938672241",
+		"ReleaseURL": "https://steamcommunity.com/games/620980/announcements/detail/510699509433500685",
+		"ReleaseImg": "https://clan.fastly.steamstatic.com/images/32055887/648716b53c17412cd269567ce67d3867514b6acd.png",
+		"ReleaseDate": "1740672033",
+		"year": "2025"
+	},
+	{
+		"BSVersion": "1.40.4",
+		"BSManifest": "3323243802033113443",
+		"OculusBinaryId": "8889412401158460",
+		"ReleaseURL": "https://steamcommunity.com/games/620980/announcements/detail/510702041542166484",
+		"ReleaseImg": "https://clan.fastly.steamstatic.com/images/32055887/c27dac7f96e53672d020d97838cec1d5d28e3180.png",
+		"ReleaseDate": "1743515622",
+		"year": "2025"
+	},
+	{
+		"BSVersion": "1.40.5",
+		"BSManifest": "2447038720841508806",
+		"OculusBinaryId": "9120095564756808",
+		"ReleaseURL": "https://steamcommunity.com/games/620980/announcements/detail/502825275922317447",
+		"ReleaseImg": "https://clan.fastly.steamstatic.com/images/32055887/2b5845893d915902106aaf30b6d1a95f68a4b226.png",
+		"ReleaseDate": "1747321305",
+		"year": "2025"
+	},
+	{
+		"BSVersion": "1.40.6",
+		"BSManifest": "3050696685250334115",
+		"OculusBinaryId": "9315734585192904",
+		"ReleaseURL": "https://steamcommunity.com/games/620980/announcements/detail/510708375093248769",
+		"ReleaseImg": "https://clan.fastly.steamstatic.com/images/32055887/0f658ed39f480446e0dc5807b1591e8a18aef2f5.png",
+		"ReleaseDate": "1749135144",
+		"year": "2025",
+		"recommended": true
 	}
-]
+]

assets/jsons/patreons.json

@@ -1,21 +1,174 @@
 [
-    {"username": "Shidorien"},
-    {"username": "iPixelGalaxy"},
-    {"username": "Emyte", "type": "gold"},
-    {"username": "GoodOldNervy"},
-    {"username": "Naysy"},
-    {"username": "Falmil"},
-    {"username": "K1Lc4m"},
-    {"username": "Anonymously42", "type": "diamond", "link": "https://www.twitch.tv/anonymously42tv"},
-    {"username": "Burt", "type": "gold"},
-    {"username": "Ilnahro"},
-    {"username": "Phil", "type": "gold"},
-    {"username": "Protocrush", "type": "gold"},
-    {"username": "ServerMensch", "type": "gold"},
-    {"username": "Karlito", "type": "gold"},
-    {"username": "Cathery", "type": "gold"},
-    {"username": ".sharkey"},
-    {"username": "Z3t4"},
-    {"username": "blot455", "type": "diamond"},
-    {"username": "Lumberjack462", "type": "diamond", "link": "https://www.youtube.com/@lumberjack462"}
+	{
+		"username": "Shidorien"
+	},
+	{
+		"username": "iPixelGalaxy"
+	},
+	{
+		"username": "Emyte",
+		"type": "gold"
+	},
+	{
+		"username": "GoodOldNervy"
+	},
+	{
+		"username": "Naysy"
+	},
+	{
+		"username": "Falmil"
+	},
+	{
+		"username": "Anonymously42",
+		"type": "diamond",
+		"link": "https://www.twitch.tv/anonymously42tv"
+	},
+	{
+		"username": "Burt",
+		"type": "gold"
+	},
+	{
+		"username": "Phil",
+		"type": "gold"
+	},
+	{
+		"username": "Protocrush",
+		"type": "gold"
+	},
+	{
+		"username": "Karlito",
+		"type": "gold"
+	},
+	{
+		"username": ".sharkey"
+	},
+	{
+		"username": "Z3t4"
+	},
+	{
+		"username": "blot455",
+		"type": "diamond"
+	},
+	{
+		"username": "Lumberjack462",
+		"type": "diamond",
+		"link": "https://www.youtube.com/@lumberjack462"
+	},
+	{
+		"username": "Xero"
+	},
+	{
+		"username": "Minescence"
+	},
+	{
+		"username": "mereknom"
+	},
+	{
+		"username": "Jascha"
+	},
+	{
+		"username": "Celldweller",
+		"type": "gold"
+	},
+	{
+		"username": "rhythmshade"
+	},
+	{
+		"username": "liborsaf"
+	},
+	{
+		"username": "aatame3",
+		"type": "gold"
+	},
+	{
+		"username": "Joshua"
+	},
+	{
+		"username": "Stuijvi",
+		"type": "gold"
+	},
+	{
+		"username": "_ monaka"
+	},
+	{
+		"username": "Better_Axel"
+	},
+	{
+		"username": "Riley",
+		"type": "gold"
+	},
+	{
+		"username": "Austin"
+	},
+	{
+		"username": "Fatalution",
+		"type": "diamond",
+		"link": "https://x.com/fatalution"
+	},
+	{
+		"username": "Taurus Arcade",
+		"type": "gold"
+	},
+	{
+		"username": "Mozz_Zm"
+	},
+	{
+		"username": "clapxz"
+	},
+    {
+		"username": "Reflected Chop",
+		"type": "gold"
+	},
+    {
+		"username": "Furiouspupa"
+	},
+    {
+		"username": "Maximilian"
+	},
+    {
+		"username": "Paul Smith"
+	},
+    {
+		"username": "MunityVR",
+		"type": "gold"
+	},
+    {
+		"username": "Sk4venger"
+	},
+    {
+		"username": "Alexander Herman",
+		"type": "gold"
+	},
+    {
+		"username": "Arts Rimuro Suraimu",
+		"type": "gold"
+	},
+    {
+		"username": "Ricardo Boss"
+	},
+    {
+		"username": "Jesper Norsted"
+	},
+    {
+        "username": "Marcus Hamm"
+    },
+    {
+		"username": "jxkelol"
+	},
+    {
+        "username": "paperwasp",
+        "type": "gold"
+    },
+    {
+        "username": "KingCrocman",
+        "type": "diamond",
+        "link": "https://www.youtube.com/KingCrocman"
+    },
+    {
+        "username": "bosspie",
+        "type": "diamond"
+    },
+    {
+        "username": "Camryn Jackson"
+    }
 ]

assets/proto/song_details_cache_v1.proto

@@ -0,0 +1,127 @@
+syntax = "proto3";
+
+package song_details_cache_v1;
+
+message SongDetailsCache {
+  repeated SongDetails songs = 1;
+  uint32 lastUpdated = 2;
+  uint32 total = 3;
+  UploadersList uploaders = 4;
+  repeated string difficultyLabels = 5;
+}
+
+message UploadersList {
+  repeated string names = 1;
+  repeated uint32 ids = 2;
+}
+
+message SongDetails {
+  uint32 idInt = 1;
+  repeated uint32 hashIndices = 2;
+  string name = 3;
+  uint32 duration = 4;
+  UploaderRef uploaderRef = 5;
+  uint32 uploadedAt = 6;
+  repeated MapTag tags = 7;
+  bool ranked = 8;
+  bool qualified = 9;
+  bool curated = 10;
+  bool blRanked = 11;
+  bool blQualified = 12;
+  uint32 upVotes = 13;
+  uint32 downVotes = 14;
+  uint32 downloads = 15;
+  bool automapper = 16;
+  repeated Difficulty difficulties = 17;
+}
+
+message Difficulty {
+  DifficultyLabel difficulty = 1;
+  DifficultyCharacteristic characteristic = 2;
+  uint32 labelIndex = 3;
+  uint32 starsT100 = 4;
+  uint32 starsBlT100 = 5;
+  uint32 njsT100 = 6;
+  uint32 npsT100 = 7;
+  int32 offsetT100 = 8;
+  bool chroma = 9;
+  bool cinema = 10;
+  bool me = 11;
+  bool ne = 12;
+  uint32 bombs = 13;
+  uint32 notes = 14;
+  uint32 obstacles = 15;
+}
+
+message UploaderRef {
+  uint32 uploader_ref_index = 1;
+  bool verified = 2;
+}
+
+enum DifficultyLabel {
+  UNKNOWN_LABEL = 0; // Default value for undefined/unknown labels
+  EASY = 1;
+  NORMAL = 2;
+  HARD = 3;
+  EXPERT = 4;
+  EXPERT_PLUS = 5;
+}
+
+enum DifficultyCharacteristic {
+  UNKNOWN_CHARACTERISTIC = 0; // Default value for undefined/unknown characteristics
+  STANDARD = 1;
+  ONE_SABER = 2;
+  NO_ARROWS = 3;
+  LAWLESS = 4;
+  LIGHTSHOW = 5;
+  LEGACY = 6;
+  NINETY_DEGREE = 7;
+  THREESIXTY_DEGREE = 8;
+}
+
+enum MapTag {
+  UNKNOWN_TAG = 0; // Default value for undefined/unknown tags
+  DANCE = 1;
+  SWING = 2;
+  NIGHTCORE = 3;
+  FOLK = 4;
+  FAMILY = 5;
+  AMBIENT = 6;
+  FUNK = 7;
+  JAZZ = 8;
+  SOUL = 9;
+  SPEEDCORE = 10;
+  PUNK = 11;
+  RB = 12;
+  HOLIDAY = 13;
+  VOCALOID = 14;
+  J_ROCK = 15;
+  TRANCE = 16;
+  DRUMBASS = 17;
+  COMEDY = 18;
+  INSTRUMENTAL = 19;
+  HARDCORE = 20;
+  K_POP = 21;
+  INDIE = 22;
+  TECHNO = 23;
+  HOUSE = 24;
+  GAME = 25;
+  FILM = 26;
+  ALT = 27;
+  DUBSTEP = 28;
+  METAL = 29;
+  ANIME = 30;
+  HIPHOP = 31;
+  J_POP = 32;
+  ROCK = 33;
+  POP = 34;
+  ELECTRONIC = 35;
+  CLASSICAL_ORCHESTRAL = 36;
+  ACCURACY = 37;
+  BALANCED = 38;
+  CHALLENGE = 39;
+  DANCESTYLE = 40;
+  FITNESS = 41;
+  SPEED = 42;
+  TECH = 43;
+}

assets/scripts/depot-downloader/DepotDownloader.deps.json

@@ -1,166 +0,0 @@
-{
-  "runtimeTarget": {
-    "name": ".NETCoreApp,Version=v6.0",
-    "signature": ""
-  },
-  "compilationOptions": {},
-  "targets": {
-    ".NETCoreApp,Version=v6.0": {
-      "DepotDownloader/2.5.0": {
-        "dependencies": {
-          "QRCoder": "1.4.3",
-          "SteamKit2": "2.5.0-Beta.1",
-          "protobuf-net": "3.2.16"
-        },
-        "runtime": {
-          "DepotDownloader.dll": {}
-        }
-      },
-      "Microsoft.NETCore.Platforms/5.0.0": {},
-      "Microsoft.Win32.Registry/5.0.0": {
-        "dependencies": {
-          "System.Security.AccessControl": "5.0.0",
-          "System.Security.Principal.Windows": "5.0.0"
-        }
-      },
-      "protobuf-net/3.2.16": {
-        "dependencies": {
-          "protobuf-net.Core": "3.2.16"
-        },
-        "runtime": {
-          "lib/net6.0/protobuf-net.dll": {
-            "assemblyVersion": "3.0.0.0",
-            "fileVersion": "3.2.16.54102"
-          }
-        }
-      },
-      "protobuf-net.Core/3.2.16": {
-        "dependencies": {
-          "System.Collections.Immutable": "7.0.0"
-        },
-        "runtime": {
-          "lib/net6.0/protobuf-net.Core.dll": {
-            "assemblyVersion": "3.0.0.0",
-            "fileVersion": "3.2.16.54102"
-          }
-        }
-      },
-      "QRCoder/1.4.3": {
-        "runtime": {
-          "lib/net6.0/QRCoder.dll": {
-            "assemblyVersion": "1.4.3.0",
-            "fileVersion": "1.4.3.0"
-          }
-        }
-      },
-      "SteamKit2/2.5.0-Beta.1": {
-        "dependencies": {
-          "Microsoft.Win32.Registry": "5.0.0",
-          "protobuf-net": "3.2.16"
-        },
-        "runtime": {
-          "lib/net6.0/SteamKit2.dll": {
-            "assemblyVersion": "2.5.0.0",
-            "fileVersion": "2.5.0.0"
-          }
-        }
-      },
-      "System.Collections.Immutable/7.0.0": {
-        "dependencies": {
-          "System.Runtime.CompilerServices.Unsafe": "6.0.0"
-        },
-        "runtime": {
-          "lib/net6.0/System.Collections.Immutable.dll": {
-            "assemblyVersion": "7.0.0.0",
-            "fileVersion": "7.0.22.51805"
-          }
-        }
-      },
-      "System.Runtime.CompilerServices.Unsafe/6.0.0": {},
-      "System.Security.AccessControl/5.0.0": {
-        "dependencies": {
-          "Microsoft.NETCore.Platforms": "5.0.0",
-          "System.Security.Principal.Windows": "5.0.0"
-        }
-      },
-      "System.Security.Principal.Windows/5.0.0": {}
-    }
-  },
-  "libraries": {
-    "DepotDownloader/2.5.0": {
-      "type": "project",
-      "serviceable": false,
-      "sha512": ""
-    },
-    "Microsoft.NETCore.Platforms/5.0.0": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-VyPlqzH2wavqquTcYpkIIAQ6WdenuKoFN0BdYBbCWsclXacSOHNQn66Gt4z5NBqEYW0FAPm5rlvki9ZiCij5xQ==",
-      "path": "microsoft.netcore.platforms/5.0.0",
-      "hashPath": "microsoft.netcore.platforms.5.0.0.nupkg.sha512"
-    },
-    "Microsoft.Win32.Registry/5.0.0": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-dDoKi0PnDz31yAyETfRntsLArTlVAVzUzCIvvEDsDsucrl33Dl8pIJG06ePTJTI3tGpeyHS9Cq7Foc/s4EeKcg==",
-      "path": "microsoft.win32.registry/5.0.0",
-      "hashPath": "microsoft.win32.registry.5.0.0.nupkg.sha512"
-    },
-    "protobuf-net/3.2.16": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-W6RM2B2f5O7SigBGfkXFYzI/a7Mks+rCHtuGlE/b5O3NMupDon7I0akjCLhrfcnqIfdWDkDafseav/MnIzUSHA==",
-      "path": "protobuf-net/3.2.16",
-      "hashPath": "protobuf-net.3.2.16.nupkg.sha512"
-    },
-    "protobuf-net.Core/3.2.16": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-ZFoY0lfMUWGJ4RoyI0oNj2o2l8t08n3k27YyDD0kYWQ+vXj0hTbWEwYWOpGAfCWvyUPkq9Jcc/4uR74GICZL2g==",
-      "path": "protobuf-net.core/3.2.16",
-      "hashPath": "protobuf-net.core.3.2.16.nupkg.sha512"
-    },
-    "QRCoder/1.4.3": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-fWuFqjm8GTlEb2GqBl3Hi8HZZeZQwBSHxvRPtPjyNbT82H0ff0JwavKRBmMaXCno1Av6McPC8aJzri0Mj2w9Jw==",
-      "path": "qrcoder/1.4.3",
-      "hashPath": "qrcoder.1.4.3.nupkg.sha512"
-    },
-    "SteamKit2/2.5.0-Beta.1": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-fwwdF0cZZEIdNpcUc1+B9zbP5Q48A3DFOAclPhBh2dMTU03aROaIDktFW+Ww/NN1Z/Emp/LwVqHB+hCM8uxS4Q==",
-      "path": "steamkit2/2.5.0-beta.1",
-      "hashPath": "steamkit2.2.5.0-beta.1.nupkg.sha512"
-    },
-    "System.Collections.Immutable/7.0.0": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-dQPcs0U1IKnBdRDBkrCTi1FoajSTBzLcVTpjO4MBCMC7f4pDOIPzgBoX8JjG7X6uZRJ8EBxsi8+DR1JuwjnzOQ==",
-      "path": "system.collections.immutable/7.0.0",
-      "hashPath": "system.collections.immutable.7.0.0.nupkg.sha512"
-    },
-    "System.Runtime.CompilerServices.Unsafe/6.0.0": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-/iUeP3tq1S0XdNNoMz5C9twLSrM/TH+qElHkXWaPvuNOt+99G75NrV0OS2EqHx5wMN7popYjpc8oTjC1y16DLg==",
-      "path": "system.runtime.compilerservices.unsafe/6.0.0",
-      "hashPath": "system.runtime.compilerservices.unsafe.6.0.0.nupkg.sha512"
-    },
-    "System.Security.AccessControl/5.0.0": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-dagJ1mHZO3Ani8GH0PHpPEe/oYO+rVdbQjvjJkBRNQkX4t0r1iaeGn8+/ybkSLEan3/slM0t59SVdHzuHf2jmw==",
-      "path": "system.security.accesscontrol/5.0.0",
-      "hashPath": "system.security.accesscontrol.5.0.0.nupkg.sha512"
-    },
-    "System.Security.Principal.Windows/5.0.0": {
-      "type": "package",
-      "serviceable": true,
-      "sha512": "sha512-t0MGLukB5WAVU9bO3MGzvlGnyJPgUlcwerXn1kzBRjwLKixT96XV0Uza41W49gVd8zEMFu9vQEFlv0IOrytICA==",
-      "path": "system.security.principal.windows/5.0.0",
-      "hashPath": "system.security.principal.windows.5.0.0.nupkg.sha512"
-    }
-  }
-}

assets/scripts/depot-downloader/DepotDownloader.runtimeconfig.json

@@ -1,13 +0,0 @@
-{
-  "runtimeOptions": {
-    "tfm": "net6.0",
-    "rollForward": "LatestMajor",
-    "framework": {
-      "name": "Microsoft.NETCore.App",
-      "version": "6.0.0"
-    },
-    "configProperties": {
-      "System.Reflection.Metadata.MetadataUpdater.IsSupported": false
-    }
-  }
-}

build/after-install.sh

@@ -0,0 +1,2 @@
+# https://github.com/electron/electron/issues/42510
+/usr/bin/chmod 4755 /opt/BSManager/chrome-sandbox

docs/wiki/Guides/Content-Management/Maps/Install-all-playlists-you-want/Install-all-playlists-you-want.md

@@ -0,0 +1,60 @@
+## Table of Contents
+
+- [With BSManager](#with-bsmanager)
+    - [Install playlists](#how-to-install-playlists-with-bsmanager)
+    - [Import playlists](#how-to-import-playlist-with-bsmanager)
+- [Manual Installation](#manual-installation)
+- [One-Click Installation](#one-click-installation)
+
+## With BSManager
+
+### How to Install Playlists with BSManager  
+
+1. Download and install [BSManager](https://www.bsmanager.io) from one of the following sources:  
+    - [GitHub](https://github.com/Zagrios/bs-manager/releases/latest)
+    - [Official Website](https://www.bsmanager.io)  
+    - [Nexus Mods](https://www.nexusmods.com/beatsaber/mods/18?tab=files)
+2. Launch BSManager and select the version of *Beat Saber* where you want to install playlists from the list on the left side of the interface.  
+3. Go to the `Playlist` section by clicking on the __`Maps`__ tab.
+4. Click the __`Add`__ button, then select __`Browse playlist`__ to open the list of online playlists.  
+5. Use the search bar at the top of the interface to filter playlists or sort the list.  
+6. Download to install it.
+7. Wait for the installation to complete. Once it's finished, you can launch Beat Saber directly from [BSManager](https://www.bsmanager.io) and enjoy your new playlists!
+
+> [!NOTE]  
+> You can click on a playlist's image to view the maps it contains and download only the maps you want.
+
+### How to Import Playlist with BSManager
+
+1. Download and install [BSManager](https://www.bsmanager.io) from one of the following sources:  
+    - [GitHub](https://github.com/Zagrios/bs-manager/releases/latest)
+    - [Official Website](https://www.bsmanager.io)  
+    - [Nexus Mods](https://www.nexusmods.com/beatsaber/mods/18?tab=files)
+2. Launch BSManager and select the version of *Beat Saber* where you want to install playlists from the list on the left side of the interface.  
+3. Go to the `playlist` section by clicking on the __`Maps`__ tab.  
+4. From here, there are two possible methods:  
+   1. Click the __`Add`__ button, then select __`Import a playlist`__ and choose the file to import.  
+   2. Drag and drop your file directly onto the playlist interface in BSManager.  
+5. Wait for the import to complete. Once finished, you can launch Beat Saber directly from [BSManager](https://www.bsmanager.io) and enjoy your new playlists!  
+
+> [!Important]
+> The file must be in `.bplist` or `.json` format to be imported.  
+
+## Manual Installation
+
+1. Download your preferred custom playlists from trusted sources. Ensure that they are in __`.bplist`__ format.
+2. Open [BSManager](https://www.bsmanager.io) and select the version of Beat Saber in which you want to install the playlist.
+3. Click on the version options at the top-right corner of the BSM interface, then select __`Open Folder`__.
+4. In the folder for the Beat Saber version, locate the __`Playlists`__ folder. If this folder doesn't exist, create it.
+5. Copy and paste the downloaded __`.bplist`__ files of your custom playlists into this folder.
+6. Launch the game with BSM, navigate to your playlist, click on it, and download it.
+
+> [!WARNING]  
+> Exercise caution when downloading custom playlists for Beat Saber. Only use reliable sources to avoid any risks to your computer.
+
+## One-Click Installation
+
+1. Launch [BSManager](https://www.bsmanager.io) and make sure that the One-Click installation feature is enabled for playlists.
+2. Go to one of the supported websites and search for the playlist you want to install.
+3. Once you've found the playlist, click on the __`One-Click`__ or __`Install`__ button on the website.
+4. A pop-up window will appear, asking for confirmation. Click on __`Yes`__ to proceed with the installation.

docs/wiki/Guides/Content-Management/Maps/Install-any-map/Install-any-map.md

@@ -0,0 +1,55 @@
+## Table of Contents
+
+- [With BSManager](#with-bsmanager)
+    - [Install maps](#how-to-install-maps-with-bsmanager)
+    - [Import maps](#how-to-import-maps-with-bsmanager)
+- [Manual Installation](#manual-installation)
+- [One-Click Installation](#one-click-installation)
+
+## With BSManager
+
+### How to Install Maps with BSManager
+
+1. Download and install [BSManager](https://www.bsmanager.io) from one of the following sources:  
+    - [GitHub](https://github.com/Zagrios/bs-manager/releases/latest)
+    - [Official Website](https://www.bsmanager.io)  
+    - [Nexus Mods](https://www.nexusmods.com/beatsaber/mods/18?tab=files)
+2. Launch BSManager and select the version of *Beat Saber* where you want to install maps from the list on the left side of the interface.  
+3. Go to the `Maps` section by clicking on the __`Maps`__ tab.  
+4. Click the __`Add`__ button to access the list of online maps.  
+5. Use the search bar at the top of the interface to filter maps by __`name`__, __`type`__, __`mods`__, __`tags`__, __`notes per second`__, or __`duration`__, and order the list by __`latest`__, __`relevance`__, __`rating`__, or __`curated`__.  
+6. Download to install it.  
+7. Wait for the installation to complete. Once it's finished, you can launch Beat Saber directly from [BSManager](https://www.bsmanager.io) to enjoy your new maps!  
+
+### How to Import Maps with BSManager
+
+1. Download and install [BSManager](https://www.bsmanager.io) from one of the following sources:  
+    - [GitHub](https://github.com/Zagrios/bs-manager/releases/latest)
+    - [Official Website](https://www.bsmanager.io)  
+    - [Nexus Mods](https://www.nexusmods.com/beatsaber/mods/18?tab=files)
+2. Launch BSManager and select the version of *Beat Saber* where you want to install maps from the list on the left side of the interface.  
+3. Go to the `Maps` section by clicking on the __`Maps`__ tab.  
+4. From here, there are two possible methods:  
+   1. Click the __`Add`__ button, then select __`Import maps`__ and choose the .zip file to import.  
+   2. Drag and drop your .zip file directly onto the maps interface in BSManager.  
+5. Wait for the import to complete. Once finished, you can launch Beat Saber directly from [BSManager](https://www.bsmanager.io) to enjoy your new maps!  
+
+> [!Important]
+> The file must be in `.zip` format to be imported.
+
+## Manual Installation
+
+1. Find the map you want to install on a site like [BeatSaver](https://beatsaver.com).
+2. Download the map to your computer.
+3. Open [BSManager](https://www.bsmanager.io) and select the version of Beat Saber to which you want to install the map.
+4. Click on the version options at the top-right corner of the interface, then select __`Open Folder`__.
+5. Move the downloaded map `.zip` file into the __`CustomLevels`__ folder, which is located at `Beat Saber_Data\CustomLevels`.
+6. Right-click the `.zip` file, select __`Extract All`__, then press __`Extract`__ in the popup. You can then delete the `.zip` file.
+7. Launch Beat Saber, and the map should now be available to play.
+
+## One-Click Installation
+
+1. Launch [BSManager](https://www.bsmanager.io) and make sure that the One-Click installation feature is enabled for maps.
+2. Go to one of the supported websites and search for the map you want to install.
+3. Once you've found the map, click on the __`One-Click`__ or __`Install`__ button on the website.
+4. A pop-up window will appear, asking for confirmation. Click on __`Yes`__ to proceed with the installation.

docs/wiki/Guides/Content-Management/Models/Modify-models-in-your-beat-saber/Modify-models-in-your-beat-saber.md

@@ -0,0 +1,33 @@
+> [!WARNING]  
+>
+> __The models require mods to work properly! Don’t forget to download them!__
+>
+> - For custom sabers, use [CustomSabersLite](https://github.com/qqrz997/CustomSabersLite) or an equivalent mod.
+> - For custom avatars, use [Custom Avatars](https://github.com/nicoco007/BeatSaberCustomAvatars) or an equivalent mod.
+> - For custom blocks, use [Custom Notes](https://github.com/legoandmars/BeatSaberCustomNotes) or an equivalent mod.
+> - For custom platforms, use [Custom Platforms](https://github.com/affederaffe/CustomPlatforms) or an equivalent mod.
+
+## Table of Contents
+
+- [With BSManager](#with-bsmanager)
+- [One-Click Installation](#one-click-installation)
+
+## With BSManager
+
+1. Download and install [BSManager](https://www.bsmanager.io) from one of the following sources:  
+    - [GitHub](https://github.com/Zagrios/bs-manager/releases/latest)
+    - [Official Website](https://www.bsmanager.io)  
+    - [Nexus Mods](https://www.nexusmods.com/beatsaber/mods/18?tab=files)
+2. Launch [BSManager](https://www.bsmanager.io) and select the Beat Saber version where you want to install models from the list on the left of the interface.
+3. Go to models by clicking on the __`Models`__ tab.
+4. Click on the __`Add`__ button to access the list of online models.
+5. Find the models that you want to install from the provided list. You can use the search bar at the top of the interface to filter models by __`name`__, __`type`__, and order the list by __`date`__, __`name`__, or __`author`__.
+6. Download to install the model.
+7. Wait for the installation to complete. Once it's finished, you can launch Beat Saber directly from [BSManager](https://www.bsmanager.io) to enjoy your new models!
+
+## One-Click Installation
+
+1. Launch [BSManager](https://www.bsmanager.io) and make sure that the One-Click installation feature is enabled for models.
+2. Go to one of the supported websites and search for the models you want to install.
+3. Once you've found the models, click on the __`One-Click`__ or __`Install`__ button on the website.
+4. A pop-up window will appear, asking for confirmation. Click on __`Yes`__ to proceed with the installation.

docs/wiki/Guides/Content-Management/Mods/Install-mods-on-your-version/install-mods-on-your-version.md

@@ -0,0 +1,61 @@
+## Table of Contents
+
+- [With BSManager](#with-bsmanager)
+    - [Install mods](#how-to-install-mods-with-bsmanager)
+    - [Import mods](#how-to-import-mods-with-bsmanager)
+- [Manual Installation](#manual-installation)
+
+## With BSManager
+
+### How to Install Mods with BSManager
+
+1. Download and install [BSManager](https://www.bsmanager.io) from one of the following sources:  
+   - [GitHub](https://github.com/Zagrios/bs-manager/releases/latest)  
+   - [Nexus Mods](https://www.nexusmods.com/beatsaber/mods/18?tab=files)  
+   - [Official Website](https://www.bsmanager.io)
+2. Launch [BSManager](https://www.bsmanager.io) and select the version of Beat Saber that you want to use from the list on the left side of the interface.
+3. Go to mods by clicking on the __`Mods`__ tab.
+4. Find the mods that you want to install from the provided list. You can use the search bar at the top of the interface to filter mods by name.
+5. Check the box next to the name of each mod that you want to install.
+6. Click __`Install or Update`__ at the bottom-right corner of the interface.
+7. Wait for the installation to complete. Once it's finished, you can launch Beat Saber directly from [BSManager](https://www.bsmanager.io) to enjoy your new mods!
+
+### How to Import Mods with BSManager
+
+1. Download and install [BSManager](https://www.bsmanager.io) from one of the following sources:  
+    - [GitHub](https://github.com/Zagrios/bs-manager/releases/latest)
+    - [Official Website](https://www.bsmanager.io)  
+    - [Nexus Mods](https://www.nexusmods.com/beatsaber/mods/18?tab=files)
+2. Launch BSManager and select the version of *Beat Saber* where you want to install mods from the list on the left side of the interface.  
+3. Go to the `Mods` tab.  
+4. From here, there are two possible methods:  
+   1. Click on __`⁝`__ button, then select __`Import mods`__ and choose the .zip or .dll file to import.  
+   2. Drag and drop your .zip or .dll file directly onto the mods interface in BSManager.  
+5. Wait for the import to complete. Once finished, you can launch Beat Saber directly from [BSManager](https://www.bsmanager.io) to enjoy your new mods!  
+
+> [!Important]
+> The file must be in `.zip` or `.dll` format to be imported.
+
+## Manual Installation
+
+> [!IMPORTANT]
+> This guide assumes your game already has core mods installed
+>
+> If it doesn't: open [BSManager](https://www.bsmanager.io), select the game version you want to mod, go to the Mods tab, and click __`Install or Update`__. Then, run your game once, go to the main menu, and close it. ℹ️*
+
+1. Open [BSManager](https://www.bsmanager.io) and select the version of Beat Saber you want to install the mod to.
+2. Click on the version options button at the top-right corner, then select __`Open Folder`__.
+3. Download the desired mod from a trusted source, often found on community GitHub repositories. Search for the mod's name followed by "GitHub" in your search engine.
+4. Installing Different Types of Mods:
+    - __For mods that come as a single `.dll` file:__ If the mod consists of a single __`.dll`__ file, copy this file into the __`Plugins`__ folder in the directory you opened in step 2.
+
+        > [!NOTE]
+        >
+        > Do __not__ place files in __`Beat Saber_Data\Plugins`__. If you do not see a __`Plugins`__ folder directly in the folder you opened in step 2, make sure you have core mods installed and have run your game at least once after installing mods.
+
+    - __For mods that come as a `.zip` file:__ If the mod includes multiple files or folders, you need to maintain the provided folder structure. Double-click the zip file to open it, press __`CTRL+A`__ and then __`CTRL+C`__ to copy all files/folders inside the zip, go to the directory you opened in step 2, and press __`CTRL+V`__ to paste them there. Do __not__ paste them in any subfolder, such as __`Plugins`__ or __`Beat Saber_Data`__. If you are prompted to merge folders or overwrite files, click "Yes."
+
+5. The mod should now be installed. Run Beat Saber to check if the mod functions correctly. If it doesn't, double-check that you:
+    - Have all required dependencies installed. These are typically listed somewhere on the mod's release page.
+    - Placed the mod in the correct install folder.
+    - Downloaded a mod intended for your game version.

docs/wiki/Guides/Contribution/Help-us-update-the-wiki/help-us-update-the-wiki.md

@@ -0,0 +1,58 @@
+## Table of Contents
+
+- [Introduction](#introduction)
+- [Prerequisites](#prerequisites)
+- [Steps to Contribute](#steps-to-contribute)
+    - [1. Create a Fork on GitHub](#1-create-a-fork-on-github)
+    - [2. Clone Your Fork](#2-clone-your-fork)
+    - [3. Make Your Changes](#3-make-your-changes)
+    - [4. Submit a Pull Request](#4-submit-a-pull-request)
+
+## Introduction
+
+Thank you for your interest in improving the wiki! This guide will help you through the process of contributing, whether you’re adding new pages, fixing errors, or enhancing existing content.
+
+## Prerequisites
+
+Before contributing, make sure you have:
+
+1. A GitHub account.
+2. Basic knowledge of Markdown.
+
+## Steps to Contribute
+
+### 1. Create a Fork on GitHub
+
+To contribute, start by creating a fork of the repository:
+
+1. Go to the [GitHub page of the repository](https://github.com/Zagrios/bs-manager).
+2. Click on the __`Fork`__ button in the top-right corner of the page.
+3. Once the fork is created, it will appear under your GitHub account.
+
+### 2. Clone Your Fork
+
+Now, clone your fork to your local machine for editing:
+
+```bash
+git clone https://github.com/[your-username]/[repository-name].git
+cd [repository-name]
+```
+
+### 3. Make Your Changes
+
+Make edits, add new pages, or update content as needed. Then commit and push your changes to your fork:
+
+```bash
+git add .
+git commit -m "Describe your changes here"
+git push origin master
+```
+
+### 4. Submit a Pull Request
+
+Once your changes are ready:
+
+1. Go to the __[original repository](https://github.com/Zagrios/bs-manager)__ on GitHub.
+2. Click the __`Pull Requests`__ tab, then __`New Pull Request`__.
+3. Compare changes between your fork and the original repository.
+4. Add a clear description of your changes and submit the pull request.

docs/wiki/Guides/Installation-and-updates/Create-a-shortcut/Create-a-shortcut.md

@@ -0,0 +1,46 @@
+## Table of Contents
+
+- [How to create a shortcut on Windows](#how-to-create-a-shortcut-on-windows)
+    - [On desktop](#on-desktop)
+    - [On taskbar](#on-taskbar)
+- [How to create a shortcut on Steam](#how-to-create-a-shortcut-on-steam)
+
+## How to create a shortcut on Windows
+
+### On Desktop
+
+1. Launch [BSManager](https://www.bsmanager.io) and select your version.
+2. Click on the gear icon at the top-right corner of the version.
+3. Click on the __`Create a Shortcut`__ button.
+4. Choose your launch options.
+5. Click on __`Create a Shortcut`__. It should now appear on your desktop.
+
+<div align="center">
+    <img src="../wiki/Guides/Installation-and-updates/Create-a-shortcut/BsmShortcutInterface.png" alt="SeeTxtFile.png" />
+</div>
+
+### On Taskbar
+
+1. Open Notepad and drag & drop the version shortcut you need.
+2. Grab the version link (e.g., `bsmanager://launch/?version=1.34.2&versionIno=19140298416807704`) - More info [here](#how-to-create-a-shortcut-on-steam).
+3. Open a new Notepad window and type the following:
+
+```bat
+@echo off
+start <version link>
+```
+
+4. Save the file with a `.bat` extension.
+5. Create a shortcut to this `.bat` file. Edit the shortcut path to: `cmd.exe /C <shortcut path>`.
+
+## How to create a shortcut on Steam
+
+1. Launch [BSManager](https://www.bsmanager.io) and select your version.
+2. Click on the gear icon at the top-right corner of the version.
+3. Click on the __`Create a Shortcut`__ button.
+4. Choose your launch options.
+5. Click on __`Create a Shortcut`__. It should now appear on your desktop.
+
+<div align="center">
+    <img src="../wiki/Guides/Installation-and-updates/Create-a-shortcut/SteamShortcutCheck.png" alt="SeeTxtFile.png" />
+</div>

docs/wiki/Guides/Installation-and-updates/Install-or-import-a-version/Install-or-import-a-version.md

@@ -0,0 +1,70 @@
+> [!WARNING]  
+>
+> [BSManager](https://www.bsmanager.io) does not store your login information. It uses the open-source tool [`DepotDownloader`](https://github.com/SteamRE/DepotDownloader) to download versions of Beat Saber.
+
+## Table of Contents
+
+- [Install a Version with Steam](#install-a-version-with-steam)
+- [Install a Version with Oculus Store (PCVR)](#install-a-version-with-oculus-store-pcvr)
+- [Import a Version](#how-to-import-a-version)
+
+## Install a Version with Steam
+
+1. Download and install [BSManager](https://www.bsmanager.io) from one of the following sources:  
+    - [GitHub](https://github.com/Zagrios/bs-manager/releases/latest)
+    - [Official Website](https://www.bsmanager.io)  
+    - [Nexus Mods](https://www.nexusmods.com/beatsaber/mods/18?tab=files)
+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.
+
+<div align="center">
+    <img src="../wiki/Guides/Installation-and-updates/Install-or-import-a-version/SteamLogin.png" alt="SteamLogin.png" />
+</div>
+
+## 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 one of the following sources:  
+    - [GitHub](https://github.com/Zagrios/bs-manager/releases/latest)
+    - [Official Website](https://www.bsmanager.io)  
+    - [Nexus Mods](https://www.nexusmods.com/beatsaber/mods/18?tab=files)
+2. Open the __`Add Versions`__ interface and select the version you wish to download.
+3. Choose __`Oculus Store`__ as your platform.
+4. Click on __`Connect to Meta`__ or __`Enter my login token manually`__ based on your preferred login method.
+
+### If you selected __`Connect to Meta`__
+
+1. You will be redirected to the Oculus website. Enter your email and follow the instructions to log in.  
+2. Once logged in, the download will start automatically. Please wait for it to complete.  
+3. When the download finishes, select the downloaded version and click the __`Launch`__ button to verify that the game launches correctly.
+
+### If you selected __`Enter my login token manually`__
+
+1. Follow [this guide](How-to-obtain-your-Oculus-Token) to obtain your Oculus token.  
+2. Once the token is entered and validated, the download will start automatically. Please wait for it to complete.  
+3. When the download finishes, select the downloaded version and click the __`Launch`__ button to verify that the game launches correctly.
+
+<div align="center">
+    <img src="../wiki/Guides/Installation-and-updates/Install-or-import-a-version/OculusLogin.png" alt="OculusLogin.png" />
+    <img src="../wiki/Guides/Installation-and-updates/Install-or-import-a-version/OculusLoginToken.png" alt="OculusLoginToken.png" />
+</div>
+
+## 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.

docs/wiki/Guides/Installation-and-updates/install-bsmanager-on-linux/install-bsmanager-on-linux.md

@@ -0,0 +1,103 @@
+## Table of Contents
+
+- [Installation](#installation)
+    - [Ubuntu, Debian (deb)](#ubuntu-debian-deb)
+        - [PPA Repository](#ppa-repository)
+        - [dpkg Install](#dpkg-install)
+    - [Arch (AUR)](#arch-aur)
+    - [NixOS/Nix](#nixosnix)
+    - [Universal (flatpak)](#universal-flatpak)
+- [Proton Setup](#proton-setup)
+
+## Installation
+
+Go to [Releases](https://github.com/Zagrios/bs-manager/releases) page and go to the latest alpha release (version 1.5.0-alpha.5 or higher). Download the necessary build installer for your distro (see below).
+
+### Ubuntu, Debian (deb)
+
+#### PPA Repository
+
+Refer to [bs-manager-deb](https://github.com/silentrald/bs-manager-deb).
+
+Add the BSManager PPA repository into 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 in the releases 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 have to either:
+> - Download the latest `.deb` file on the Releases page; or
+> - Install thru PPA repository to automatically update with `sudo apt update & sudo apt upgrade`.
+
+### 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).
+
+### NixOS/Nix
+
+Refer to [bs-manager](https://github.com/NixOS/nixpkgs/blob/master/pkgs/by-name/bs/bs-manager/package.nix).
+
+Available in nixpkgs on `24.11` and `unstable` branches
+
+> [!NOTE]
+> bs-manager will not be automatically updated in the client. You must update your channel or `flake.lock` to get the latest version in nixpkgs.
+> Additionally updates to the nix package will lag behind main due to nixpkgs being run by volunteers
+
+#### Installation
+
+BSManager can be installed via your configuration or [home-manager](https://github.com/nix-community/home-manager).
+
+To try out bs-manager without installing, please run:
+```bash
+nix-shell -p bs-manager --run bs-manager
+```
+
+> [!WARNING]
+> bs-manager has been untested on non-nixos systems running the nix package manager; if you encounter issues, please contact the nix package maintainer
+
+### 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
+```
+
+Flatpak also supports sandboxing which gives the minimal access to your machine. To configure this, you can download [Flatseal](https://flathub.org/apps/com.github.tchx84.Flatseal) which has a GUI to edit your permissions. You can also this with the `flatpak` executable but it will not be discussed here.
+
+## 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.

docs/wiki/Guides/Login/How-to-obtain-your-Oculus-Token/How-to-obtain-your-Oculus-Token.md

@@ -0,0 +1,62 @@
+> [!WARNING]  
+>
+> Your token is a confidential piece of information. Possession of this token allows individuals to download applications, send messages, among other actions, under your identity.
+>
+>However, you might wonder why it is necessary to provide this token to BSManager. The reason is that BSManager requires the token to continue the download with Oculus. Once you've input the token, it is used exclusively to communicate with Oculus servers to verify that you are the rightful owner of the game.
+
+## Table of Contents
+
+- [Step 1 - Install and log into the Oculus Rift app](#step-1---install-and-log-into-the-oculus-rift-app)
+- [Step 2 - Open developer tools](#step-2---open-developer-tools)
+- [Step 3 - Copy your Token](#step-3---copy-your-token)
+
+# Solution 1 - Using the Oculus app
+
+## Step 1 - Install and log into the Oculus Rift app
+
+1. Download the Oculus Rift app setup from the [Meta website](https://www.oculus.com/rift/setup/).
+2. Install the Oculus Rift app on your computer.
+
+> [!NOTE]  
+>__If you bought Beat Saber from the Quest store, it won't appear in your Rift library by default. To download it with [BSManager](https://www.bsmanager.io), first follow [this guide](https://github.com/Zagrios/bs-manager/wiki/how-to-claim-oculus-desktop-version) claim it from its store page.__
+
+## Step 2 - Open developer tools
+
+1. Open the Oculus app.
+2. Open the developer tools by pressing `Ctrl` + `Shift` + `i`.
+
+## Step 3 - Copy your Token
+
+In the developer tools:
+
+1. Open the __`Network`__ tab.
+2. Press CTRL+R.
+3. Filter for __`graph`__.
+4. Click on the first request that appears.
+5. Open the __`Payload`__ tab.
+6. Scroll to the bottom to locate your token. It should start with __`FRL`__.
+7. Select the token using your mouse and press `Ctrl` + `C` to copy it.
+
+<div align="center">
+    <img src="../wiki/Guides/Login/How-to-obtain-your-Oculus-Token/GetYourOculusToken.png" alt="GetYourOculusToken.png" />
+</div>
+
+# Solution 2 - Using the Oculus website
+
+## Steps
+
+1. Log in to your Meta account at https://secure.oculus.com 
+2. Open the developer tools in your web browser:
+   - Chrome/Edge/Firefox: Press <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>I</kbd> or <kbd>F12</kbd>
+   - Safari: Press <kbd>Option</kbd>+<kbd>Command</kbd>+<kbd>I</kbd>
+3. Go to the "Application" tab
+4. Expand "Cookies" in the left sidebar 
+5. Click on `https://secure.oculus.com`
+6. Find the cookie named `oc_ac_at` (value starts with `OC`)
+7. Copy the entire `oc_ac_at` cookie value - this is your token
+
+<div align="center">
+    <img src="../wiki/Guides/Login/How-to-obtain-your-Oculus-Token/GetYourOculusTokenBrowser.png" alt="GetYourOculusTokenBrowser.png" />
+</div>
+
+Paste the token into BSManager or other trusted apps to manage your Beat Saber game and mods. Keep it confidential.

docs/wiki/Guides/Login/how-to-claim-oculus-desktop-version/how-to-claim-oculus-desktop-version.md

@@ -0,0 +1,21 @@
+## Table of Contents
+
+- [Step 1 - Install and log into the Oculus Rift app](#step-1---install-and-log-into-the-oculus-rift-app)
+- [Step 2 - Claim your desktop version of Beat Saber](#step-2---claim-your-desktop-version-of-beat-saber)
+
+
+## Step 1 - Install and log into the Oculus Rift app
+
+1. Download the Oculus Rift app setup from the [Meta website](https://www.oculus.com/rift/setup/).
+2. Install the Oculus Rift app on your computer.
+
+## Step 2 - Claim your desktop version of Beat Saber
+
+1. Open the Oculus app.
+2. Go to the __`Store`__ tab.
+3. Search for __`Beat Saber`__.
+4. Click on the __`Get`__ button to claim the game.
+
+<div align="center">
+    <img src="../wiki/Guides/Login/how-to-claim-oculus-desktop-version/claimOculusDesktopVersion.png" alt="claimOculusDesktopVersion.png" />
+</div>

docs/wiki/Home.md

@@ -0,0 +1,72 @@
+# Welcome to the BSManager Wiki
+
+BSManager is your all-in-one tool designed to simplify and enhance your Beat Saber experience. With BSManager, you can effortlessly manage game versions, mods, maps, and more, ensuring a seamless and enjoyable gameplay journey.
+
+## 📚 Guides
+
+Our comprehensive guides are crafted to assist you in maximizing BSManager's capabilities:
+
+### 🛠️ Installation and Updates
+
+Step-by-step instructions to install BSManager on your system and keep it up to date
+
+- [Install BSManager on Linux](install-bsmanager-on-linux)
+- [Install or import a version](install-or-import-a-version)
+- [Create a shortcut](create-a-shortcut)
+
+### 🔑 Login
+
+Guidance on logging into BSManager to access all features
+
+- [How to obtain your Oculus Token](How-to-obtain-your-Oculus-Token)
+
+### 🎮 Content Management
+
+- __🗺️ Maps__: Learn how to download and organize custom maps for endless entertainment.
+    - [Install any map](install-any-map)
+    - [Install all playlists you want](install-all-playlists-you-want)
+- __🧩 Mods__: Discover how to install, update, and manage mods to enhance your gameplay.
+    - [Install mods on your version](install-mods-on-your-version)
+- __🖼️ Models__: Find out how to integrate custom models into your Beat Saber experience.
+    - [Modify models in your Beat Saber](modify-models-in-your-beat-saber)
+
+### 🤝 Contribution
+
+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)
+
+## 🐞 Troubleshooting
+
+Our troubleshooting section is here to help you resolve common issues quickly and efficiently:
+
+<!-- ### ⚙️ Connection Issues: Solutions for problems related to connecting BSManager to required services. -->
+
+### 💾 Installation Problems
+
+Guidance on fixing errors during setup or version updates
+
+- __🐧Linux__:
+    - [Missing Icons in Game]([Linux]-Missing-Icons-in-Game)
+    - [[Deb] The SUID Sandbox Helper Binary Was Found]([Linux]-[deb]-The-SUID-Sandbox-Helper-Binary-Was-Found)
+    - [[Flatpak] Steam Beat Saber Version Not Showing / Proton Not Detected]([Linux]-[Flatpak]-Steam-Beat-Saber-Version-Not-Showing-Proton-Not-Detected)
+    - [[Flatpak] Changing Installation Folder]([Linux]-[Flatpak]-Changing-Installation-Folder)
+
+<!-- ### 🎮 Gameplay Issues: Fixes for issues impacting Beat Saber performance. -->
+
+### 🔍 Debugging Tips
+
+Steps to gather logs and identify specific issues
+
+- [Activate Oculus Sideloading](Activate-Oculus-sideloading)
+- [How to find your logs](how-to-find-your-logs)
+- [Submitting a bug report](https://github.com/Zagrios/bs-manager/issues/new?assignees=Zagrios&labels=bug&projects=&template=1-bug-report.yaml&title=%5BBUG%5D+%3A+)
+
+***
+
+We are committed to keeping this wiki up to date with the latest information and best practices. Your contributions are welcome; please refer to our [Help us update the wiki](help-us-update-the-wiki) to get started.
+
+For additional support and community interaction, join our [Discord server](https://discord.gg/uSqbHVpKdV).
+
+Thank you for using BSManager!

docs/wiki/Troubleshoots/Debugging-tips/Activate-Oculus-sideloading/Activate-Oculus-sideloading.md

@@ -0,0 +1,14 @@
+Enabling Oculus sideloading allows games located outside if your Oculus library to be played on your Oculus Quest.
+
+- **Step 1:** Start the regedit application by pressing `Win + R` and typing `regedit` in the dialog box.
+- **Step 2:** Navigate to `HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Oculus VR, LLC\Oculus`.
+- **Step 3:** Right-click on the right panel and select `New > DWORD (32-bit) Value`.
+- **Step 4:** Name the new value `AllowDevSideloaded` and set the value to `1`.
+
+You should end up with something like this:
+
+<div align="center">
+    <img src="../wiki/Troubleshoots/Debugging-tips/Activate-Oculus-sideloading/enable-oculus-sideloading.png" alt="enable-oculus-sideloading.png" />
+</div>
+
+After completing these steps, you should be able to start Beat Saber from BSManager and play it on your Oculus Quest. If you are still having issues, please join our [Discord](https://discord.gg/uSqbHVpKdV) server for further assistance.

docs/wiki/Troubleshoots/Debugging-tips/How-to-find-your-logs/How-to-find-your-logs.md

@@ -0,0 +1,37 @@
+## Summary
+
+- [BSManager Log Files](#bsmanager-log-files)
+- [Beat Saber (BSIPA) Log Files](#beat-saber-bsipa-log-files)
+- [Player.log (Unity) Log File](#playerlog-unity-log-file)
+
+## BSManager Log Files
+
+1. Launch BSManager and go to __Settings__.
+2. Scroll to the bottom of the page.
+3. Click on the __`Open Logs`__ button.
+4. Right-click on the log file to be sent and select __`Copy`__.
+    > [!NOTE]  
+    > The requested file is usually the most recent log file, located at the bottom of the list.
+5. __`Paste`__ your file in the channel where log files are requested.
+
+<div align="center">
+    <img src="../wiki/Troubleshoots/Debugging-tips/How-to-find-your-logs/BSMLogs.png" alt="BSMLogs.png" />
+</div>
+
+## Beat Saber (BSIPA) Log Files
+
+1. Launch BSManager and select the version with which you are experiencing the problem.
+2. Click the version options button at the top-right corner of the interface, then select __`Open Folder`__.
+3. Double-click the __`Logs`__ folder to open it.
+4. Right-click the log file named __`_latest.log`__ (or just __`_latest`__) and select __`Copy`__.
+    > [!NOTE]  
+    > This file will usually be at the top of the list.
+5. __`Paste`__ the file in the channel where log files are requested using __`Ctrl+V`__.
+
+## Player.log (Unity) Log File
+
+1. Press __`Win+R`__ simultaneously on your keyboard.
+2. Type or copy-paste the following path into the window that pops up, then press __Enter__:  
+   `%appdata%\..\LocalLow\Hyperbolic Magnetism\Beat Saber`
+3. Right-click the log file named __`Player.log`__ (or just __`Player`__) and select __`Copy`__.
+4. __`Paste`__ the file in the channel where log files are requested using __`Ctrl+V`__.

docs/wiki/Troubleshoots/Debugging-tips/Nothing-opens-when-I-press-`Ctrl`‐`Shift`‐`i`/Nothing-opens-when-I-press-`Ctrl`‐`Shift`‐`i`..md

@@ -0,0 +1,4 @@
+If nothing opens when you press `Ctrl` + `Shift` + `I`, it’s possible that the keyboard shortcut to open the developer tools is being used by another application.
+
+Here’s a non-exhaustive list of applications that may cause this problem and their suggested solutions:
+- [AMD Software](https://github.com/Zagrios/bs-manager/wiki/AMD-Software-%E2%80%90-Nothing-opens-when-I-press-%60Ctrl%60%E2%80%90%60Shift%60%E2%80%90%60I%60)

docs/wiki/Troubleshoots/Debugging-tips/Nothing-opens-when-I-press-`Ctrl`‐`Shift`‐`i`/Subpages/AMD-Sofware-‐-Nothing-opens-when-I-press-`Ctrl`‐`Shift`‐`I`.md

@@ -0,0 +1,30 @@
+If you encounter a keyboard shortcut conflict between AMD Software and Oculus Rift, you can either disable or modify the conflicting shortcut.
+
+_Special thanks to_ `𝔽𝕪𝕟𝕟 (fynn07)` _for their contribution with information and screenshots._
+
+### __Follow these steps to disable or modify the shortcut in AMD Software:__
+
+## Step 1 - Access Settings
+
+1. Open AMD Software and click on the gear icon in the top-right corner to access the settings.
+
+![image](https://github.com/Zagrios/bs-manager/assets/40648115/2762f59c-f12a-46ba-80fa-9bf79beb64a9)
+
+## Step 2 - Modify Keyboard Shortcuts
+
+1. In the settings menu, select the __"Hotkey"__ tab.
+
+![image](https://github.com/Zagrios/bs-manager/assets/40648115/262d4fcc-529f-4c4c-9b87-e2da21df1b95)
+
+## Step 3 - Disable Shortcuts
+
+1. Turn off the __"Use Hotkeys"__ option to prevent any conflicts with Oculus Rift.
+
+![image](https://github.com/Zagrios/bs-manager/assets/40648115/756018ad-7de3-469c-9f40-0082be007805)
+
+## Step 3 (Alternative) - Modify the Shortcut
+
+1. If you prefer to keep using keyboard shortcuts, consider changing the specific conflicting shortcut (e.g., __"Ctrl + Shift + I"__) to another combination that is less likely to interfere.
+
+> ℹ️ __Note:__ You can't change the full keybind!  
+> You can only modify the __"I"__ to a different key. ℹ️

docs/wiki/Troubleshoots/Installation-Problems/Linux/[Linux]-Missing-Icons-in-Game/[Linux]-Missing-Icons-in-Game.md

@@ -0,0 +1,9 @@
+<p align="center">
+    <img src="../wiki/Troubleshoots/Installation-Problems/Linux/%5BLinux%5D-Missing-Icons-in-Game/linux-missing-icons.png" alt="Linux Missing Icons" width="300"/>
+    <br>
+    NOTE: "?" are missing unicode icons
+</p>
+
+This is due to [BSML](https://github.com/monkeymanboy/BeatSaberMarkupLanguage) using a missing font (`Segoe UI Symbols`) for unicode emojis.
+
+To fix the issue, you need to get a copy of `seguisym.ttf` from the fonts folder an official copy Windows. Once you have a copy, add the font file to `~/.steam/steam/steamapps/compatdata/620980/pfx/drive_c/windows/Fonts`.

docs/wiki/Troubleshoots/Installation-Problems/Linux/[Linux]-[Flatpak]-Changing-Installation-Folder/[Linux]-[Flatpak]-Changing-Installation-Folder.md

@@ -0,0 +1,5 @@
+To change the installation path of the **BSManager** folder, you have to edit the flatpak permissions to destination folder.
+
+- In flatpak or Flatseal, add the destination folder with `:create` permissions.
+- In BSM, move the folder to the destination folder.
+- [Optional] In flatpak or Flatseal, remove the original folder permissions.