bumb to 1.5.3

* added more loading when loading mods

.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

@@ -9,242 +9,503 @@
 *** https://www.markdownguide.org/basic-syntax/#reference-style-links
 -->
 
-<!-- TITLE -->
+<!--
+----------------------------------------
+    BSManager
+----------------------------------------
+-->
 <div align="center">
-    <a href="https://github.com/Zagrios/bs-manager">
-        <img src="resources/readme/icon.svg" alt="Logo" width="250" height="250">
-    </a>
-    <br><br>
-    <h2><b>BSManager</b></h2>
-    <i>(Beat Saber Manager)</i>
-    <br><br>
-    <span>
-        Download, manage and customize your versions of Beat Saber with a simple click!
-    </span>
-    <br>
-    <span>
-        <a href="https://github.com/Zagrios/bs-manager/issues/new?assignees=Zagrios&labels=bug&template=-bug--bug-report.md&title=%5BBUG%5D+%3A+">Report Bug</a> 
-        ·
-        <a href="https://github.com/Zagrios/bs-manager/issues/new?assignees=Zagrios&labels=enhancement&template=-feat---feature-request.md&title=%5BFEAT.%5D+%3A+">Request Feature</a>
-        ·
-        <a href="https://github.com/Zagrios/bs-manager/security/policy">Report a security vulnerability</a>
-    </span>
+  <a href="https://github.com/Zagrios/bs-manager">
+    <img src="resources/readme/SVG/icon.svg" alt="Logo" width="250" height="250">
+  </a>
+  <h1><b>BSManager</b></h1>
+  <p>
+    Download, manage and customize your versions of <a href="https://beatsaber.com/">Beat Saber</a> with a simple click!
+  </p>
+  <p>
+    <a
+      href="https://github.com/Zagrios/bs-manager/issues/new?assignees=Zagrios&labels=bug&template=-bug--bug-report.md&title=%5BBUG%5D+%3A+">Report
+      Bug</a>
+    ·
+    <a
+      href="https://github.com/Zagrios/bs-manager/issues/new?assignees=Zagrios&labels=enhancement&template=-feat---feature-request.md&title=%5BFEAT.%5D+%3A+">Request
+      Feature</a>
+    ·
+    <a href="https://github.com/Zagrios/bs-manager/security/policy">Report a security vulnerability</a>
+  </p>
+  <hr>
 </div>
 
-## <!-- BADGES -->
+<!--
+----------------------------------------
+    BADGES
+----------------------------------------
+-->
+<div align="center">
+  <a href="https://github.com/Zagrios/bs-manager/stargazers"><img
+      src="https://img.shields.io/github/stars/Zagrios/bs-manager?style=for-the-badge" alt="Stargazers" /></a>
+  <a href="https://github.com/Zagrios/bs-manager/network/members"><img
+      src="https://img.shields.io/github/forks/Zagrios/bs-manager?style=for-the-badge" alt="Forks" /></a>
+  <a href="https://github.com/Zagrios/bs-manager/blob/master/LICENSE"><img
+      src="https://img.shields.io/github/license/Zagrios/bs-manager?style=for-the-badge" alt="License" /></a>
+  <a href="https://github.com/Zagrios/bs-manager/graphs/contributors"><img
+      src="https://img.shields.io/github/contributors/Zagrios/bs-manager?style=for-the-badge" alt="Contributors" /></a>
+  <a href="https://github.com/Zagrios/bs-manager/issues"><img alt="GitHub issues"
+      src="https://img.shields.io/github/issues/Zagrios/bs-manager?style=for-the-badge"></a>
+  <br>
+  <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://twitter.com/BSManager_"><img
+      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>
 
-<br>
-<div align="center" >
-    <a href="https://github.com/Zagrios/bs-manager/stargazers"><img src ="https://img.shields.io/github/stars/Zagrios/bs-manager?style=for-the-badge" alt="Stargazers"/></a>
-    <a href="https://github.com/Zagrios/bs-manager/network/members"><img src ="https://img.shields.io/github/forks/Zagrios/bs-manager?style=for-the-badge" alt="Forks"/></a>
-    <a href="https://github.com/Zagrios/bs-manager/blob/master/LICENSE"><img src ="https://img.shields.io/github/license/Zagrios/bs-manager?style=for-the-badge" alt="License"/></a>
-    <a href="https://github.com/Zagrios/bs-manager/graphs/contributors"><img src ="https://img.shields.io/github/contributors/Zagrios/bs-manager?style=for-the-badge" alt="Contributors"/></a>
-    <a href="https://github.com/Zagrios/bs-manager/issues"><img alt="GitHub issues" src="https://img.shields.io/github/issues/Zagrios/bs-manager?style=for-the-badge"></a>
-    <br>
-    <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>
-    <br>
+<!--
+----------------------------------------
+    TABLE OF CONTENTS
+----------------------------------------
+-->
+<div>
+  <hr>
+    <details open>
+    <summary><b>Table of Contents</b></summary>
+    <ul>
+        <li>
+        <details>
+            <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>
+        </details>
+        </li>
+        <li>
+        <details>
+            <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>
+        <details>
+            <summary><a href="#download-and-installation">Download and Installation</a></summary>
+            <ul>
+            <li><a href="#features">Features</a></li>
+            </ul>
+        </details>
+        </li>
+        <li>
+        <details>
+            <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>
+        </details>
+        </li>
+        <li>
+        <details>
+            <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>
+        </details>
+        </li>
+    </ul>
+    </details>
+    <div align="right">
     [<a href="#readme-bot">Go to bottom</a>]
-</div>
-
----
-
-<!-- TABLE OF CONTENTS -->
-
-<b>Table of Contents</b>
-
-<ul>
-    <li>
-        <a href="#about-the-project">About The Project</a>
-        <ul>
-            <li><a href="#built-with">Built With</a></li>
-        </ul>
-    </li>
-    <li><a href="#usage">Usage</a></li>
-    <ul>
-        <li><a href="#how-to-install">How to install?</a></li>
-        <li><a href="#manage-versions">Manage Versions</a></li>
-        <li><a href="#customize-your-versions">Customize your versions</a></li>
-        <li><a href="#install-mods">Install Mods</a></li>
-        <li><a href="#install-maps">Install Maps</a></li>
-        <li><a href="#one-click">One Click</a></li>
-        <li><a href="#having-problems">Having problems?</a></li>
-    </ul>
-    <li><a href="#credits">Credits</a></li>
-    <li><a href="#contributing">Contributing</a></li>
-</ul>
-
-<!-- ABOUT THE PROJECT -->
-<div align="center">
-    <h1> </h1>
-    <h1><b>About The Project</b></h1>
-</div>
-<div>
-    <a href="https://github.com/Zagrios/bs-manager">BSManager</a> was created to unify and improve the two most used Apps in the community (<a href="https://github.com/RiskiVR/BSLegacyLauncher">BS legacy launcher</a> and <a href="https://github.com/Assistant/ModAssistant">Mod Assistant</a>).
-    <br><br>
-    <h4><a href="https://github.com/Zagrios/bs-manager">BSManager</a> will allow you to:</h4>
-    <ul>
-        <li><b>Manage multiple BeatSaber versions</b>, designed for people who need to play on different versions or have multiple profiles for the same version.</li>
-        <li><b>Download your maps in the same way</b>, in addition to that, depending on your choice, maps are not version dependent. so you will be able to find your maps whatever version you are using without having to transfer them.</li>
-        <li><b>Install your mods in one click</b>, just like <a href="https://github.com/Assistant/ModAssistant">Mod Assistant</a>, <a href="https://github.com/Zagrios/bs-manager">BSManager</a> will allow you to install your mods quickly and securely depending on the version you choose.</li>
-        <li><b>Customize your interface</b>, we know that some of you like to customize your interfaces to the maximum. That's why <a href="https://github.com/Zagrios/bs-manager">BSManager</a> brings you peace of mind on this point, you can change the name of the versions, their color, and you can even change the color of the logo! Of course, a dark theme has been added to protect your eyes at night.</li>
-    </ul>
-</div>
-<br>
-<div align="center">
-    <img src="resources/readme/preview.png" alt="preview">
-</div>
-<br>
-
-<!--BUILT WITH-->
-<div>
-    <h2><b>Built With</b></h2>
-    <ul>
-        <li>
-            <a href="https://electron-react-boilerplate.js.org/"><img src="https://img.shields.io/badge/-Electron%20React%20Boilerplate-black?style=for-the-badge&logo=Electron" alt="Electron React Boilerplate"></a>
-        </li>
-        <li>
-            <a href="https://github.com/SteamRE/DepotDownloader"><img src="https://img.shields.io/badge/-Depot%20Downloader-2a475e?style=for-the-badge&logo=steam" alt="Depot Downloader"></a>
-        </li>
-        <li>
-            <a href="https://rxjs.dev/"><img src="https://img.shields.io/badge/-RxJs-purple?style=for-the-badge&logo=ReactiveX" alt="RxJs"></a>
-        </li>
-        <li>
-            <a href="https://tailwindcss.com/"><img src="https://img.shields.io/badge/-Tailwind%20CSS-white?style=for-the-badge&logo=Tailwind%20CSS" alt="TailWind CSS"></a>
-        </li>
-    </ul>
-</div>
-<br>
-
-<!--USAGE-->
-<div align="center">
-    <h1> </h1>
-    <h1><b>Usage</b></h1>
-</div>
-
-<!--HOW TO INSTALL?-->
-<div>
-    <h2><b>How to install?</b></h2>
-    <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>Execute the installer and <a href="../..">BSManager</a> will start itself.</li>
-        <li>Once its 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>
-</div>
-<br>
-
-<!--MANAGE VERSIONS-->
-<div>
-    <h2><b>Manage Versions</b></h2>
-    <span>
-        <a href="https://github.com/Zagrios/bs-manager">BSManager</a> allows you to manage your versions of Beat Saber. It gives you the ability to download any version of Beat Saber as long as you have a Steam account that already owns the game. Using <a href="https://github.com/Zagrios/bs-manager">BSManager</a>, you can easily manage and update your collection of Beat Saber versions.
-    </span>
-</div>
-<br>
-<div align="center">
-
-https://user-images.githubusercontent.com/40648115/213008824-25cfdda3-6350-42dc-aa53-2132b4b8e838.mov
-
-</div>
-
-<!--CUSTOM UR VERSIONS-->
-<div>
-    <h2><b>Customize your versions</b></h2>
-    <span>
-        <a href="https://github.com/Zagrios/bs-manager">BSManager</a> will allow you to completely customize each of your downloaded  versions, you can change the color of the icon, choose a name for the version and finally install your mods,maps and other contents according to the Beat Saber version! 
-    </span>
-</div>
-<br>
-<div align="center">
-
-https://user-images.githubusercontent.com/40648115/213296794-74a1e20b-12dc-44ec-a67f-e25d7010bd3d.mov
-
-</div>
-
-<!--INSTALL MODS-->
-<div>
-    <h2><b>Install Mods</b></h2>
-    <span>
-        <a href="https://github.com/Zagrios/bs-manager">BSManager</a> allows you to manage Beat Saber mods in a quick and easy way. It uses the <a href="https://beatmods.com/#/">BeatMod API</a> to allow you to install, update or uninstall mods for each version of your collection. So the app can help you manage them efficiently.
-    </span>
-</div>
-<br>
-<div align="center">
-
-https://user-images.githubusercontent.com/40648115/213296816-bdaafc90-da76-4835-8d83-9ac6a4e1c549.mov
-
-</div>
-
-<!--INSTALL MAPS-->
-<div>
-    <h2><b>Install Maps</b></h2>
-    <span>
-        In addition to managing mods, <a href="https://github.com/Zagrios/bs-manager">BSManager</a> allows you to manage and organize custom beatmaps existing on <a href="https://beatsaver.com">Beat Saver</a>, a popular site for sharing custom beatmaps for beat Saber. Moreover the app allow you to share your maps across all your versions. 
-    </span>
-</div>
-<br>
-<div align="center">
-
-https://user-images.githubusercontent.com/40648115/213296838-f775fe83-866d-4764-a7d0-648dbb8ec983.mov
-
-</div>
-
-<!--ONE CLICK-->
-<div>
-    <h2><b>One Click</b></h2>
-    <span>
-        The "One-Click" feature of <a href="https://github.com/Zagrios/bs-manager">BSManager</a> is an incredibly convenient feature for Beat Saber users. It allows easy and quick installation of models, maps and playlists for all versions of Beat Saber you own.
-    </span>
-</div>
-<br>
-<div align="center">
-
-https://user-images.githubusercontent.com/40648115/213435051-7feb815d-f32b-4135-b095-ef49726a836c.mov
-
-</div>
-
-<!--HAVING PROBLEMS?-->
-<div>
-    <h2><b>Having problems?</b></h2>
-    <span>
-        See the <a href="https://github.com/Zagrios/bs-manager/issues">open issues</a> to show the list of known issues, from there you can create a new issue for your problem!  
-    </span>
-</div>
-
-<br><br><br>
-
-<!-- Credits -->
-<div>
-    <h1><b>Credits</b></h1>
-    <ul>
-        <li><a href="https://github.com/Zagrios">Zagrios</a> - Founder & Lead Developer</li>
-        <li><a href="https://github.com/Iluhadesu">Iluhadesu</a> - Project Team & Developpement help</li>
-        <li><a href="https://github.com/GaetanGrd">GaetanGrd</a> - Project Team & Developpement help</li>
-        <li><a href="https://github.com/cheddZy">cheddZy</a> - Icon creator</li>
-    </ul>
-</div>
-
-<!-- Contributing -->
-<br>
-<!--CONTRIBUTING-->
-<div>
-    <h1><b>Contributing</b></h1>
-    <p>
-        If you'd like to contribute, check out the <a href="https://github.com/Zagrios/bs-manager/blob/master/CONTRIBUTING.md">contributing guide</a>
-    </p>
-    <p>Thank you to all the people who already contributed to BSManager!</p>
-    <div>
-        <a href="https://github.com/Zagrios/bs-manager/graphs/contributors">
-            <img src="https://contrib.rocks/image?repo=Zagrios/bs-manager" />
-        </a>
     </div>
 </div>
-<br>
 
-<div align="right">
-    [<a href="#readme-top">Return to top</a>]
+
+<!--
+----------------------------------------
+    BSMANAGER: YOUR BEAT SABER ASSISTANT
+----------------------------------------
+-->
+<div align="center">
+  <hr>
+  <h1><b>BSManager: Your Beat Saber Assistant</b></h1>
+</div>
+
+<!--
+    WHAT IS IT?
+----------------------------------------
+-->
+<div>
+  <h2>What is it?</h2>
+  <p><a href="https://github.com/Zagrios/bs-manager">BSManager</a> simplifies your <a href="https://beatsaber.com/">Beat
+      Saber</a> experience by centralizing the management of mods, maps, and game versions in one place.</p>
+</div>
+
+<!--
+    WHY USE IT?
+----------------------------------------
+-->
+<div>
+  <h2>Why use it?</h2>
+  <ul>
+    <li><strong>Easy</strong>: Manage and switch between different instances of <a href="https://beatsaber.com/">Beat
+        Saber</a> simply.</li>
+    <li><strong>Accessibility</strong>: Access a multitude of content with just a few clicks.</li>
+    <li><strong>Customization</strong>: Adapt <a href="https://github.com/Zagrios/bs-manager">BSManager</a> to your
+      tastes without technical hassles.</li>
+  </ul>
+  <b>Start your enhanced experience with <a href="https://beatsaber.com/">Beat Saber</a> and explore all the features
+    offered by <a href="https://github.com/Zagrios/bs-manager">BSManager</a>!</b>
+</div>
+
+<div align="center">
+  <br>
+  <video src="https://github.com/Zagrios/bs-manager/assets/40648115/012b0196-74ef-4ee5-86a4-49e835612f96"/>
+</div>
+
+<!--
+    BUILT WITH
+----------------------------------------
+-->
+<div>
+  <h2><b>Built With</b></h2>
+  <ul>
+    <li>
+      <a href="https://electron-react-boilerplate.js.org/"><img
+          src="https://img.shields.io/badge/-Electron%20React%20Boilerplate-black?style=for-the-badge&logo=Electron"
+          alt="Electron React Boilerplate"></a>
+    </li>
+    <li>
+      <a href="https://github.com/SteamRE/DepotDownloader"><img
+          src="https://img.shields.io/badge/-Depot%20Downloader-2a475e?style=for-the-badge&logo=steam"
+          alt="Depot Downloader"></a>
+    </li>
+    <li>
+      <a href="https://rxjs.dev/"><img
+          src="https://img.shields.io/badge/-RxJs-purple?style=for-the-badge&logo=ReactiveX" alt="RxJs"></a>
+    </li>
+    <li>
+      <a href="https://tailwindcss.com/"><img
+          src="https://img.shields.io/badge/-Tailwind%20CSS-white?style=for-the-badge&logo=Tailwind%20CSS"
+          alt="TailWind CSS"></a>
+    </li>
+  </ul>
+</div>
+
+<!--
+    HOW TO INSTALL
+----------------------------------------
+-->
+<div>
+  <h2><b>How to install?</b></h2>
+</div>
+
+<div>
+  <h3><b>Windows Installation</b></h3>
+  <ul>
+    <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>
+  </ul>
+</div>
+
+<div align="center">
+  <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>
+
+<!--
+----------------------------------------
+    VERSION MANAGEMENT
+----------------------------------------
+-->
+<div align="center">
+  <hr>
+  <h1><b>Version management</b></h1>
+</div>
+<div>
+  <p>With <a href="https://github.com/Zagrios/bs-manager">BSManager</a>, manage your <a
+      href="https://beatsaber.com/">Beat Saber</a> versions with ease, allowing the download of new versions and
+    preserving
+    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> 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>: 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/09d579de-8b8e-45d3-8829-21a25cc7daf8" alt=""/>
+</div>
+
+<!--
+    MULTI-VERSION SHARING
+----------------------------------------
+-->
+<div>
+  <h2>Multi-Version Sharing</h2>
+  <p><a href="https://github.com/Zagrios/bs-manager">BSManager</a> facilitates the sharing of your maps, models, and
+    custom files between different versions of <a
+      href="https://beatsaber.com/">Beat Saber</a>. Thanks to an intuitive user interface, you can easily share
+    your files from one version to another, ensuring a consistent and continuous gaming experience across all your
+    installations.</p>
+</div>
+
+<div align="center">
+  <video src="https://github.com/Zagrios/bs-manager/assets/40648115/ba39aceb-f55f-4e58-8386-51fcfaad4957"/>
+</div>
+
+<!--
+    IMPORTING AN EXISTING VERSION OF BEAT SABER
+----------------------------------------
+-->
+<div>
+  <h2>Importing an Existing Version of Beat Saber</h2>
+  <p><a href="https://github.com/Zagrios/bs-manager">BSManager</a> allows easy importing and organizing of your existing
+    versions of <a href="https://beatsaber.com/">Beat Saber</a>, enabling you to retain
+    all your previously downloaded or created data while taking advantage of <a
+      href="https://github.com/Zagrios/bs-manager">BSManager</a>'s management features.</p>
+</div>
+
+<div align="center">
+  <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 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>: 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>
+
+  <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/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>.
+  </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
+----------------------------------------
+-->
+<div align="center">
+  <hr>
+  <h1><b>Download and Installation</b></h1>
+</div>
+
+<div>
+  <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>
+
+<div>
+  <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>
+
+<!--
+----------------------------------------
+    CUSTOMIZATION
+----------------------------------------
+-->
+<div align="center">
+  <hr>
+  <h1><b>Customization</b></h1>
+</div>
+<div>
+  <p><a href="https://github.com/Zagrios/bs-manager">BSManager</a> offers various options to customize both the tool
+    itself and your <a href="https://beatsaber.com/">Beat Saber</a> instances, allowing you to create a user experience
+    that is uniquely yours.</p>
+</div>
+
+<!--
+    TOOL
+----------------------------------------
+-->
+<div>
+  <h2>Tool</h2>
+  <p>Adjust the appearance of <a href="https://github.com/Zagrios/bs-manager">BSManager</a> to your preferences with a
+    variety of customization options available in the tool's settings:</p>
+  <ul>
+    <li><strong>Theme</strong>: Choose between a light or dark theme, or follow the system settings for seamless integration into your work environment.</li>
+    <li><strong>Color</strong>: Select your preferred primary and secondary colors using hexadecimal codes, allowing you
+      to customize the visual appearance of the tool to your liking.</li>
+  </ul>
+</div>
+
+<div align="center">
+  <video src = "https://github.com/Zagrios/bs-manager/assets/40648115/d2c1b0ec-a2f5-41b5-99d5-c4c2cd34cbd4" />
+</div>
+
+<!--
+    BEAT SABER INSTANCE
+----------------------------------------
+-->
+<div>
+  <h2>Beat Saber Instance</h2>
+  <p>For each <a href="https://beatsaber.com/">Beat Saber</a> instance, <a
+      href="https://github.com/Zagrios/bs-manager">BSManager</a> offers customization options accessible via the version
+    settings and by clicking on "Edit":</p>
+  <ul>
+    <li><strong>Name</strong>: Name your instances in a way that distinguishes and identifies them easily when switching
+      from one to another.</li>
+    <li><strong>Color</strong>: Customize the appearance of your instances by choosing a specific color for each of
+      them.</li>
+  </ul>
+</div>
+
+<div align="center">
+  <video src="https://github.com/Zagrios/bs-manager/assets/40648115/f66a2c99-770e-42ca-9a71-b1806946ad0c" />
+</div>
+
+<!--
+----------------------------------------
+    MORE INFORMATION
+----------------------------------------
+-->
+<div align="center">
+  <hr>
+  <h1><b>More Information</b></h1>
+</div>
+<div>
+  <p><a href="https://github.com/Zagrios/bs-manager">BSManager</a> has an active community and a support team ready to
+    assist you with any questions or issues you may encounter.</p>
+</div>
+
+<!--
+    SUPPORT
+----------------------------------------
+-->
+<div>
+  <h2>Support</h2>
+  <p>For quick and interactive support, it is recommended to join our <a href="https://discord.gg/uSqbHVpKdV">Discord
+      server</a>. For bugs or more complex issues, you can also submit an <a href="https://github.com/Zagrios/bs-manager/issues">issue on
+      GitHub</a>.</p>
+</div>
+
+<!--
+    CREDITS
+----------------------------------------
+-->
+<div>
+  <h2>Credits</h2>
+  <ul>
+    <li><a href="https://github.com/Zagrios">Zagrios</a> - Lead Developer & Founder.</li>
+    <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>
+
+<!--
+    CONTRIBUTING
+----------------------------------------
+-->
+<div>
+  <h2>Contributing</h2>
+  <p>If you'd like to contribute, check out the <a
+      href="https://github.com/Zagrios/bs-manager/blob/master/CONTRIBUTING.md">contributing guide</a>.</p>
+  <p>Thank you to all the people who already contributed to <a
+      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" alt="Contributor list" />
+    </a>
+  </div>
+</div>
+
+<!-- 
+----------------------------------------
+    Others
+----------------------------------------
+-->
+<div align="right">
+  [<a href="#readme-top">Return to top</a>]
+  <hr>
 </div>
 
-<h1> </h1>
 <a name="readme-bot"></a>

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",
@@ -663,5 +662,192 @@
 		"ReleaseImg": "https://clan.akamai.steamstatic.com/images/32055887/cac079717d62489822af3a6e90679a570842f4ca.png",
 		"ReleaseDate": "1698678611",
 		"year": "2023"
+	},
+	{
+		"BSVersion": "1.34.0",
+		"BSManifest": "3651119791147907495",
+		"OculusBinaryId": "6373048192794906",
+		"ReleaseURL": "https://steamcommunity.com/games/620980/announcements/detail/3744239644488431243",
+		"ReleaseImg": "https://clan.cloudflare.steamstatic.com/images/32055887/1ef505a26d6eb8d7d8c132df54bd57918339cb2c.png",
+		"ReleaseDate": "1701795528",
+		"year": "2023"
+	},
+	{
+		"BSVersion": "1.34.2",
+		"BSManifest": "8045892568861450718",
+		"OculusBinaryId": "6426757994090592",
+		"ReleaseURL": "https://steamcommunity.com/games/620980/announcements/detail/3865840827122760836",
+		"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",
+		"recommended": true
 	}
 ]

assets/jsons/patreons.json

@@ -1,19 +1,166 @@
 [
-    {"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": "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"
+    }
 ]

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
-    }
-  }
-}

assets/scripts/node-regedit/vbs/1.wsf

@@ -1,26 +0,0 @@
-<job id="test">
-	<script language="VBScript" src="util.vbs" />
-	<script language="VBScript" src="regUtil.vbs" />
-	<script language="VBScript">
-  	CheckZeroArgs("type A as first arg!!")
-		
-		DetermineOSArchitecture()
-		LoadRegistryImplementationByOSArchitecture()
-	
-		'On Error Resume Next
-
-    Dim key: key = "HKCU\Software\Microsoft\Windows\CurrentVersion\Explorer\User Shell Folders"
-    Dim value: value = "AppData"
-    
-    ParseHiveAndSubKey key, constHive, strSubKey
-    
-    GetExpandedStringValue constHive, strSubKey, value, exResult
-    WriteLine "GetExpandedStringValue: " & exResult
-
-    GetStringValue constHive, strSubKey, value, nResult
-    WriteLine "GetStringValue: " & nResult
-		
-    set ws = createobject("Wscript.shell")
-    WriteLine "regread: " & ws.regread(key & "\AppData")
-	</script>
-</job>

assets/scripts/node-regedit/vbs/ArchitectureAgnosticRegistry.vbs

@@ -1,75 +0,0 @@
-' Notes: wanted to implement this using a class but:
-' 1. No matter what I did I could not assign the result of GetObject to a private member
-' 2. It looks as if all methods were treated as subs from the outside world which is not good since 
-' some of these need to return a value
-'
-
-Set private_oReg = GetObject("winmgmts:\root\default:StdRegProv")		
-
-Function SetStringValue(constHive, strSubKey, strValueName, strValue)	
-	SetStringValue  = private_oReg.SetStringValue(constHive, strSubKey, strValueName, strValue)	
-End Function
-
-Sub GetStringValue(constHive, strKey, strValueName, strValue)
-	private_oReg.GetStringValue constHive, strKey, strValueName, strValue
-End Sub
-
-Function SetExpandedStringValue(constHive, strSubKey, strValueName, strValue)
-	SetExpandedStringValue = private_oReg.SetExpandedStringValue(constHive, strSubKey, strValueName, strValue)
-End Function
-
-Sub GetExpandedStringValue(constHive, strKey, strValueName, strValue)
-	private_oReg.GetExpandedStringValue constHive, strKey, strValueName, strValue
-End Sub
-
-Function SetMultiStringValue(constHive, strSubKey, strValueName, arrValue)
-	SetMultiStringValue = private_oReg.SetMultiStringValue(constHive, strSubKey, strValueName, arrValue)
-End Function
-
-Sub GetMultiStringValue(constHive, strKey, strValueName, arrStrValue)
-	private_oReg.GetMultiStringValue constHive, strKey, strValueName, arrStrValue
-End Sub 
-
-Function SetDWORDValue(constHive, strSubKey, strValueName, arrValue)
-	SetDWORDValue = private_oReg.SetDWORDValue(constHive, strSubKey, strValueName, arrValue)
-End Function
-
-Sub GetDWORDValue(constHive, strKey, strValueName, intDWordValue)
-	private_oReg.GetDWORDValue constHive, strKey, strValueName, intDWordValue
-End Sub
-
-Function SetQWORDValue(constHive, strSubKey, strValueName, strQWordValue)
-	SetQWORDValue = private_oReg.SetQWORDValue(constHive, strSubKey, strValueName, strQWordValue)
-End Function
-
-Sub GetQWORDValue(constHive, strKey, strValueName, intQWordValue)
-	private_oReg.GetQWORDValue constHive, strKey, strValueName, intQWordValue
-End Sub
-
-Function SetBinaryValue(constHive, strSubKey, strValueName, arrValue)
-	SetBinaryValue = private_oReg.SetBinaryValue(constHive, strSubKey, strValueName, arrValue)
-End Function
-
-Sub GetBinaryValue(constHive, strKey, strValueName, arrBinaryValue)
-	private_oReg.GetBinaryValue constHive, strKey, strValueName, arrBinaryValue
-End Sub
-
-Function EnumKey(constHive, strSubKey, arrKeyNames)
-	EnumKey = private_oReg.EnumKey(constHive, strSubKey, arrKeyNames)
-End Function
-
-Function EnumValues(constHive, strSubKey, arrValueNames, arrValueTypes)
-	EnumValues = private_oReg.EnumValues(constHive, strSubKey, arrValueNames, arrValueTypes)
-End Function
-
-Function CreateKey(constHive, strSubKey)
-	CreateKey = private_oReg.CreateKey(constHive, strSubKey)
-End Function
-
-Function DeleteKey(constHive, strSubKey)
-	DeleteKey = private_oReg.DeleteKey(constHive, strSubKey)
-End Function
-
-Function DeleteValue(constHive, strSubKey, strValue)
-	DeleteValue = private_oReg.DeleteValue(constHive, strSubKey, strValue)
-End Function

assets/scripts/node-regedit/vbs/ArchitectureSpecificRegistry.vbs

@@ -1,358 +0,0 @@
-' Notes: wanted to implement this using a class but:
-' 1. No matter what I did I could not assign the result of GetObject to a private member
-' 2. It looks as if all methods were treated as subs from the outside world which is not good since 
-' some of these need to return a value
-
-' should be removed when migration is complete
-Set private_oReg = GetObject("winmgmts:\root\default:StdRegProv")		
-
-Set private_oCtx = CreateObject("WbemScripting.SWbemNamedValueSet")
-private_oCtx.Add "__ProviderArchitecture", CInt(OSArchitecture)
-
-Set private_oLocator = CreateObject("Wbemscripting.SWbemLocator")
-Set private_oServices = private_oLocator.ConnectServer(".", "root\default","","",,,,private_oCtx)
-Set private_oRegSpecific = private_oServices.Get("StdRegProv") 
-
-Function CheckAccess(hDefKey,sSubKeyName,uRequired, bGranted )	
-	Set Inparams = private_oRegSpecific.Methods_("CheckAccess").Inparameters
-	
-	Inparams.hDefKey = hDefKey
-	
-	Inparams.sSubKeyName = sSubKeyName
-	
-	Inparams.uRequired = uRequired
-		
-	set Outparams = private_oRegSpecific.ExecMethod_("CheckAccess", Inparams,,private_oCtx)
-	
-	bGranted = Outparams.bGranted
-	
-
-	CheckAccess = 0
-	
-End Function
-
-Function CreateKey(hDefKey,sSubKeyName)	
-	Set Inparams = private_oRegSpecific.Methods_("CreateKey").Inparameters
-	
-	Inparams.hDefKey = hDefKey
-	
-	Inparams.sSubKeyName = sSubKeyName
-		
-	set Outparams = private_oRegSpecific.ExecMethod_("CreateKey", Inparams,,private_oCtx)
-	
-
-	CreateKey = 0
-	
-End Function
-
-Function DeleteKey(hDefKey,sSubKeyName)	
-	Set Inparams = private_oRegSpecific.Methods_("DeleteKey").Inparameters
-	
-	Inparams.hDefKey = hDefKey
-	
-	Inparams.sSubKeyName = sSubKeyName
-		
-	set Outparams = private_oRegSpecific.ExecMethod_("DeleteKey", Inparams,,private_oCtx)
-	
-
-	DeleteKey = 0
-	
-End Function
-
-Function DeleteValue(hDefKey,sSubKeyName,sValueName)	
-	Set Inparams = private_oRegSpecific.Methods_("DeleteValue").Inparameters
-	
-	Inparams.hDefKey = hDefKey
-	
-	Inparams.sSubKeyName = sSubKeyName
-	
-	Inparams.sValueName = sValueName
-		
-	set Outparams = private_oRegSpecific.ExecMethod_("DeleteValue", Inparams,,private_oCtx)
-	
-
-	DeleteValue = 0
-	
-End Function
-
-Function EnumKey(hDefKey,sSubKeyName, sNames )	
-	Set Inparams = private_oRegSpecific.Methods_("EnumKey").Inparameters
-	
-	Inparams.hDefKey = hDefKey
-	
-	Inparams.sSubKeyName = sSubKeyName
-		
-	set Outparams = private_oRegSpecific.ExecMethod_("EnumKey", Inparams,,private_oCtx)
-	
-	sNames = Outparams.sNames
-	
-
-	EnumKey = 0
-	
-End Function
-
-Function EnumValues(hDefKey,sSubKeyName, sNames,Types )	
-	Set Inparams = private_oRegSpecific.Methods_("EnumValues").Inparameters
-	
-	Inparams.hDefKey = hDefKey
-	
-	Inparams.sSubKeyName = sSubKeyName
-		
-	set Outparams = private_oRegSpecific.ExecMethod_("EnumValues", Inparams,,private_oCtx)
-	
-	sNames = Outparams.sNames
-	
-	Types = Outparams.Types
-	
-
-	EnumValues = 0
-	
-End Function
-
-Function GetBinaryValue(hDefKey,sSubKeyName,sValueName, uValue )	
-	Set Inparams = private_oRegSpecific.Methods_("GetBinaryValue").Inparameters
-	
-	Inparams.hDefKey = hDefKey
-	
-	Inparams.sSubKeyName = sSubKeyName
-	
-	Inparams.sValueName = sValueName
-		
-	set Outparams = private_oRegSpecific.ExecMethod_("GetBinaryValue", Inparams,,private_oCtx)
-	
-	uValue = Outparams.uValue
-	
-
-	GetBinaryValue = 0
-	
-End Function
-
-Function GetDWORDValue(hDefKey,sSubKeyName,sValueName, uValue )	
-	Set Inparams = private_oRegSpecific.Methods_("GetDWORDValue").Inparameters
-	
-	Inparams.hDefKey = hDefKey
-	
-	Inparams.sSubKeyName = sSubKeyName
-	
-	Inparams.sValueName = sValueName
-		
-	set Outparams = private_oRegSpecific.ExecMethod_("GetDWORDValue", Inparams,,private_oCtx)
-	
-	uValue = Outparams.uValue
-	
-
-	GetDWORDValue = 0
-	
-End Function
-
-Function GetExpandedStringValue(hDefKey,sSubKeyName,sValueName, sValue )	
-	Set Inparams = private_oRegSpecific.Methods_("GetExpandedStringValue").Inparameters
-	
-	Inparams.hDefKey = hDefKey
-	
-	Inparams.sSubKeyName = sSubKeyName
-	
-	Inparams.sValueName = sValueName
-		
-	set Outparams = private_oRegSpecific.ExecMethod_("GetExpandedStringValue", Inparams,,private_oCtx)
-	
-	sValue = Outparams.sValue
-	
-
-	GetExpandedStringValue = 0
-	
-End Function
-
-Function GetMultiStringValue(hDefKey,sSubKeyName,sValueName, sValue )	
-	Set Inparams = private_oRegSpecific.Methods_("GetMultiStringValue").Inparameters
-	
-	Inparams.hDefKey = hDefKey
-	
-	Inparams.sSubKeyName = sSubKeyName
-	
-	Inparams.sValueName = sValueName
-		
-	set Outparams = private_oRegSpecific.ExecMethod_("GetMultiStringValue", Inparams,,private_oCtx)
-	
-	sValue = Outparams.sValue
-	
-
-	GetMultiStringValue = 0
-	
-End Function
-
-Function GetQWORDValue(hDefKey,sSubKeyName,sValueName, uValue )	
-	Set Inparams = private_oRegSpecific.Methods_("GetQWORDValue").Inparameters
-	
-	Inparams.hDefKey = hDefKey
-	
-	Inparams.sSubKeyName = sSubKeyName
-	
-	Inparams.sValueName = sValueName
-		
-	set Outparams = private_oRegSpecific.ExecMethod_("GetQWORDValue", Inparams,,private_oCtx)
-	
-	uValue = Outparams.uValue
-	
-
-	GetQWORDValue = 0
-	
-End Function
-
-Function GetSecurityDescriptor(hDefKey,sSubKeyName, Descriptor )	
-	Set Inparams = private_oRegSpecific.Methods_("GetSecurityDescriptor").Inparameters
-	
-	Inparams.hDefKey = hDefKey
-	
-	Inparams.sSubKeyName = sSubKeyName
-		
-	set Outparams = private_oRegSpecific.ExecMethod_("GetSecurityDescriptor", Inparams,,private_oCtx)
-	
-	Descriptor = Outparams.Descriptor
-	
-
-	GetSecurityDescriptor = 0
-	
-End Function
-
-Function GetStringValue(hDefKey,sSubKeyName,sValueName, sValue )	
-	Set Inparams = private_oRegSpecific.Methods_("GetStringValue").Inparameters
-	
-	Inparams.hDefKey = hDefKey
-	
-	Inparams.sSubKeyName = sSubKeyName
-	
-	Inparams.sValueName = sValueName
-		
-	set Outparams = private_oRegSpecific.ExecMethod_("GetStringValue", Inparams,,private_oCtx)
-	
-	sValue = Outparams.sValue
-	
-
-	GetStringValue = 0
-	
-End Function
-
-Function SetBinaryValue(hDefKey,sSubKeyName,sValueName,uValue)	
-	Set Inparams = private_oRegSpecific.Methods_("SetBinaryValue").Inparameters
-	
-	Inparams.hDefKey = hDefKey
-	
-	Inparams.sSubKeyName = sSubKeyName
-	
-	Inparams.sValueName = sValueName
-	
-	Inparams.uValue = uValue
-		
-	set Outparams = private_oRegSpecific.ExecMethod_("SetBinaryValue", Inparams,,private_oCtx)
-	
-
-	SetBinaryValue = 0
-	
-End Function
-
-Function SetDWORDValue(hDefKey,sSubKeyName,sValueName,uValue)	
-	Set Inparams = private_oRegSpecific.Methods_("SetDWORDValue").Inparameters
-	
-	Inparams.hDefKey = hDefKey
-	
-	Inparams.sSubKeyName = sSubKeyName
-	
-	Inparams.sValueName = sValueName
-	
-	Inparams.uValue = uValue
-		
-	set Outparams = private_oRegSpecific.ExecMethod_("SetDWORDValue", Inparams,,private_oCtx)
-	
-
-	SetDWORDValue = 0
-	
-End Function
-
-Function SetExpandedStringValue(hDefKey,sSubKeyName,sValueName,sValue)	
-	Set Inparams = private_oRegSpecific.Methods_("SetExpandedStringValue").Inparameters
-	
-	Inparams.hDefKey = hDefKey
-	
-	Inparams.sSubKeyName = sSubKeyName
-	
-	Inparams.sValueName = sValueName
-	
-	Inparams.sValue = sValue
-		
-	set Outparams = private_oRegSpecific.ExecMethod_("SetExpandedStringValue", Inparams,,private_oCtx)
-	
-
-	SetExpandedStringValue = 0
-	
-End Function
-
-Function SetMultiStringValue(hDefKey,sSubKeyName,sValueName,sValue)	
-	Set Inparams = private_oRegSpecific.Methods_("SetMultiStringValue").Inparameters
-	
-	Inparams.hDefKey = hDefKey
-	
-	Inparams.sSubKeyName = sSubKeyName
-	
-	Inparams.sValueName = sValueName
-	
-	Inparams.sValue = sValue
-		
-	set Outparams = private_oRegSpecific.ExecMethod_("SetMultiStringValue", Inparams,,private_oCtx)
-	
-
-	SetMultiStringValue = 0
-	
-End Function
-
-Function SetQWORDValue(hDefKey,sSubKeyName,sValueName,uValue)	
-	Set Inparams = private_oRegSpecific.Methods_("SetQWORDValue").Inparameters
-	
-	Inparams.hDefKey = hDefKey
-	
-	Inparams.sSubKeyName = sSubKeyName
-	
-	Inparams.sValueName = sValueName
-	
-	Inparams.uValue = uValue
-		
-	set Outparams = private_oRegSpecific.ExecMethod_("SetQWORDValue", Inparams,,private_oCtx)
-	
-
-	SetQWORDValue = 0
-	
-End Function
-
-Function SetSecurityDescriptor(hDefKey,sSubKeyName,Descriptor)	
-	Set Inparams = private_oRegSpecific.Methods_("SetSecurityDescriptor").Inparameters
-	
-	Inparams.hDefKey = hDefKey
-	
-	Inparams.sSubKeyName = sSubKeyName
-	
-	Inparams.Descriptor = Descriptor
-		
-	set Outparams = private_oRegSpecific.ExecMethod_("SetSecurityDescriptor", Inparams,,private_oCtx)
-	
-
-	SetSecurityDescriptor = 0
-	
-End Function
-
-Function SetStringValue(hDefKey,sSubKeyName,sValueName,sValue)	
-	Set Inparams = private_oRegSpecific.Methods_("SetStringValue").Inparameters
-	
-	Inparams.hDefKey = hDefKey
-	
-	Inparams.sSubKeyName = sSubKeyName
-	
-	Inparams.sValueName = sValueName
-	
-	Inparams.sValue = sValue
-		
-	set Outparams = private_oRegSpecific.ExecMethod_("SetStringValue", Inparams,,private_oCtx)
-	
-
-	SetStringValue = 0
-	
-End Function

assets/scripts/node-regedit/vbs/JsonSafeTest.wsf

@@ -1,7 +0,0 @@
-<job id="JsonSafeStreamTest">
-	<script language="VBScript" src="util.vbs" />
-	<script language="VBScript">		
-		str = """" & vbcrlf & "测试\"
-		Write("{ ""a"": """ & JsonSafe(str) & """}" & vbcrlf)
-	</script>
-</job>

assets/scripts/node-regedit/vbs/regCreateKey.wsf

@@ -1,32 +0,0 @@
-<job id="createKeyStream">
-	<script language="VBScript" src="util.vbs" />
-	<script language="VBScript" src="regUtil.vbs" />
-	<script language="VBScript">
-
-		CheckZeroArgs("usage: cscript regCreateKey.wsf architecture")
-		DetermineOSArchitecture()
-		LoadRegistryImplementationByOSArchitecture()
-
-		Do While Not stdin.AtEndOfLine
-			strLine = stdin.ReadLine()			
-			strLine = unescape(trim(strLine))
-
-			If IsNull(strLine) or strLine = "" Then
-				WScript.Quit 25127
-			End If
-			
-			ParseHiveAndSubKey strLine, constHive, strSubKey
-
-			if IsNull(constHive) Then
-				WriteLineErr "unsupported hive " & strLine
-				WScript.Quit 25122
-			End If
-
-			Result = CreateKey(constHive, strSubKey)
-
-			If Not Result = 0 Then				
-				WScript.Quit Result
-			End If
-		Loop
-	</script>
-</job>

assets/scripts/node-regedit/vbs/regDeleteKey.wsf

@@ -1,29 +0,0 @@
-<job id="deleteKey">
-	<script language="VBScript" src="util.vbs" />
-	<script language="VBScript" src="regUtil.vbs" />
-	<script language="VBScript">
-
-		CheckZeroArgs("usage: cscript regDeleteKey.wsf architecture")
-		DetermineOSArchitecture()
-		LoadRegistryImplementationByOSArchitecture()
-
-		Do While Not stdin.AtEndOfLine
-			
-			strLine = stdin.ReadLine()
-			strLine = unescape(trim(strLine))
-		
-			ParseHiveAndSubKey strLine, constHive, strSubKey
-
-			if IsNull(constHive) Then
-				WriteLineErr "unsupported hive " & strLine
-				WScript.Quit 25122   
-			End If
-
-			Result = DeleteKey(constHive, strSubKey)
-
-			If Not Result = 0 Then				
-				WScript.Quit Result
-			End If
-		Loop
-	</script>
-</job>

assets/scripts/node-regedit/vbs/regDeleteValue.wsf

@@ -1,29 +0,0 @@
-<job id="deleteValue">
-	<script language="VBScript" src="util.vbs" />
-	<script language="VBScript" src="regUtil.vbs" />
-	<script language="VBScript">
-
-		CheckZeroArgs("usage: cscript regDeleteValue.wsf architecture")
-		DetermineOSArchitecture()
-		LoadRegistryImplementationByOSArchitecture()
-
-		Do While Not stdin.AtEndOfLine
-
-			strLine = stdin.ReadLine()
-			strLine = unescape(trim(strLine))
-
-			ParseHiveAndSubKeyAndValue strLine, constHive, strSubKey, strValue
-
-			if IsNull(constHive) Then
-				WriteLineErr "unsupported hive " & strLine
-				WScript.Quit 25122
-			End If
-
-			Result = DeleteValue(constHive, strSubKey, strValue)
-
-			If Not Result = 0 Then
-				WScript.Quit Result
-			End If
-		Loop
-	</script>
-</job>

assets/scripts/node-regedit/vbs/regList.wsf

@@ -1,49 +0,0 @@
-' 
-'	Lists the sub keys and values of a given registry key
-'
-'	cscript regList.wsg HKLM\Software
-'
-'	Will Yield:
-'
-'	{
-'		"hklm\software": { 
-'			"keys": [ .. array of sub keys .. ], 
-'			"values": { 
-'				"moo": { 
-'					"type": "REG_SZ", 
-'					"value": "bar"
-'				}
-'			}
-'		}
-'	}
-<job id="list">
-	<script language="VBScript" src="util.vbs" />
-	<script language="VBScript" src="regUtil.vbs" />
-	<script language="VBScript">		
-		CheckZeroArgs("usage: cscript regList.wsf architecture regpath1 [regpath2] ... [regpathN]")
-		DetermineOSArchitecture()
-		LoadRegistryImplementationByOSArchitecture()
-	
-		Write "{"
-		On Error Resume Next
-		For v = 1 To args.Count - 1
-			If (v > 1) Then
-				Write ","
-			End If
-			
-			Dim key: key = trim(args(v))
-
-			Write """" & JsonSafe(key) & """: "
-			
-			ParseHiveAndSubKey key, constHive, strSubKey
-			
-			If IsNull(constHive) Then
-				WriteLineErr "unsupported hive " & args(v)
-				WScript.Quit 25122       
-			End If
-
-			ListChildrenAsJson constHive, strSubKey
-		Next
-		Write "}"
-	</script>
-</job>

assets/scripts/node-regedit/vbs/regListStream.wsf

@@ -1,46 +0,0 @@
-' 
-'	Lists the sub keys and values of a given registry key, this script is slightly different
-'	than regList because it reads stdin for the keys to list
-'
-'	echo HKLM\Software | cscript regListStream.wsf A
-'
-'	Will Yield:
-'
-'	{
-'		"hklm\software": { 
-'			"keys": [ .. array of sub keys .. ], 
-'			"values": { 
-'				"moo": { 
-'					"type": "REG_SZ", 
-'					"value": "bar"
-'				}
-'			}
-'		}
-'	}
-<job id="listStream">
-	<script language="VBScript" src="util.vbs" />
-	<script language="VBScript" src="regUtil.vbs" />
-	<script language="VBScript">		
-		CheckZeroArgs("usage: echo KEY | cscript regListStream.wsf architecture")
-		DetermineOSArchitecture()
-		LoadRegistryImplementationByOSArchitecture()
-		
-		Do While Not stdin.AtEndOfLine
-
-			strLine = stdin.ReadLine()
-			strLine = unescape(trim(strLine))
-		
-			ParseHiveAndSubKey strLine, constHive, strSubKey
-
-			if IsNull(constHive) Then
-				WriteLineErr "unsupported hive " & strLine
-				WScript.Quit 25122       
-			End If
-
-			Write "{ ""key"" : """ & JsonSafe(strLine) & """, ""data"": "
-			ListChildrenAsJson constHive, strSubKey
-			Write "}" & vbcrlf
-		Loop
-
-	</script>
-</job>

assets/scripts/node-regedit/vbs/regPutValue.wsf

@@ -1,56 +0,0 @@
-<job id="putValue">
-	<script language="VBScript" src="util.vbs" />
-	<script language="VBScript" src="regUtil.vbs" />
-	<script language="VBScript">
-		usage = "usage: cscript regPutValue.wsf architecture" & vbNewLine _
-					& "types: REG_SZ, REG_EXPAND_SZ, REG_BINARY, REG_DWORD, REG_MULTI_SZ, REG_QWORD"
-
-		CheckZeroArgs(usage)
-		DetermineOSArchitecture()
-		LoadRegistryImplementationByOSArchitecture()
-
-		ReadCount = 0
-		Dim lineArgs(3)
-
-		Do While Not stdin.AtEndOfLine
-			strLine = stdin.ReadLine()
-			strLine = unescape(trim(strLine))
-
-			If IsNull(strLine) or strLine = "" Then
-				WScript.Quit 25127
-			End If
-
-			lineArgs(ReadCount) = strLine
-			
-			ReadCount = ReadCount + 1
-
-			If ReadCount = 4 Then
-
-				ParseHiveAndSubKey lineArgs(0), constHive, strSubKey
-				
-				if IsNull(constHive) Then
-					WriteLineErr "unsupported hive " & lineArgs(0)
-					WScript.Quit 25122
-				End If
-
-				strValueName = lineArgs(1)
-				strValue = lineArgs(2)
-				strType = lineArgs(3)
-				
-				Result = PutValue(constHive, strSubKey, strValueName, strValue, strType)
-
-				If Not Result = 0 Then
-					WriteLineErr "error while putting value: " & result
-					WScript.Quit Result
-				End If
-
-				ReadCount = 0
-				Erase lineArgs				
-			End If
-		Loop
-
-		If ReadCount <> 0 Then
-			WScript.Quit 25123
-		End If
-	</script>
-</job>

assets/scripts/node-regedit/vbs/regUtil.vbs

@@ -1,358 +0,0 @@
-' TODO: consider incorporating a json writer of some sort instead of adhoc solution like the following
-' e.g: http://demon.tw/my-work/vbs-json.html
-
-const HKEY_CLASSES_ROOT = &H80000000
-const HKEY_CURRENT_USER = &H80000001
-const HKEY_LOCAL_MACHINE = &H80000002
-const HKEY_USERS = &H80000003
-const HKEY_CURRENT_CONFIG = &H80000005
-
-Sub LoadRegistryImplementationByOSArchitecture()
-	If IsNull(OSArchitecture) Then
-		WriteLineErr "missing OSArchitecture global. did not call util.DetermineOSArchitecture? or Forgot to load util.vbs?"
-		WScript.Quit 25125		
-	End If
-
-	If OSArchitecture = "A" Then
-		Include "ArchitectureAgnosticRegistry.vbs"
-	Else
-		Include "ArchitectureSpecificRegistry.vbs"
-	End If
-End Sub 
-
-Function PutValue(constHive, strSubKey, strValueName, strValue, strType)
-	Select Case UCase(strType)
-		
-		Case "REG_SZ"
-			PutValue = SetStringValue(constHive, strSubKey, strValueName, strValue)
-
-		Case "REG_EXPAND_SZ"
-			PutValue = SetExpandedStringValue(constHive, strSubKey, strValueName, strValue)
-
-		Case "REG_BINARY"
-			PutValue = SetBinaryValue(constHive, strSubKey, strValueName, ToBinaryValue(strValue))
-
-		Case "REG_NONE"
-			PutValue = SetBinaryValue(constHive, strSubKey, strValueName, ToBinaryValue(strValue))
-
-		' TODO: need to check that indeed int is the right type here
-		Case "REG_DWORD"
-			PutValue = SetDWORDValue(constHive, strSubKey, strValueName, CDbl(strValue))
-
-		Case "REG_MULTI_SZ"
-			PutValue = SetMultiStringValue(constHive, strSubKey, strValueName, Split(strValue, ","))
-
-		Case "REG_QWORD"
-			PutValue = SetQWORDValue(constHive, strSubKey, strValueName, strValue)
-
-		Case "REG_DEFAULT"
-			PutValue = SetStringValue(constHive, strSubKey, "", strValue)
-
-		Case Else
-			PutValue = SetStringValue(constHive, strSubKey, strValueName, strValue)
-
-	End Select
-End Function
-
-' render the child of a sub path strSubKey in hive constHive
-' as json.
-Sub ListChildrenAsJson(constHive, strSubKey)
-	' start outputting json to stdout
-	Write "{"
-
-	Dim e1: e1 = EnumKey (constHive, strSubKey, arrKeyNames)
-	If e1 <> 0 Then
-		Write """exists"": false,"
-		Dim arrValueNames: arrValueNames = null
-	Else
-		Write """exists"": true,"
-
-		Dim e2: e2 = EnumValues (constHive, strSubKey, arrValueNames, arrValueTypes)
-		If e2 <> 0 Then
-			WScript.Quit e2
-		End If
-	End If
-
-	Write """keys"": ["
-	If Not IsNull(arrKeyNames) Then
-		For x = 0 To UBound(arrKeyNames)
-			If (x > 0) Then
-				Write ","
-			End If
-	
-			Write """" & JsonSafe(arrKeyNames(x)) & """"
-		Next
-	End If
-	Write "],"
-	' TODO: some duplicity of code between the two paths of this condition, this needs to be address at some point
-	Write """values"":{"
-	If Not IsNull(arrValueNames) Then
-		For y = 0 To UBound(arrValueNames)
-			If y > 0 Then
-				Write ","
-			End If
-
-			strValueName = arrValueNames(y)
-			intValueType = arrValueTypes(y)
-			
-			' assign the value to varValue
-			GetValueByType constHive, strSubKey, strValueName, intValueType, varValue
-			
-			WriteValue strValueName, intValueType, varValue
-		Next
-	Else
-		' fix for keys with only default values in them
-		' see http://stackoverflow.com/questions/8840343/how-to-read-the-default-value-from-registry-in-vbscript
-		GetStringValue constHive, strSubKey, "", strDefaultValue
-
-		If IsNull(strDefaultValue) = false and strDefaultValue <> "" Then
-			' write the default value with REG_SZ
-			WriteValue "", 1, strDefaultValue
-		End If
-	End If
-	Write "}}"	
-End Sub
-
-Sub WriteValue (strValueName, intValueType, varValue)
-	Write """"  
-	Write JsonSafe(strValueName)
-	Write """:{"
-	Write """type"": """
-	Write RenderType(intValueType)
-	Write ""","
-	Write """value"":"
-	Write RenderValueByType(intValueType, varValue)
-	Write "}"
-End Sub
-
-' give a raw HKLM\something\somewhere
-' output the hive constant and the subkey, in this case:
-' HKEY_LOCAL_MACHINE will be assigned to outConstHive
-' and something\somewhere will be assigned to outStrSubKey
-Sub ParseHiveAndSubKey(strRawKey, outConstHive, outStrSubKey)	
-	' split into two parts to deduce the hive and the sub key
-	arrSplitted = Split(strRawKey, "\", 2, 1)
-	
-	If UBound(arrSplitted) > 0 Then
-		strHive = arrSplitted(0)	
-		outStrSubKey = arrSplitted(1)
-	Else
-		strHive = strRawKey
-		outStrSubKey = ""
-	End If
-
-	outConstHive = StringToHiveConst(UCase(strHive))
-End Sub
-
-Function ArrayRemoveAt(arr, pos)
-	Dim i
-	If IsArray(arr) Then
-		If pos >= 0 And pos <= UBound(arr) Then
-			For i = pos To UBound(arr) - 1
-				arr(i) = arr(i + 1)
-			Next
-			ReDim Preserve arr(UBound(arr) - 1)
-		End If
-	End If
-End Function
-
-Sub ParseHiveAndSubKeyAndValue(strRawKey, outConstHive, outStrSubKey, outStrValue)
-	' split into two parts to deduce the hive and the sub key
-	arrSplitted = Split(strRawKey, "\", -1, 1)
-  
-  If UBound(arrSplitted) > 0 Then
-		strHive = arrSplitted(0)
-		outStrValue = arrSplitted(UBound(arrSplitted))
-		test = ArrayRemoveAt(arrSplitted, UBound(arrSplitted))
-		test = ArrayRemoveAt(arrSplitted, 0)
-		outStrSubKey = Join(arrSplitted, "\")
-	Else
-		strHive = strRawKey
-		outStrSubKey = ""
-	End If
-
-	outConstHive = StringToHiveConst(UCase(strHive))
-End Sub
-
-Function StringToHiveConst(strHive)
-	
-	Select Case strHive
-		Case "HKCR"
-			StringToHiveConst = HKEY_CLASSES_ROOT
-		Case "HKCU"
-			StringToHiveConst = HKEY_CURRENT_USER
-		Case "HKLM"
-			StringToHiveConst = HKEY_LOCAL_MACHINE
-		Case "HKU"
-			StringToHiveConst = HKEY_USERS
-		Case "HKCC"
-			StringToHiveConst = HKEY_CURRENT_CONFIG
-		Case Else
-			StringToHiveConst = Null	
-	End Select	
-
-End Function
-
-' TODO: this entire "by type" should be transformed into OOP style
-' where each type will have a class with render(), getValue() etc...
-
-' convert a value type number into a string label
-Function RenderType(intType)
-	RenderType = "REG_UNKNOWN"
-
-	Select Case intType
-		Case 0
-			RenderType = "REG_NONE"
-		Case 1
-			RenderType = "REG_SZ"
-		Case 2
-			RenderType = "REG_EXPAND_SZ"
-		Case 3
-			RenderType = "REG_BINARY"
-		Case 4
-			RenderType = "REG_DWORD"
-		Case 7
-			RenderType = "REG_MULTI_SZ"
-		Case 11	
-			RenderType = "REG_QWORD"
-		Case Else
-			' TODO: should report / throw an error here
-			WriteErr("invalid Registry Value Type " & intType)
-
-	End Select
-
-End Function
-
-' render by value type:
-' string will return as a string with double quotes, e.g "value"
-' multi string values which return as an array ot strings "["1", "2"]" (double quotes included ofc)
-' numeric values like DWORD and QWORD just return as the number e.g. 1
-' byte arrays such as reg_binary return as an array of ints, e.g [1,2,3]
-Function RenderValueByType(intType, varValue)
-
-	Select Case intType
-		' REG_NONE
-		Case 0
-			RenderValueByType = "0"
-
-		' REG_SZ
-		Case 1
-			RenderValueByType = """" & JsonSafe(varValue) & """"
-
-		' REG_EXPAND_SZ
-		Case 2
-			RenderValueByType = """" & JsonSafe(varValue) & """"
-
-		' REG_BINARY
-		Case 3
-			RenderValueByType = RenderByteArray(varValue)
-
-		' REG_DWORD
-		Case 4
-			RenderValueByType= varValue
-
-		' REG_MULYI_SZ'
-		Case 7
-
-			RenderValueByType = RenderStringArray(varValue)
-		' REG_QWORD
-		Case 11
-			RenderValueByType = varValue
-		Case Else
-			' TODO: should report / throw an error here
-			WriteErr("invalid Registry Value Type " & intType)
-	End Select
-
-End Function
-
-' get the value of a registry based on its value type and assign it to out parameter outVarValue
-Sub GetValueByType(constHive, strKey, strValueName, intType, outVarValue)
-
-	Select Case intType
-		' REG_NONE
-		Case 0
-			GetStringValue constHive, strKey, strValueName, "0"
-			Exit Sub
-
-		' REG_SZ
-		Case 1
-			GetStringValue constHive, strKey, strValueName, outVarValue
-			Exit Sub
-
-		' REG_EXPAND_SZ
-		Case 2
-			GetExpandedStringValue constHive, strKey, strValueName, outVarValue			
-			Exit Sub
-			
-		' REG_BINARY
-		Case 3
-			GetBinaryValue constHive, strKey, strValueName, outVarValue
-			Exit Sub
-			
-		' REG_DWORD
-		Case 4
-			GetDWORDValue constHive, strKey, strValueName, outVarValue
-
-			' #21 - VBS does not support UInt32. This is the workaround
-			If outVarValue < 0 Then outVarValue = 4294967296 + outVarValue
-
-			Exit Sub
-			
-		' REG_MULYI_SZ'
-		Case 7
-			GetMultiStringValue constHive, strKey, strValueName, outVarValue
-			Exit Sub
-			
-		' REG_QWORD
-		Case 11	
-			GetQWORDValue constHive, strKey, strValueName, outVarValue
-			Exit Sub
-		
-		Case Else
-			' TODO: should report / throw an error here
-			WriteErr("invalid Registry Value Type " & intType)	
-	End Select
-
-End Sub
-
-' render a byte array as a json array of numbers
-Function RenderByteArray(arr)
-	RenderByteArray = "[]"
-
-	If Not IsNull(arr) Then		
-		RenderByteArray = "[" & Join(arr, ",") & "]"
-	End If
-End Function
-
-' render a string array as json string array
-Function RenderStringArray(arr)	
-	Result = "["
-	If Not IsNull(arr) Then
-		For t = 0 To UBound(arr)
-			If (t > 0) Then
-				Result = Result &  ","
-			End If
-
-			Result = Result & """" & JsonSafe(arr(t)) & """"
-		Next
-	End If
-	Result = Result & "]"
-
-	RenderStringArray = Result
-End Function
-
-Function ToBinaryValue(strValue)
-
-	arrValue = Split(strValue, ",")
-	
-	If IsNull(arrValue) Then		
-		ToBinaryValue = Array()
-		Exit Function
-	End If
-
-	For i = 0 To UBound(arrValue)
-		arrValue(i) = CInt(arrValue(i))
-	Next
-
-	ToBinaryValue = arrValue
-End Function

assets/scripts/node-regedit/vbs/util.vbs

@@ -1,162 +0,0 @@
-Set stdout = WScript.StdOut
-Set stderr = WScript.StdErr
-Set stdin = WScript.StdIn
-Set args = WScript.Arguments
-Set fs = CreateObject("scripting.filesystemobject") 
-Dim OSArchitecture
-
-Sub WriteErr(message)
-	stderr.Write message
-End Sub
-
-Sub WriteLineErr(message)
-	stderr.WriteLine message
-End Sub
-
-Sub Write(message)
-	stdout.Write message
-End Sub
-
-Sub WriteLine(message)
-	stdout.WriteLine message
-End Sub
-
-Function IndexOf(varNeedle, arrHaystack)
-	IndexOf = -1
-	
-	If Not IsArray(arrHaystack)	 Then
-		Exit Function
-	End If
-
-	For xyz = 0 To UBound(arrHaystack)
-		If arrHaystack(xyz) = varNeedle Then
-			IndexOf = xyz
-			Exit Function
-		End If
-	Next
-End Function
-
-Sub CheckZeroArgs(message)
-	' bail if args are missing
-	If args.Count = 0 Then
-		WriteLineErr message
-		WScript.Quit 25121
-	End If
-End Sub
-
-Dim ALLOWED_OS_ARCHITECTURE_VALUES: ALLOWED_OS_ARCHITECTURE_VALUES = Array("S", "A", "32", "64")
-
-'
-'	determine the architecture of the operating system, that will be used. there are 4 possibilities:
-'	A - means agnostic
-'	S - means that we want to use a specific architecture, but auto detect Item
-'	32 - explicitly use 32 bit architecture
-'	64 - explicitly use 64 bit architecture
-'
-Sub DetermineOSArchitecture()
-	strArchitecture = args(0)
-
-	If IsNull(strArchitecture) Then
-		WriteLineErr "missing architecture argument"
-		WScript.Quit 25124
-	End If
-
-	strArchitecture = UCase(strArchitecture)
-
-	If IndexOf(strArchitecture, ALLOWED_OS_ARCHITECTURE_VALUES) = -1 Then
-		WriteLineErr "invalid architecture argument"
-		WScript.Quit 25124
-	End If
-
-	If (strArchitecture = "S") Then
-		OSArchitecture = GetOSArchitecture()
-		If OSArchitecture = -1 Then
-			WriteLineErr "invalid os architecture detected " & OSArchitecture
-			WScript.Quit 25126
-		End If
-	Else
-		OSArchitecture = strArchitecture
-	End If
-
-End Sub
-
-Sub Include(sPath)
-	' TODO this is fragile, but should work for "modules" nested relatively to script root
-	include_ScriptPath = Left(WScript.ScriptFullName, InStr(WScript.ScriptFullName, WScript.ScriptName) - 2)	
-	sPath = include_ScriptPath & "\" & sPath
-	
-	include_code = fs.OpenTextFile(sPath).ReadAll 	
-	ExecuteGlobal include_code
-End Sub
-
-Function GetOSArchitecture()
-
-	Dim ObjWMI, ColSettings, ObjProcessor 
-	Dim StrComputer, ObjNetwork 
-	
-	Set ObjWMI = GetObject("winmgmts:\Root\CIMV2") 
-	Set ColSettings = ObjWMI.ExecQuery ("SELECT DataWidth, AddressWidth, Architecture FROM Win32_Processor") 
-
-	' TODO: I make two assumptions here: 
-	' 1. Eveyone will have CPU0 device
-	' 2. There is only one cpu defined in the wmi database (and if not, then they are all of the same architecture)
-	Set ObjProcessor = ColSettings.Item("Win32_Processor.DeviceID=""CPU0""")
-
-	If ObjProcessor.Architecture = 0 AND ObjProcessor.AddressWidth = 32 Then 
-		GetOSArchitecture = 32
-	ElseIf (ObjProcessor.Architecture = 6 OR ObjProcessor.Architecture = 9) AND ObjProcessor.DataWidth = 64 AND ObjProcessor.AddressWidth = 32 Then 
-		GetOSArchitecture = 32
-	ElseIf (ObjProcessor.Architecture = 6 OR ObjProcessor.Architecture = 9) AND ObjProcessor.DataWidth = 64 AND ObjProcessor.AddressWidth = 64 Then 
-		GetOSArchitecture = 64
-	Else		
-		GetOSArchitecture = -1
-	End If 
-	
-End Function
-
-Function JsonSafe(inStrText)
-	If inStrText = "" Then
-		JsonSafe = ""
-		Exit Function 
-	End If
-	Dim outStrText: outStrText = inStrText
-	outStrText = Replace(outStrText, "\", "\\")
-	outStrText = Replace(outStrText, vbcrlf, "\\r\\n")
-	outStrText = Replace(outStrText, vblf, "\\n")
-	outStrText = Replace(outStrText, vbcr, "\\r")
-	outStrText = Replace(outStrText, """", "\""")	
-	outStrText = JsonU(outStrText)
-	JsonSafe = outStrText
-End Function
-
-'TODO: need to change this function's name to something more appropriate
-Function JsonU(astr)
-	
-	If isNull(astr) Then
-		JsonU = ""
-		Exit Function
-	End If
-
-	Dim c 
-	Dim utftext: utftext = ""
-	
-	For n = 1 To Len(astr)
-		c = CLng(AscW(Mid(astr, n, 1)))
-
-		If c < 0 Then
-			c = &H10000 + c
-		End If
-
-		If c < &H80 Then
-			utftext = utftext & Mid(astr, n, 1)
-		ElseIf c < &H100 Then
-			utftext = utftext & "\u00" & Hex(c)
-		ElseIf c < &H1000 Then
-			utftext = utftext & "\u0" & Hex(c)
-		Else
-			utftext = utftext & "\u" & Hex(c)
-		End If
-	Next
-
-	JsonU = utftext
-End Function

assets/scripts/node-regedit/vbs/wsRegReadList.wsf

@@ -1,52 +0,0 @@
-' 
-'	Lists the values of a given registry path, this script takes its input from stdin
-'
-'	cscript regListStream.wsf A "HKCU\\Software\\Microsoft\\Windows\\CurrentVersion\\Explorer\\User Shell Folders\\AppData"
-'
-'	Will Yield:
-'
-'	{
-'		"HKCU\\Software\\Microsoft\\Windows\\CurrentVersion\\Explorer\\User Shell Folders\\AppData": "value here"
-'	}
-<job id="regRead">
-	<script language="VBScript" src="util.vbs" />
-	<script language="VBScript" src="regUtil.vbs" />
-	<script language="VBScript">
-		CheckZeroArgs("usage: cscript wsRegRead.wsf architecture path1...pathN")
-		DetermineOSArchitecture()
-		LoadRegistryImplementationByOSArchitecture()
-		
-		set ws = createobject("Wscript.shell")
-	
-		Write "["
-		On Error Resume Next
-		For v = 1 To args.Count - 1
-			If (v > 1) Then
-				Write ","
-			End If
-
-			Dim key: key = trim(args(v))
-			
-			' not really needed except for validation
-			ParseHiveAndSubKeyAndValue key, constHive, strSubKey, strValue
-
-			if IsNull(constHive) Then
-				WriteLineErr "unsupported hive " & args(v)
-				WScript.Quit 25122
-			End If
-			
-			Write "{ ""path"" : """ & JsonSafe(key) & """, "
-			
-			Dim result:	result = ws.RegRead(args(v))
-			Dim exists: exists = "true"
-
-			If Err.Number <> 0 Then
-				exists = "false"
-			End if
-
-			Write """exists"": " & exists & ", "
-			Write """value"": """ &  JsonSafe(result) & """}" & vbcrlf
-		Next
-		Write "]"
-	</script>
-</job>

assets/scripts/node-regedit/vbs/wsRegReadListStream.wsf

@@ -1,47 +0,0 @@
-' 
-'	Lists the values of a given registry path, this script takes its input from stdin
-'
-'	echo HKCU\\Software\\Microsoft\\Windows\\CurrentVersion\\Explorer\\User Shell Folders\\AppData | cscript regListStream.wsf A
-'
-'	Will Yield:
-'
-'	{
-'		"HKCU\\Software\\Microsoft\\Windows\\CurrentVersion\\Explorer\\User Shell Folders\\AppData": "value here"
-'	}
-<job id="regRead">
-	<script language="VBScript" src="util.vbs" />
-	<script language="VBScript" src="regUtil.vbs" />
-	<script language="VBScript">
-		CheckZeroArgs("usage: echo KEY | cscript wsRegRead.wsf architecture")
-		DetermineOSArchitecture()
-		LoadRegistryImplementationByOSArchitecture()
-		
-		set ws = createobject("Wscript.shell")
-	
-		Do While Not stdin.AtEndOfLine
-
-			strLine = stdin.ReadLine()
-			strLine = unescape(trim(strLine))
-		
-			' not really needed except for validation
-			ParseHiveAndSubKeyAndValue strLine, constHive, strSubKey, strValue
-
-			if IsNull(constHive) Then
-				WriteLineErr "unsupported hive " & strLine
-				WScript.Quit 25122       
-			End If
-			
-			Write "{ ""path"" : """ & JsonSafe(strLine) & """, "
-
-			Dim result: result = ws.RegRead(strLine)
-			Dim exists: exists = "true"
-
-			If Err.Number <> 0 Then
-				exists = "false"
-			End if
-			
-			Write """exists"": " & exists & ", "
-			Write """value"": """ &  JsonSafe(result) & """}" & vbcrlf
-		Loop
-	</script>
-</job>

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.