update to v1.4.1

- the modal needs to appear above
- instead, move the titlebar controls z-index under the fullscreen players

.dockerignore

@@ -0,0 +1,3 @@
+node_modules
+Dockerfile
+docker-compose.*

.editorconfig

@@ -1,12 +1,9 @@
 root = true
 
 [*]
-indent_style = space
-indent_size = 2
-end_of_line = lf
 charset = utf-8
-trim_trailing_whitespace = true
+indent_style = space
+indent_size = 4
+end_of_line = lf
 insert_final_newline = true
-
-[*.md]
-trim_trailing_whitespace = false
+trim_trailing_whitespace = true

.erb/configs/.eslintrc

@@ -1,7 +0,0 @@
-{
-  "rules": {
-    "no-console": "off",
-    "global-require": "off",
-    "import/no-dynamic-require": "off"
-  }
-}

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

@@ -1,59 +0,0 @@
-/**
- * Base webpack config used across other specific configs
- */
-
-import webpack from 'webpack';
-import { dependencies as externals } from '../../release/app/package.json';
-import webpackPaths from './webpack.paths';
-import { TsconfigPathsPlugin } from 'tsconfig-paths-webpack-plugin';
-
-const configuration: webpack.Configuration = {
-  externals: [...Object.keys(externals || {})],
-
-  module: {
-    rules: [
-      {
-        exclude: /node_modules/,
-        test: /\.[jt]sx?$/,
-        use: {
-          loader: 'ts-loader',
-          options: {
-            // Remove this line to enable type checking in webpack builds
-            transpileOnly: true,
-          },
-        },
-      },
-    ],
-  },
-
-  output: {
-    // https://github.com/webpack/webpack/issues/1114
-    library: {
-      type: 'commonjs2',
-    },
-
-    path: webpackPaths.srcPath,
-  },
-
-  plugins: [
-    new webpack.EnvironmentPlugin({
-      NODE_ENV: 'production',
-    }),
-  ],
-
-  /**
-   * Determine the array of extensions that should be used to resolve modules.
-   */
-  resolve: {
-    extensions: ['.js', '.jsx', '.json', '.ts', '.tsx'],
-    fallback: {
-      child_process: false,
-    },
-    plugins: [new TsconfigPathsPlugin({ baseUrl: webpackPaths.srcPath })],
-    modules: [webpackPaths.srcPath, 'node_modules'],
-  },
-
-  stats: 'errors-only',
-};
-
-export default configuration;

.erb/configs/webpack.config.eslint.ts

@@ -1,3 +0,0 @@
-/* eslint import/no-unresolved: off, import/no-self-import: off */
-
-module.exports = require('./webpack.config.renderer.dev').default;

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

@@ -1,84 +0,0 @@
-/**
- * Webpack config for production electron main process
- */
-
-import path from 'path';
-
-import TerserPlugin from 'terser-webpack-plugin';
-import webpack from 'webpack';
-import { BundleAnalyzerPlugin } from 'webpack-bundle-analyzer';
-import { merge } from 'webpack-merge';
-
-import checkNodeEnv from '../scripts/check-node-env';
-import deleteSourceMaps from '../scripts/delete-source-maps';
-import baseConfig from './webpack.config.base';
-import webpackPaths from './webpack.paths';
-
-checkNodeEnv('production');
-deleteSourceMaps();
-
-const devtoolsConfig =
-  process.env.DEBUG_PROD === 'true'
-    ? {
-        devtool: 'source-map',
-      }
-    : {};
-
-const configuration: webpack.Configuration = {
-  ...devtoolsConfig,
-
-  mode: 'production',
-
-  target: 'electron-main',
-
-  entry: {
-    main: path.join(webpackPaths.srcMainPath, 'main.ts'),
-    preload: path.join(webpackPaths.srcMainPath, 'preload.ts'),
-  },
-
-  output: {
-    path: webpackPaths.distMainPath,
-    filename: '[name].js',
-  },
-
-  optimization: {
-    minimizer: [
-      new TerserPlugin({
-        parallel: true,
-      }),
-    ],
-  },
-
-  plugins: [
-    new BundleAnalyzerPlugin({
-      analyzerMode: process.env.ANALYZE === 'true' ? 'server' : 'disabled',
-    }),
-
-    /**
-     * Create global constants which can be configured at compile time.
-     *
-     * Useful for allowing different behaviour between development builds and
-     * release builds
-     *
-     * NODE_ENV should be production so that modules do not perform certain
-     * development checks
-     */
-    new webpack.EnvironmentPlugin({
-      NODE_ENV: 'production',
-      DEBUG_PROD: false,
-      START_MINIMIZED: false,
-    }),
-  ],
-
-  /**
-   * 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.preload.dev.ts

@@ -1,70 +0,0 @@
-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-preload',
-
-  entry: path.join(webpackPaths.srcMainPath, 'preload.ts'),
-
-  output: {
-    path: webpackPaths.dllPath,
-    filename: 'preload.js',
-  },
-
-  plugins: [
-    new BundleAnalyzerPlugin({
-      analyzerMode: process.env.ANALYZE === 'true' ? 'server' : 'disabled',
-    }),
-
-    /**
-     * Create global constants which can be configured at compile time.
-     *
-     * Useful for allowing different behaviour between development builds and
-     * release builds
-     *
-     * NODE_ENV should be production so that modules do not perform certain
-     * development checks
-     *
-     * By default, use 'development' as NODE_ENV. This can be overriden with
-     * 'staging', for example, by changing the ENV variables in the npm scripts
-     */
-    new webpack.EnvironmentPlugin({
-      NODE_ENV: 'development',
-    }),
-
-    new webpack.LoaderOptionsPlugin({
-      debug: true,
-    }),
-  ],
-
-  /**
-   * 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,
-  },
-
-  watch: true,
-};
-
-export default merge(baseConfig, configuration);

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

@@ -1,79 +0,0 @@
-/**
- * Builds the DLL for development electron renderer process
- */
-
-import path from 'path';
-
-import webpack from 'webpack';
-import { merge } from 'webpack-merge';
-
-import { dependencies } from '../../package.json';
-import checkNodeEnv from '../scripts/check-node-env';
-import baseConfig from './webpack.config.base';
-import webpackPaths from './webpack.paths';
-
-checkNodeEnv('development');
-
-const dist = webpackPaths.dllPath;
-
-const configuration: webpack.Configuration = {
-  context: webpackPaths.rootPath,
-
-  devtool: 'eval',
-
-  mode: 'development',
-
-  target: 'electron-renderer',
-
-  externals: ['fsevents', 'crypto-browserify'],
-
-  /**
-   * Use `module` from `webpack.config.renderer.dev.js`
-   */
-  module: require('./webpack.config.renderer.dev').default.module,
-
-  entry: {
-    renderer: Object.keys(dependencies || {}),
-  },
-
-  output: {
-    path: dist,
-    filename: '[name].dev.dll.js',
-    library: {
-      name: 'renderer',
-      type: 'var',
-    },
-  },
-
-  plugins: [
-    new webpack.DllPlugin({
-      path: path.join(dist, '[name].json'),
-      name: '[name]',
-    }),
-
-    /**
-     * Create global constants which can be configured at compile time.
-     *
-     * Useful for allowing different behaviour between development builds and
-     * release builds
-     *
-     * NODE_ENV should be production so that modules do not perform certain
-     * development checks
-     */
-    new webpack.EnvironmentPlugin({
-      NODE_ENV: 'development',
-    }),
-
-    new webpack.LoaderOptionsPlugin({
-      debug: true,
-      options: {
-        context: webpackPaths.srcPath,
-        output: {
-          path: webpackPaths.dllPath,
-        },
-      },
-    }),
-  ],
-};
-
-export default merge(baseConfig, configuration);

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

@@ -1,186 +0,0 @@
-import 'webpack-dev-server';
-import { execSync, spawn } from 'child_process';
-import fs from 'fs';
-import path from 'path';
-
-import ReactRefreshWebpackPlugin from '@pmmmwh/react-refresh-webpack-plugin';
-import chalk from 'chalk';
-import HtmlWebpackPlugin from 'html-webpack-plugin';
-import webpack from 'webpack';
-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 port = process.env.PORT || 4343;
-const manifest = path.resolve(webpackPaths.dllPath, 'renderer.json');
-// eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-const requiredByDLLConfig = module.parent!.filename.includes('webpack.config.renderer.dev.dll');
-
-/**
- * Warn if the DLL is not built
- */
-if (!requiredByDLLConfig && !(fs.existsSync(webpackPaths.dllPath) && fs.existsSync(manifest))) {
-  console.log(
-    chalk.black.bgYellow.bold(
-      'The DLL files are missing. Sit back while we build them for you with "npm run build-dll"',
-    ),
-  );
-  execSync('npm run postinstall');
-}
-
-const configuration: webpack.Configuration = {
-  devtool: 'inline-source-map',
-
-  mode: 'development',
-
-  target: ['web', 'electron-renderer'],
-
-  entry: [
-    `webpack-dev-server/client?http://localhost:${port}/dist`,
-    'webpack/hot/only-dev-server',
-    path.join(webpackPaths.srcRendererPath, 'index.tsx'),
-  ],
-
-  output: {
-    path: webpackPaths.distRendererPath,
-    publicPath: '/',
-    filename: 'renderer.dev.js',
-    library: {
-      type: 'umd',
-    },
-  },
-
-  module: {
-    rules: [
-      {
-        test: /\.s?css$/,
-        use: [
-          'style-loader',
-          {
-            loader: 'css-loader',
-            options: {
-              modules: true,
-              sourceMap: true,
-              importLoaders: 1,
-            },
-          },
-          'sass-loader',
-        ],
-        include: /\.module\.s?(c|a)ss$/,
-      },
-      {
-        test: /\.s?css$/,
-        use: ['style-loader', 'css-loader', 'sass-loader'],
-        exclude: /\.module\.s?(c|a)ss$/,
-      },
-      // Fonts
-      {
-        test: /\.(woff|woff2|eot|ttf|otf)$/i,
-        type: 'asset/resource',
-      },
-      // Images
-      {
-        test: /\.(png|svg|jpg|jpeg|gif)$/i,
-        type: 'asset/resource',
-      },
-    ],
-  },
-  plugins: [
-    ...(requiredByDLLConfig
-      ? []
-      : [
-          new webpack.DllReferencePlugin({
-            context: webpackPaths.dllPath,
-            manifest: require(manifest),
-            sourceType: 'var',
-          }),
-        ]),
-
-    new webpack.NoEmitOnErrorsPlugin(),
-
-    /**
-     * Create global constants which can be configured at compile time.
-     *
-     * Useful for allowing different behaviour between development builds and
-     * release builds
-     *
-     * NODE_ENV should be production so that modules do not perform certain
-     * development checks
-     *
-     * By default, use 'development' as NODE_ENV. This can be overriden with
-     * 'staging', for example, by changing the ENV variables in the npm scripts
-     */
-    new webpack.EnvironmentPlugin({
-      NODE_ENV: 'development',
-    }),
-
-    new webpack.LoaderOptionsPlugin({
-      debug: true,
-    }),
-
-    new ReactRefreshWebpackPlugin(),
-
-    new HtmlWebpackPlugin({
-      filename: path.join('index.html'),
-      template: path.join(webpackPaths.srcRendererPath, 'index.ejs'),
-      minify: {
-        collapseWhitespace: true,
-        removeAttributeQuotes: true,
-        removeComments: true,
-      },
-      isBrowser: false,
-      env: process.env.NODE_ENV,
-      isDevelopment: process.env.NODE_ENV !== 'production',
-      nodeModules: webpackPaths.appNodeModulesPath,
-    }),
-  ],
-
-  node: {
-    __dirname: false,
-    __filename: false,
-  },
-
-  devServer: {
-    port,
-    compress: true,
-    hot: true,
-    headers: { 'Access-Control-Allow-Origin': '*' },
-    static: {
-      publicPath: '/',
-    },
-    historyApiFallback: {
-      verbose: true,
-    },
-    setupMiddlewares(middlewares) {
-      console.log('Starting preload.js builder...');
-      const preloadProcess = spawn('npm', ['run', 'start:preload'], {
-        shell: true,
-        stdio: 'inherit',
-      })
-        .on('close', (code: number) => process.exit(code!))
-        .on('error', (spawnError) => console.error(spawnError));
-
-      console.log('Starting Main Process...');
-      spawn('npm', ['run', 'start:main'], {
-        shell: true,
-        stdio: 'inherit',
-      })
-        .on('close', (code: number) => {
-          preloadProcess.kill();
-          process.exit(code!);
-        })
-        .on('error', (spawnError) => console.error(spawnError));
-      return middlewares;
-    },
-  },
-};
-
-export default merge(baseConfig, configuration);

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

@@ -1,131 +0,0 @@
-/**
- * Build config for electron renderer process
- */
-
-import path from 'path';
-
-import CssMinimizerPlugin from 'css-minimizer-webpack-plugin';
-import HtmlWebpackPlugin from 'html-webpack-plugin';
-import MiniCssExtractPlugin from 'mini-css-extract-plugin';
-import TerserPlugin from 'terser-webpack-plugin';
-import webpack from 'webpack';
-import { BundleAnalyzerPlugin } from 'webpack-bundle-analyzer';
-import { merge } from 'webpack-merge';
-
-import checkNodeEnv from '../scripts/check-node-env';
-import deleteSourceMaps from '../scripts/delete-source-maps';
-import baseConfig from './webpack.config.base';
-import webpackPaths from './webpack.paths';
-
-checkNodeEnv('production');
-deleteSourceMaps();
-
-const devtoolsConfig =
-  process.env.DEBUG_PROD === 'true'
-    ? {
-        devtool: 'source-map',
-      }
-    : {};
-
-const configuration: webpack.Configuration = {
-  ...devtoolsConfig,
-
-  mode: 'production',
-
-  target: ['web', 'electron-renderer'],
-
-  entry: [path.join(webpackPaths.srcRendererPath, 'index.tsx')],
-
-  output: {
-    path: webpackPaths.distRendererPath,
-    publicPath: './',
-    filename: 'renderer.js',
-    library: {
-      type: 'umd',
-    },
-  },
-
-  module: {
-    rules: [
-      {
-        test: /\.s?(a|c)ss$/,
-        use: [
-          MiniCssExtractPlugin.loader,
-          {
-            loader: 'css-loader',
-            options: {
-              modules: true,
-              sourceMap: true,
-              importLoaders: 1,
-            },
-          },
-          'sass-loader',
-        ],
-        include: /\.module\.s?(c|a)ss$/,
-      },
-      {
-        test: /\.s?(a|c)ss$/,
-        use: [MiniCssExtractPlugin.loader, 'css-loader', 'sass-loader'],
-        exclude: /\.module\.s?(c|a)ss$/,
-      },
-      // Fonts
-      {
-        test: /\.(woff|woff2|eot|ttf|otf)$/i,
-        type: 'asset/resource',
-      },
-      // Images
-      {
-        test: /\.(png|svg|jpg|jpeg|gif)$/i,
-        type: 'asset/resource',
-      },
-    ],
-  },
-
-  optimization: {
-    minimize: true,
-    minimizer: [
-      new TerserPlugin({
-        parallel: true,
-      }),
-      new CssMinimizerPlugin(),
-    ],
-  },
-
-  plugins: [
-    /**
-     * Create global constants which can be configured at compile time.
-     *
-     * Useful for allowing different behaviour between development builds and
-     * release builds
-     *
-     * NODE_ENV should be production so that modules do not perform certain
-     * development checks
-     */
-    new webpack.EnvironmentPlugin({
-      NODE_ENV: 'production',
-      DEBUG_PROD: false,
-    }),
-
-    new MiniCssExtractPlugin({
-      filename: 'style.css',
-    }),
-
-    new BundleAnalyzerPlugin({
-      analyzerMode: process.env.ANALYZE === 'true' ? 'server' : 'disabled',
-    }),
-
-    new HtmlWebpackPlugin({
-      filename: 'index.html',
-      template: path.join(webpackPaths.srcRendererPath, 'index.ejs'),
-      minify: {
-        collapseWhitespace: true,
-        removeAttributeQuotes: true,
-        removeComments: true,
-      },
-      isBrowser: false,
-      isDevelopment: process.env.NODE_ENV !== 'production',
-    }),
-  ],
-};
-
-export default merge(baseConfig, configuration);

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

@@ -1,140 +0,0 @@
-import 'webpack-dev-server';
-import path from 'path';
-
-import ReactRefreshWebpackPlugin from '@pmmmwh/react-refresh-webpack-plugin';
-import HtmlWebpackPlugin from 'html-webpack-plugin';
-import webpack from 'webpack';
-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 port = process.env.PORT || 4343;
-
-const configuration: webpack.Configuration = {
-  devtool: 'inline-source-map',
-
-  mode: 'development',
-
-  target: ['web', 'electron-renderer'],
-
-  entry: [
-    `webpack-dev-server/client?http://localhost:${port}/dist`,
-    'webpack/hot/only-dev-server',
-    path.join(webpackPaths.srcRendererPath, 'index.tsx'),
-  ],
-
-  output: {
-    path: webpackPaths.distRendererPath,
-    publicPath: '/',
-    filename: 'renderer.dev.js',
-    library: {
-      type: 'umd',
-    },
-  },
-
-  module: {
-    rules: [
-      {
-        test: /\.s?css$/,
-        use: [
-          'style-loader',
-          {
-            loader: 'css-loader',
-            options: {
-              modules: true,
-              sourceMap: true,
-              importLoaders: 1,
-            },
-          },
-          'sass-loader',
-        ],
-        include: /\.module\.s?(c|a)ss$/,
-      },
-      {
-        test: /\.s?css$/,
-        use: ['style-loader', 'css-loader', 'sass-loader'],
-        exclude: /\.module\.s?(c|a)ss$/,
-      },
-      // Fonts
-      {
-        test: /\.(woff|woff2|eot|ttf|otf)$/i,
-        type: 'asset/resource',
-      },
-      // Images
-      {
-        test: /\.(png|svg|jpg|jpeg|gif)$/i,
-        type: 'asset/resource',
-      },
-    ],
-  },
-  plugins: [
-    new webpack.NoEmitOnErrorsPlugin(),
-
-    /**
-     * Create global constants which can be configured at compile time.
-     *
-     * Useful for allowing different behaviour between development builds and
-     * release builds
-     *
-     * NODE_ENV should be production so that modules do not perform certain
-     * development checks
-     *
-     * By default, use 'development' as NODE_ENV. This can be overriden with
-     * 'staging', for example, by changing the ENV variables in the npm scripts
-     */
-    new webpack.EnvironmentPlugin({
-      NODE_ENV: 'development',
-    }),
-
-    new webpack.LoaderOptionsPlugin({
-      debug: true,
-    }),
-
-    new ReactRefreshWebpackPlugin(),
-
-    new HtmlWebpackPlugin({
-      filename: path.join('index.html'),
-      template: path.join(webpackPaths.srcRendererPath, 'index.ejs'),
-      minify: {
-        collapseWhitespace: true,
-        removeAttributeQuotes: true,
-        removeComments: true,
-      },
-      isBrowser: false,
-      env: process.env.NODE_ENV,
-      isDevelopment: process.env.NODE_ENV !== 'production',
-      nodeModules: webpackPaths.appNodeModulesPath,
-    }),
-  ],
-
-  node: {
-    __dirname: false,
-    __filename: false,
-  },
-
-  devServer: {
-    port,
-    compress: true,
-    hot: true,
-    headers: { 'Access-Control-Allow-Origin': '*' },
-    static: {
-      publicPath: '/',
-    },
-    historyApiFallback: {
-      verbose: true,
-    },
-    setupMiddlewares(middlewares) {
-      return middlewares;
-    },
-  },
-};
-
-export default merge(baseConfig, configuration);

.erb/configs/webpack.paths.ts

@@ -1,38 +0,0 @@
-const path = require('path');
-
-const rootPath = path.join(__dirname, '../..');
-
-const dllPath = path.join(__dirname, '../dll');
-
-const srcPath = path.join(rootPath, 'src');
-const srcMainPath = path.join(srcPath, 'main');
-const srcRendererPath = path.join(srcPath, 'renderer');
-
-const releasePath = path.join(rootPath, 'release');
-const appPath = path.join(releasePath, 'app');
-const appPackagePath = path.join(appPath, 'package.json');
-const appNodeModulesPath = path.join(appPath, 'node_modules');
-const srcNodeModulesPath = path.join(srcPath, 'node_modules');
-
-const distPath = path.join(appPath, 'dist');
-const distMainPath = path.join(distPath, 'main');
-const distRendererPath = path.join(distPath, 'renderer');
-
-const buildPath = path.join(releasePath, 'build');
-
-export default {
-  rootPath,
-  dllPath,
-  srcPath,
-  srcMainPath,
-  srcRendererPath,
-  releasePath,
-  appPath,
-  appPackagePath,
-  appNodeModulesPath,
-  srcNodeModulesPath,
-  distPath,
-  distMainPath,
-  distRendererPath,
-  buildPath,
-};

.erb/mocks/fileMock.js

@@ -1 +0,0 @@
-export default 'test-file-stub';

.erb/scripts/.eslintrc

@@ -1,8 +0,0 @@
-{
-  "rules": {
-    "no-console": "off",
-    "global-require": "off",
-    "import/no-dynamic-require": "off",
-    "import/no-extraneous-dependencies": "off"
-  }
-}

.erb/scripts/check-build-exists.ts

@@ -1,24 +0,0 @@
-// Check if the renderer and main bundles are built
-import path from 'path';
-import chalk from 'chalk';
-import fs from 'fs';
-import webpackPaths from '../configs/webpack.paths';
-
-const mainPath = path.join(webpackPaths.distMainPath, 'main.js');
-const rendererPath = path.join(webpackPaths.distRendererPath, 'renderer.js');
-
-if (!fs.existsSync(mainPath)) {
-  throw new Error(
-    chalk.whiteBright.bgRed.bold(
-      'The main process is not built yet. Build it by running "npm run build:main"'
-    )
-  );
-}
-
-if (!fs.existsSync(rendererPath)) {
-  throw new Error(
-    chalk.whiteBright.bgRed.bold(
-      'The renderer process is not built yet. Build it by running "npm run build:renderer"'
-    )
-  );
-}

.erb/scripts/check-native-dep.js

@@ -1,54 +0,0 @@
-import fs from 'fs';
-import chalk from 'chalk';
-import { execSync } from 'child_process';
-import { dependencies } from '../../package.json';
-
-if (dependencies) {
-  const dependenciesKeys = Object.keys(dependencies);
-  const nativeDeps = fs
-    .readdirSync('node_modules')
-    .filter((folder) => fs.existsSync(`node_modules/${folder}/binding.gyp`));
-  if (nativeDeps.length === 0) {
-    process.exit(0);
-  }
-  try {
-    // Find the reason for why the dependency is installed. If it is installed
-    // because of a devDependency then that is okay. Warn when it is installed
-    // because of a dependency
-    const { dependencies: dependenciesObject } = JSON.parse(
-      execSync(`npm ls ${nativeDeps.join(' ')} --json`).toString()
-    );
-    const rootDependencies = Object.keys(dependenciesObject);
-    const filteredRootDependencies = rootDependencies.filter((rootDependency) =>
-      dependenciesKeys.includes(rootDependency)
-    );
-    if (filteredRootDependencies.length > 0) {
-      const plural = filteredRootDependencies.length > 1;
-      console.log(`
- ${chalk.whiteBright.bgYellow.bold(
-   'Webpack does not work with native dependencies.'
- )}
-${chalk.bold(filteredRootDependencies.join(', '))} ${
-        plural ? 'are native dependencies' : 'is a native dependency'
-      } and should be installed inside of the "./release/app" folder.
- First, uninstall the packages from "./package.json":
-${chalk.whiteBright.bgGreen.bold('npm uninstall your-package')}
- ${chalk.bold(
-   'Then, instead of installing the package to the root "./package.json":'
- )}
-${chalk.whiteBright.bgRed.bold('npm install your-package')}
- ${chalk.bold('Install the package to "./release/app/package.json"')}
-${chalk.whiteBright.bgGreen.bold(
-  'cd ./release/app && npm install your-package'
-)}
- Read more about native dependencies at:
-${chalk.bold(
-  'https://electron-react-boilerplate.js.org/docs/adding-dependencies/#module-structure'
-)}
- `);
-      process.exit(1);
-    }
-  } catch (e) {
-    console.log('Native dependencies could not be checked');
-  }
-}

.erb/scripts/check-node-env.js

@@ -1,16 +0,0 @@
-import chalk from 'chalk';
-
-export default function checkNodeEnv(expectedEnv) {
-  if (!expectedEnv) {
-    throw new Error('"expectedEnv" not set');
-  }
-
-  if (process.env.NODE_ENV !== expectedEnv) {
-    console.log(
-      chalk.whiteBright.bgRed.bold(
-        `"process.env.NODE_ENV" must be "${expectedEnv}" to use this webpack config`
-      )
-    );
-    process.exit(2);
-  }
-}

.erb/scripts/check-port-in-use.js

@@ -1,16 +0,0 @@
-import chalk from 'chalk';
-import detectPort from 'detect-port';
-
-const port = process.env.PORT || '4343';
-
-detectPort(port, (err, availablePort) => {
-  if (port !== String(availablePort)) {
-    throw new Error(
-      chalk.whiteBright.bgRed.bold(
-        `Port "${port}" on "localhost" is already in use. Please use another port. ex: PORT=4343 npm start`
-      )
-    );
-  } else {
-    process.exit(0);
-  }
-});

.erb/scripts/clean.js

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

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

@@ -1,8 +0,0 @@
-import path from 'path';
-import rimraf 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'));
-}

.erb/scripts/electron-rebuild.js

@@ -1,20 +0,0 @@
-import { execSync } from 'child_process';
-import fs from 'fs';
-import { dependencies } from '../../release/app/package.json';
-import webpackPaths from '../configs/webpack.paths';
-
-if (
-  Object.keys(dependencies || {}).length > 0 &&
-  fs.existsSync(webpackPaths.appNodeModulesPath)
-) {
-  const electronRebuildCmd =
-    '../../node_modules/.bin/electron-rebuild --force --types prod,dev,optional --module-dir .';
-  const cmd =
-    process.platform === 'win32'
-      ? electronRebuildCmd.replace(/\//g, '\\')
-      : electronRebuildCmd;
-  execSync(cmd, {
-    cwd: webpackPaths.appPath,
-    stdio: 'inherit',
-  });
-}

.erb/scripts/link-modules.ts

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

.erb/scripts/notarize.js

@@ -1,30 +0,0 @@
-const { notarize } = require('electron-notarize');
-const { build } = require('../../package.json');
-
-exports.default = async function notarizeMacos(context) {
-  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 (!('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;
-  }
-
-  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,
-  });
-};

.eslintignore

@@ -1,34 +0,0 @@
-# Logs
-logs
-*.log
-
-# Runtime data
-pids
-*.pid
-*.seed
-
-# Coverage directory used by tools like istanbul
-coverage
-.eslintcache
-
-# Dependency directory
-# https://www.npmjs.org/doc/misc/npm-faq.html#should-i-check-my-node_modules-folder-into-git
-node_modules
-
-# OSX
-.DS_Store
-
-src/i18n
-release/app/dist
-release/build
-.erb/dll
-
-.idea
-npm-debug.log.*
-*.css.d.ts
-*.sass.d.ts
-*.scss.d.ts
-
-# eslint ignores hidden directories by default:
-# https://github.com/eslint/eslint/issues/8429
-!.erb

.eslintrc.js

@@ -1,90 +0,0 @@
-module.exports = {
-  extends: ['erb', 'plugin:typescript-sort-keys/recommended'],
-  ignorePatterns: ['.erb/*', 'server'],
-  parser: '@typescript-eslint/parser',
-  parserOptions: {
-    createDefaultProgram: true,
-    ecmaVersion: 12,
-    parser: '@typescript-eslint/parser',
-    project: './tsconfig.json',
-    sourceType: 'module',
-    tsconfigRootDir: './',
-  },
-  plugins: ['@typescript-eslint', 'import', 'sort-keys-fix'],
-  rules: {
-    '@typescript-eslint/naming-convention': 'off',
-    '@typescript-eslint/no-explicit-any': 'off',
-    '@typescript-eslint/no-non-null-assertion': 'off',
-    '@typescript-eslint/no-shadow': ['off'],
-    'default-case': 'off',
-    'import/extensions': 'off',
-    'import/no-absolute-path': 'off',
-    // A temporary hack related to IDE not resolving correct package.json
-    'import/no-extraneous-dependencies': 'off',
-
-    'import/no-unresolved': 'error',
-    'import/order': [
-      'error',
-      {
-        alphabetize: {
-          caseInsensitive: true,
-          order: 'asc',
-        },
-        groups: ['builtin', 'external', 'internal', ['parent', 'sibling']],
-        'newlines-between': 'never',
-        pathGroups: [
-          {
-            group: 'external',
-            pattern: 'react',
-            position: 'before',
-          },
-        ],
-        pathGroupsExcludedImportTypes: ['react'],
-      },
-    ],
-    'import/prefer-default-export': 'off',
-    'jsx-a11y/click-events-have-key-events': 'off',
-    'jsx-a11y/interactive-supports-focus': 'off',
-    'jsx-a11y/media-has-caption': 'off',
-    'no-await-in-loop': 'off',
-    'no-console': 'off',
-    'no-nested-ternary': 'off',
-    'no-restricted-syntax': 'off',
-    'no-underscore-dangle': 'off',
-    'prefer-destructuring': 'off',
-    'react/jsx-props-no-spreading': 'off',
-    'react/jsx-sort-props': [
-      'error',
-      {
-        callbacksLast: true,
-        ignoreCase: false,
-        noSortAlphabetically: false,
-        reservedFirst: true,
-        shorthandFirst: true,
-        shorthandLast: false,
-      },
-    ],
-    'react/no-array-index-key': 'off',
-    'react/react-in-jsx-scope': 'off',
-    'react/require-default-props': 'off',
-    'sort-keys-fix/sort-keys-fix': 'warn',
-  },
-  settings: {
-    'import/parsers': {
-      '@typescript-eslint/parser': ['.ts', '.tsx'],
-    },
-    'import/resolver': {
-      // See https://github.com/benmosher/eslint-plugin-import/issues/1396#issuecomment-575727774 for line below
-      node: {
-        extensions: ['.js', '.jsx', '.ts', '.tsx'],
-      },
-      typescript: {
-        alwaysTryTypes: true,
-        project: './tsconfig.json',
-      },
-      webpack: {
-        config: require.resolve('./.erb/configs/webpack.config.eslint.ts'),
-      },
-    },
-  },
-};

.gitattributes

@@ -5,6 +5,7 @@
 *.jpeg  binary
 *.ico   binary
 *.icns  binary
+*.webp  binary
 *.eot   binary
 *.otf   binary
 *.ttf   binary

.github/ISSUE_TEMPLATE/01-feature_request.yml

@@ -0,0 +1,33 @@
+name: Feature request
+description: Request a feature to be added to Feishin
+title: '[Feature]: '
+labels: ['enhancement']
+body:
+    - type: checkboxes
+      id: check-duplicate
+      attributes:
+          label: I have already checked through the existing feature requests and found no duplicates
+          options:
+              - label: 'Yes'
+                required: true
+
+    - type: dropdown
+      id: server-specific
+      attributes:
+          label: Is this a server-specific feature?
+          options:
+              - Not server-specific
+              - OpenSubsonic
+              - Jellyfin
+              - Navidrome
+          default: 0
+      validations:
+          required: true
+
+    - type: textarea
+      id: solution
+      attributes:
+          label: What do you want to be added?
+          placeholder: I would like to see [...]
+      validations:
+          required: true

.github/ISSUE_TEMPLATE/02-bug_report.yml

@@ -0,0 +1,74 @@
+name: Bug report
+description: You're having technical issues.
+title: '[Bug]: '
+labels: ['bug']
+body:
+    - type: checkboxes
+      id: check-duplicate
+      attributes:
+          label: I have already checked through the existing bug reports and found no duplicates
+          options:
+              - label: 'Yes'
+                required: true
+
+    - type: input
+      id: version
+      attributes:
+          label: App Version
+          description: What version of the app are you running?
+          placeholder: ex. 1.0.0
+      validations:
+          required: true
+
+    - type: input
+      id: server-version
+      attributes:
+          label: Music Server and Version
+          description: What music server are you using?
+          placeholder: ex. Navidrome v0.55.0, LMS v3.67.0, Jellyfin v10.10.7, etc.
+      validations:
+          required: true
+
+    - type: dropdown
+      id: environments
+      attributes:
+          label: What local environments are you seeing the problem on?
+          multiple: true
+          options:
+              - Desktop Windows
+              - Desktop macOS
+              - Desktop Linux
+              - Web Firefox
+              - Web Chrome
+              - Web Safari
+              - Web Microsoft Edge
+              - Other (please specify in the next field)
+
+    - type: textarea
+      id: what-happened
+      attributes:
+          label: What happened?
+          description: Also tell us, what did you expect to happen?
+          placeholder: Include screenshots and error logs if possible. The browser devtools can be opened using CTRL + SHIFT + I (Windows/Linux) or CMD + SHIFT + I (macOS).
+      validations:
+          required: true
+
+    - type: textarea
+      id: reproduction
+      attributes:
+          label: Steps to reproduce
+          description: How can we reproduce this issue? Are there any specific settings that are enabled that could be the cause?
+          placeholder: |
+              1. Go to '...'
+              2. Click on '....'
+              3. Scroll down to '....'
+              4. See error
+      validations:
+          required: true
+
+    - type: textarea
+      id: logs
+      attributes:
+          label: Relevant log output
+          description: Please copy and paste any relevant log output. This will be automatically formatted into code.
+          render: shell

.github/ISSUE_TEMPLATE/1-Bug_report.md

@@ -1,45 +0,0 @@
----
-name: Bug report
-about: You're having technical issues. 🐞
-labels: 'bug'
----
-
-## Expected Behavior
-
-<!--- What should have happened? -->
-
-## Current Behavior
-
-<!--- What went wrong? -->
-<!-- Add screenshots to help explain your problem -->
-<!-- (Open the browser dev tools in the menu or using CTRL + SHIFT + I) -->
-
-## Steps to Reproduce
-
-<!-- Add relevant code and/or a live example -->
-<!-- Add stack traces -->
-
-1.
-
-2.
-
-3.
-
-4.
-
-## Possible Solution (Not obligatory)
-
-<!--- Suggest a reason for the bug or how to fix it. -->
-
-## Context
-
-<!--- How has this issue affected you? What are you trying to accomplish? -->
-
-## Your Environment
-
-<!--- Include as many relevant details about the environment you experienced the bug in -->
-
-- Application version (e.g. v0.1.0) :
-- Operating System and version (e.g. Windows 10) :
-- Server and version (e.g. Navidrome v0.48.0) :
-- Node version (if developing locally) :

.github/ISSUE_TEMPLATE/2-Question.md

@@ -1,9 +0,0 @@
----
-name: Question
-about: Ask a question.❓
-labels: 'question'
----
-
-<!-- Question issues will be closed. -->
-<!-- Ask questions in the discussions tab: Please use discussions https://github.com/jeffvli/feishin/discussions -->
-<!-- Or join the Discord/Matrix servers: https://discord.gg/FVKpcMDy5f https://matrix.to/#/#sonixd:matrix.org -->

.github/ISSUE_TEMPLATE/3-Feature_request.md

@@ -1,11 +0,0 @@
----
-name: Feature request
-about: Request a feature to be added to Feishin 🎉
-labels: 'enhancement'
----
-
-## What do you want to be added?
-
-## Additional context
-
-<!-- Is this a server-specific feature? (e.g. Jellyfin only). -->

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,11 @@
+blank_issues_enabled: false
+contact_links:
+    - name: Questions or help
+      url: https://github.com/jeffvli/feishin/discussions
+      about: Ask questions or get help in the discussions section
+    - name: Discord Community
+      url: https://discord.gg/FVKpcMDy5f
+      about: The discord/matrix servers are bridged so you can join whichever you prefer
+    - name: Matrix Community
+      url: https://matrix.to/#/#sonixd:matrix.org
+      about: The discord/matrix servers are bridged so you can join whichever you prefer

.github/config.yml

@@ -1,6 +1,6 @@
 requiredHeaders:
-  - Prerequisites
-  - Expected Behavior
-  - Current Behavior
-  - Possible Solution
-  - Your Environment
+    - Prerequisites
+    - Expected Behavior
+    - Current Behavior
+    - Possible Solution
+    - Your Environment

.github/stale.yml

@@ -4,14 +4,14 @@ daysUntilStale: 60
 daysUntilClose: 7
 # Issues with these labels will never be considered stale
 exemptLabels:
-  - discussion
-  - security
+    - discussion
+    - security
 # Label to use when marking an issue as stale
 staleLabel: wontfix
 # Comment to post when marking an issue as stale. Set to `false` to disable
 markComment: >
-  This issue has been automatically marked as stale because it has not had
-  recent activity. It will be closed if no further activity occurs. Thank you
-  for your contributions.
+    This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.
+
+
 # Comment to post when closing a stale issue. Set to `false` to disable
 closeComment: false

.github/workflows/publish-beta.yml

@@ -0,0 +1,381 @@
+name: Publish Beta (Manual)
+
+on:
+    workflow_dispatch:
+        inputs:
+            version:
+                description: 'Semantic version number (e.g., 1.0.0) - beta suffix will be added automatically'
+                required: false
+                type: string
+
+jobs:
+    prepare:
+        runs-on: ubuntu-latest
+        outputs:
+            version: ${{ steps.version.outputs.version }}
+        steps:
+            - name: Checkout git repo
+              uses: actions/checkout@v1
+
+            - name: Install Node and PNPM
+              uses: pnpm/action-setup@v4.1.0
+              with:
+                  version: 9
+
+            - name: Install dependencies
+              run: pnpm install
+
+            - name: Validate and set version with incrementing beta suffix
+              id: version
+              shell: pwsh
+              env:
+                  GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+              run: |
+                  $inputVersion = "${{ github.event.inputs.version }}"
+                  Write-Host "Input version: $inputVersion"
+
+                  if ($inputVersion -eq "" -or $inputVersion -eq "null") {
+                      # No input version provided, auto-increment patch version
+                      Write-Host "No version provided, auto-incrementing patch version..."
+
+                      # Get current version from package.json
+                      $currentVersion = (Get-Content package.json | ConvertFrom-Json).version
+                      Write-Host "Current version: $currentVersion"
+
+                      # Remove any existing suffix (like -beta) to get clean semantic version
+                      $cleanVersion = $currentVersion -replace '-.*$', ''
+
+                      # Extract major, minor, patch components
+                      $versionParts = $cleanVersion.Split('.')
+                      if ($versionParts.Length -ne 3) {
+                          Write-Error "Current version format is invalid: $cleanVersion"
+                          exit 1
+                      }
+
+                      $major = [int]$versionParts[0]
+                      $minor = [int]$versionParts[1]
+                      $patch = [int]$versionParts[2]
+
+                      # Increment patch version
+                      $newPatch = $patch + 1
+                      $inputVersion = "$major.$minor.$newPatch"
+                      Write-Host "Auto-generated version: $inputVersion"
+                  } else {
+                      # Validate semantic version format (major.minor.patch)
+                      $versionPattern = '^\d+\.\d+\.\d+$'
+                      if ($inputVersion -notmatch $versionPattern) {
+                          Write-Error "Invalid version format. Expected semantic version (e.g., 1.0.0), got: $inputVersion"
+                          exit 1
+                      }
+                  }
+
+                  # Check for existing beta releases with the same base version
+                  Write-Host "Checking for existing beta releases with base version: $inputVersion"
+                  $existingReleases = gh release list --limit 100 --json tagName,isPrerelease | ConvertFrom-Json | Where-Object { $_.isPrerelease -eq $true }
+
+                  $maxBetaNumber = 0
+
+                  foreach ($release in $existingReleases) {
+                      $tagName = $release.tagName
+                      Write-Host "Checking tag: $tagName"
+
+                      # Extract beta number from tag name (format: v1.0.0-beta.1)
+                      if ($tagName -match "v$([regex]::Escape($inputVersion))-beta\.(\d+)$") {
+                          $betaNumber = [int]$matches[1]
+                          Write-Host "Found beta release with number: $betaNumber"
+
+                          if ($betaNumber -gt $maxBetaNumber) {
+                              $maxBetaNumber = $betaNumber
+                          }
+                      }
+                  }
+
+                  # Calculate next beta number
+                  $nextBetaNumber = $maxBetaNumber + 1
+                  Write-Host "Next beta number: $nextBetaNumber"
+
+                  # Create beta suffix with incrementing number
+                  $betaSuffix = "beta.$nextBetaNumber"
+                  $versionWithBeta = "$inputVersion-$betaSuffix"
+                  Write-Host "Setting version to: $versionWithBeta"
+
+                  # Update package.json
+                  $packageJson = Get-Content package.json | ConvertFrom-Json
+                  $packageJson.version = $versionWithBeta
+                  $packageJson | ConvertTo-Json -Depth 10 | Set-Content package.json
+
+                  Write-Host "Updated package.json version to: $versionWithBeta"
+
+                  # Set output for other jobs
+                  echo "version=$versionWithBeta" >> $env:GITHUB_OUTPUT
+
+    publish:
+        needs: prepare
+        runs-on: ${{ matrix.os }}
+
+        strategy:
+            matrix:
+                os: [windows-latest, macos-latest, ubuntu-latest]
+
+        steps:
+            - name: Checkout git repo
+              uses: actions/checkout@v1
+
+            - name: Install Node and PNPM
+              uses: pnpm/action-setup@v4.1.0
+              with:
+                  version: 9
+
+            - name: Install dependencies
+              run: pnpm install
+
+            - name: Set version from prepare job
+              shell: pwsh
+              run: |
+                  $versionWithBeta = "${{ needs.prepare.outputs.version }}"
+                  Write-Host "Setting version from prepare job: $versionWithBeta"
+
+                  # Update package.json with the version from prepare job
+                  $packageJson = Get-Content package.json | ConvertFrom-Json
+                  $packageJson.version = $versionWithBeta
+                  $packageJson | ConvertTo-Json -Depth 10 | Set-Content package.json
+
+                  Write-Host "Updated package.json version to: $versionWithBeta"
+
+            - name: Build and Publish releases (Windows)
+              if: matrix.os == 'windows-latest'
+              env:
+                  GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+              uses: nick-invision/retry@v2.8.2
+              with:
+                  timeout_minutes: 30
+                  max_attempts: 3
+                  retry_on: error
+                  command: |
+                      pnpm run publish:win:beta
+                  on_retry_command: pnpm cache delete
+
+            - name: Build and Publish releases (macOS)
+              if: matrix.os == 'macos-latest'
+              env:
+                  GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+              uses: nick-invision/retry@v2.8.2
+              with:
+                  timeout_minutes: 30
+                  max_attempts: 3
+                  retry_on: error
+                  command: |
+                      pnpm run publish:mac:beta
+                  on_retry_command: pnpm cache delete
+
+            - name: Build and Publish releases (Linux)
+              if: matrix.os == 'ubuntu-latest'
+              env:
+                  GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+              uses: nick-invision/retry@v2.8.2
+              with:
+                  timeout_minutes: 30
+                  max_attempts: 3
+                  retry_on: error
+                  command: |
+                      pnpm run publish:linux:beta
+                  on_retry_command: pnpm cache delete
+
+            - name: Build and Publish releases (Linux ARM64)
+              if: matrix.os == 'ubuntu-latest'
+              env:
+                  GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+              uses: nick-invision/retry@v2.8.2
+              with:
+                  timeout_minutes: 30
+                  max_attempts: 3
+                  retry_on: error
+                  command: |
+                      pnpm run publish:linux-arm64:beta
+                  on_retry_command: pnpm cache delete
+
+    edit-release:
+        needs: [prepare, publish]
+        runs-on: ubuntu-latest
+        steps:
+            - name: Checkout git repo
+              uses: actions/checkout@v1
+
+            - name: Edit release with commits and title
+              shell: pwsh
+              env:
+                  GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+              run: |
+                  # Get the version from the prepare job
+                  $versionWithBeta = "${{ needs.prepare.outputs.version }}"
+                  $tagVersion = "v" + $versionWithBeta
+                  Write-Host "Editing release for tag: $tagVersion"
+
+                  # Check if release exists
+                  $releaseExists = gh release view $tagVersion 2>$null
+                  if ($LASTEXITCODE -eq 0) {
+                      Write-Host "Found release with tag $tagVersion"
+
+                      # Get current release notes
+
+                      # Find the latest non-prerelease tag
+                      Write-Host "Finding latest non-prerelease tag..."
+                      $latestNonPrerelease = gh release list --limit 100 --json tagName,isPrerelease | ConvertFrom-Json | Where-Object { $_.isPrerelease -eq $false -and $_.tagName -ne $tagVersion } | Select-Object -First 1
+
+                        if ($latestNonPrerelease) {
+                            $latestTag = $latestNonPrerelease.tagName
+                            Write-Host "Latest non-prerelease tag: $latestTag"
+
+                            # Get commits between latest non-prerelease and current HEAD
+                            Write-Host "Getting commits between $latestTag and HEAD..."
+
+                            # Use proper git range syntax and handle PowerShell string interpolation
+                            $gitRange = "$latestTag..HEAD"
+                            Write-Host "Git range: $gitRange"
+
+                            # Get commits using proper git command with datetime
+                            $commits = git log --oneline --pretty=format:"%ad|%s|%h" --date=short $gitRange
+
+                            # Check if commits exist
+                            if ($commits -and $commits.Trim() -ne "") {
+                                Write-Host "Found commits:"
+                                Write-Host $commits
+
+                                # Group commits by date
+                                $groupedCommits = @{}
+                                foreach ($line in $commits) {
+                                    if ($line.Trim() -ne "") {
+                                        $parts = $line.Split('|')
+                                        $date = $parts[0]
+                                        $message = $parts[1]
+                                        $hash = $parts[2]
+
+                                        if (-not $groupedCommits.ContainsKey($date)) {
+                                            $groupedCommits[$date] = @()
+                                        }
+                                        $groupedCommits[$date] += "- $message ($hash)"
+                                    }
+                                }
+
+                                # Build formatted release notes grouped by date
+                                $commitNotes = "## Changes since $latestTag`n`n"
+                                $sortedDates = $groupedCommits.Keys | Sort-Object -Descending
+                                foreach ($date in $sortedDates) {
+                                    $commitNotes += "### $date`n"
+                                    foreach ($commit in $groupedCommits[$date]) {
+                                        $commitNotes += "$commit`n"
+                                    }
+                                    $commitNotes += "`n"
+                                }
+
+                                $releaseNotes = $commitNotes
+                            } else {
+                                Write-Host "No commits found between $latestTag and HEAD"
+                                Write-Host "Trying alternative approach..."
+
+                                # Alternative: get commits since the tag (not range) with datetime
+                                $commits = git log --oneline --pretty=format:"%ad|%s|%h" --date=short $latestTag.. --not $latestTag
+
+                                if ($commits -and $commits.Trim() -ne "") {
+                                    Write-Host "Found commits with alternative method:"
+                                    Write-Host $commits
+
+                                    # Group commits by date
+                                    $groupedCommits = @{}
+                                    foreach ($line in $commits) {
+                                        if ($line.Trim() -ne "") {
+                                            $parts = $line.Split('|')
+                                            $date = $parts[0]
+                                            $message = $parts[1]
+                                            $hash = $parts[2]
+
+                                            if (-not $groupedCommits.ContainsKey($date)) {
+                                                $groupedCommits[$date] = @()
+                                            }
+                                            $groupedCommits[$date] += "- $message ($hash)"
+                                        }
+                                    }
+
+                                    # Build formatted release notes grouped by date
+                                    $commitNotes = "## Changes since $latestTag`n`n"
+                                    $sortedDates = $groupedCommits.Keys | Sort-Object -Descending
+                                    foreach ($date in $sortedDates) {
+                                        $commitNotes += "### $date`n"
+                                        foreach ($commit in $groupedCommits[$date]) {
+                                            $commitNotes += "$commit`n"
+                                        }
+                                        $commitNotes += "`n"
+                                    }
+
+                                    $releaseNotes = $commitNotes
+                                } else {
+                                    Write-Host "Still no commits found, using basic release notes"
+                                    $releaseNotes = "## Beta Release`n`nThis is a beta release."
+                                }
+                            }
+                        } else {
+                            Write-Host "No non-prerelease tags found, using basic release notes"
+                            $releaseNotes = "## Beta Release`n`nThis is a beta release."
+                        }
+
+                      # Prepend beta update instructions to release notes
+                      $betaInstructions = "To receive automatic beta updates, set the release channel to ``Beta`` under ``Advanced`` settings.`n`n"
+                      $releaseNotes = $betaInstructions + $releaseNotes
+
+                      # Update the release with new title and notes
+                      Write-Host "Updating release with title 'Beta' and new notes..."
+                      gh release edit $tagVersion --title "Beta" --notes "$releaseNotes"
+                      Write-Host "Successfully updated release title to 'Beta' and added commit notes"
+                  } else {
+                      Write-Host "No release found with tag $tagVersion"
+                  }
+            - name: Set release as prerelease
+              shell: pwsh
+              env:
+                  GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+              run: |
+                  # Get the version from the prepare job
+                  $versionWithBeta = "${{ needs.prepare.outputs.version }}"
+                  $tagVersion = "v" + $versionWithBeta
+                  Write-Host "Setting release as prerelease for tag: $tagVersion"
+                  gh release edit $tagVersion --prerelease --draft=false
+                  Write-Host "Successfully set release as prerelease"
+
+    cleanup:
+        needs: [prepare, publish, edit-release]
+        runs-on: ubuntu-latest
+        steps:
+            - name: Checkout git repo
+              uses: actions/checkout@v1
+
+            - name: Delete existing prereleases
+              shell: pwsh
+              env:
+                  GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+              run: |
+                  # Get the current version that was just created
+                  $versionWithBeta = "${{ needs.prepare.outputs.version }}"
+                  Write-Host "Current release version: $versionWithBeta"
+
+                  # Find and delete any old prereleases (excluding the current one)
+                  Write-Host "Deleting old prereleases..."
+                  Write-Host "Searching for releases with isPrerelease 'true'..."
+
+                  $betaReleases = gh release list --limit 100 --json tagName,isPrerelease,name | ConvertFrom-Json | Where-Object { $_.isPrerelease -eq $true }
+
+                  if ($betaReleases) {
+                      Write-Host "Found $($betaReleases.Count) release(s) with isPrerelease 'true':"
+                      foreach ($release in $betaReleases) {
+                          $tagName = $release.tagName
+                          # Skip the current release
+                          if ($tagName -ne "v$versionWithBeta") {
+                              Write-Host "  - Tag: $tagName, Title: $($release.name)"
+                              gh release delete $tagName --yes --cleanup-tag
+                              Write-Host "  Deleted release with tag: $tagName"
+                          } else {
+                              Write-Host "  - Skipping current release: $tagName"
+                          }
+                      }
+                  } else {
+                      Write-Host "No releases found with isPrerelease 'true'"
+                  }

.github/workflows/publish-docker-auto.yml

@@ -0,0 +1,55 @@
+# Referenced from: https://docs.github.com/en/actions/publishing-packages/publishing-docker-images#introduction
+name: Publish Docker to GHCR
+permissions: write-all
+
+on:
+    workflow_dispatch:
+    push:
+        tags:
+            - 'v*.*.*'
+
+env:
+    REGISTRY: ghcr.io
+    IMAGE_NAME: ${{ github.repository }}
+
+jobs:
+    build-and-push-image:
+        runs-on: ubuntu-latest
+        permissions:
+            contents: read
+            packages: write
+        steps:
+            - name: Checkout repository
+              uses: actions/checkout@v4
+            - name: Log in to the Container registry
+              uses: docker/login-action@65b78e6e13532edd9afa3aa52ac7964289d1a9c1
+              with:
+                  registry: ${{ env.REGISTRY }}
+                  username: ${{ github.actor }}
+                  password: ${{ secrets.GITHUB_TOKEN }}
+            - name: Extract metadata (tags, labels) for Docker
+              id: meta
+              uses: docker/metadata-action@9ec57ed1fcdbf14dcef7dfbe97b2010124a938b7
+              with:
+                  images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+                  tags: |
+                      type=ref,event=branch
+                      type=ref,event=pr
+                      type=semver,pattern={{version}}
+                      type=semver,pattern={{major}}.{{minor}}
+                      type=semver,pattern={{major}}
+            - name: Set up QEMU
+              uses: docker/setup-qemu-action@v3
+            - name: Setup Docker buildx
+              uses: docker/setup-buildx-action@v3
+            - name: Build and push Docker image
+              uses: docker/build-push-action@f2a1d5e99d037542a71f64918e516c093c6f3fc4
+              with:
+                  context: .
+                  push: true
+                  tags: ${{ steps.meta.outputs.tags }}
+                  labels: ${{ steps.meta.outputs.labels }}
+                  platforms: |
+                      linux/amd64
+                      linux/arm/v7
+                      linux/arm64/v8

.github/workflows/publish-docker.yml

@@ -0,0 +1,44 @@
+# Referenced from: https://docs.github.com/en/actions/publishing-packages/publishing-docker-images#introduction
+name: Publish Docker to GHCR (Manual)
+
+on: workflow_dispatch
+
+env:
+    REGISTRY: ghcr.io
+    IMAGE_NAME: ${{ github.repository }}
+
+jobs:
+    build-and-push-image:
+        runs-on: ubuntu-latest
+        permissions:
+            contents: read
+            packages: write
+        steps:
+            - name: Checkout repository
+              uses: actions/checkout@v4
+            - name: Log in to the Container registry
+              uses: docker/login-action@65b78e6e13532edd9afa3aa52ac7964289d1a9c1
+              with:
+                  registry: ${{ env.REGISTRY }}
+                  username: ${{ github.actor }}
+                  password: ${{ secrets.GITHUB_TOKEN }}
+            - name: Extract metadata (tags, labels) for Docker
+              id: meta
+              uses: docker/metadata-action@v5
+              with:
+                  images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
+            - name: Set up QEMU
+              uses: docker/setup-qemu-action@v3
+            - name: Setup Docker buildx
+              uses: docker/setup-buildx-action@v3
+            - name: Build and push Docker image
+              uses: docker/build-push-action@f2a1d5e99d037542a71f64918e516c093c6f3fc4
+              with:
+                  context: .
+                  push: true
+                  tags: ${{ steps.meta.outputs.tags }}
+                  labels: ${{ steps.meta.outputs.labels }}
+                  platforms: |
+                      linux/amd64
+                      linux/arm/v7
+                      linux/arm64/v8

.github/workflows/publish-linux.yml

@@ -3,37 +3,45 @@ name: Publish Linux (Manual)
 on: workflow_dispatch
 
 jobs:
-  publish:
-    runs-on: ${{ matrix.os }}
+    publish:
+        runs-on: ${{ matrix.os }}
 
-    strategy:
-      matrix:
-        os: [ubuntu-latest]
+        strategy:
+            matrix:
+                os: [ubuntu-latest]
 
-    steps:
-      - name: Checkout git repo
-        uses: actions/checkout@v1
+        steps:
+            - name: Checkout git repo
+              uses: actions/checkout@v1
 
-      - name: Install Node and NPM
-        uses: actions/setup-node@v1
-        with:
-          node-version: 16
-          cache: npm
+            - name: Install Node and PNPM
+              uses: pnpm/action-setup@v4.1.0
+              with:
+                  version: 9
 
-      - name: Install dependencies
-        run: |
-          npm install --legacy-peer-deps
+            - name: Install dependencies
+              run: pnpm install
 
-      - name: Publish releases
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        uses: nick-invision/retry@v2.8.2
-        with:
-          timeout_minutes: 30
-          max_attempts: 3
-          retry_on: error
-          command: |
-            npm run postinstall
-            npm run build
-            npm exec electron-builder -- --publish always --linux
-          on_retry_command: npm cache clean --force
+            - name: Build and Publish releases
+              env:
+                  GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+              uses: nick-invision/retry@v2.8.2
+              with:
+                  timeout_minutes: 30
+                  max_attempts: 3
+                  retry_on: error
+                  command: |
+                      pnpm run publish:linux
+                  on_retry_command: pnpm cache delete
+
+            - name: Build and Publish releases (arm64)
+              env:
+                  GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+              uses: nick-invision/retry@v2.8.2
+              with:
+                  timeout_minutes: 30
+                  max_attempts: 3
+                  retry_on: error
+                  command: |
+                      pnpm run publish:linux-arm64
+                  on_retry_command: pnpm cache delete

.github/workflows/publish-macos.yml

@@ -1,39 +1,35 @@
-name: Publish Windows and macOS (Manual)
+name: Publish macOS (Manual)
 
 on: workflow_dispatch
 
 jobs:
-  publish:
-    runs-on: ${{ matrix.os }}
+    publish:
+        runs-on: ${{ matrix.os }}
 
-    strategy:
-      matrix:
-        os: [macos-latest]
+        strategy:
+            matrix:
+                os: [macos-latest]
 
-    steps:
-      - name: Checkout git repo
-        uses: actions/checkout@v1
+        steps:
+            - name: Checkout git repo
+              uses: actions/checkout@v1
 
-      - name: Install Node and NPM
-        uses: actions/setup-node@v1
-        with:
-          node-version: 16
-          cache: npm
+            - name: Install Node and PNPM
+              uses: pnpm/action-setup@v4.1.0
+              with:
+                  version: 9
 
-      - name: Install dependencies
-        run: |
-          npm install --legacy-peer-deps
+            - name: Install dependencies
+              run: pnpm install
 
-      - name: Publish releases
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        uses: nick-invision/retry@v2.8.2
-        with:
-          timeout_minutes: 30
-          max_attempts: 3
-          retry_on: error
-          command: |
-            npm run postinstall
-            npm run build
-            npm exec electron-builder -- --publish always --win --mac
-          on_retry_command: npm cache clean --force
+            - name: Build and Publish releases
+              env:
+                  GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+              uses: nick-invision/retry@v2.8.2
+              with:
+                  timeout_minutes: 30
+                  max_attempts: 3
+                  retry_on: error
+                  command: |
+                      pnpm run publish:mac
+                  on_retry_command: pnpm cache delete

.github/workflows/publish-pr-comment.yml

@@ -1,54 +1,54 @@
 name: Comment on pull request
 on:
-  workflow_run:
-    workflows: ['Publish (PR)']
-    types: [completed]
+    workflow_run:
+        workflows: ['Publish (PR)']
+        types: [completed]
 jobs:
-  pr_comment:
-    if: github.event.workflow_run.event == 'pull_request' && github.event.workflow_run.conclusion == 'success'
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/github-script@v6
-        with:
-          # This snippet is public-domain, taken from
-          # https://github.com/oprypin/nightly.link/blob/master/.github/workflows/pr-comment.yml
-          script: |
-            async function upsertComment(owner, repo, issue_number, purpose, body) {
-              const {data: comments} = await github.rest.issues.listComments(
-                {owner, repo, issue_number});
-              const marker = `<!-- bot: ${purpose} -->`;
-              body = marker + "\n" + body;
-              const existing = comments.filter((c) => c.body.includes(marker));
-              if (existing.length > 0) {
-                const last = existing[existing.length - 1];
-                core.info(`Updating comment ${last.id}`);
-                await github.rest.issues.updateComment({
-                  owner, repo,
-                  body,
-                  comment_id: last.id,
-                });
-              } else {
-                core.info(`Creating a comment in issue / PR #${issue_number}`);
-                await github.rest.issues.createComment({issue_number, body, owner, repo});
-              }
-            }
-            const {owner, repo} = context.repo;
-            const run_id = ${{github.event.workflow_run.id}};
-            const pull_requests = ${{ toJSON(github.event.workflow_run.pull_requests) }};
-            if (!pull_requests.length) {
-              return core.error("This workflow doesn't match any pull requests!");
-            }
-            const artifacts = await github.paginate(
-              github.rest.actions.listWorkflowRunArtifacts, {owner, repo, run_id});
-            if (!artifacts.length) {
-              return core.error(`No artifacts found`);
-            }
-            let body = `Download the artifacts for this pull request:\n`;
-            for (const art of artifacts) {
-              body += `\n* [${art.name}.zip](https://nightly.link/${owner}/${repo}/actions/artifacts/${art.id}.zip)`;
-            }
-            core.info("Review thread message body:", body);
-            for (const pr of pull_requests) {
-              await upsertComment(owner, repo, pr.number,
-                "nightly-link", body);
-            }
+    pr_comment:
+        if: github.event.workflow_run.event == 'pull_request' && github.event.workflow_run.conclusion == 'success'
+        runs-on: ubuntu-latest
+        steps:
+            - uses: actions/github-script@v6
+              with:
+                  # This snippet is public-domain, taken from
+                  # https://github.com/oprypin/nightly.link/blob/master/.github/workflows/pr-comment.yml
+                  script: |
+                      async function upsertComment(owner, repo, issue_number, purpose, body) {
+                        const {data: comments} = await github.rest.issues.listComments(
+                          {owner, repo, issue_number});
+                        const marker = `<!-- bot: ${purpose} -->`;
+                        body = marker + "\n" + body;
+                        const existing = comments.filter((c) => c.body.includes(marker));
+                        if (existing.length > 0) {
+                          const last = existing[existing.length - 1];
+                          core.info(`Updating comment ${last.id}`);
+                          await github.rest.issues.updateComment({
+                            owner, repo,
+                            body,
+                            comment_id: last.id,
+                          });
+                        } else {
+                          core.info(`Creating a comment in issue / PR #${issue_number}`);
+                          await github.rest.issues.createComment({issue_number, body, owner, repo});
+                        }
+                      }
+                      const {owner, repo} = context.repo;
+                      const run_id = ${{github.event.workflow_run.id}};
+                      const pull_requests = ${{ toJSON(github.event.workflow_run.pull_requests) }};
+                      if (!pull_requests.length) {
+                        return core.error("This workflow doesn't match any pull requests!");
+                      }
+                      const artifacts = await github.paginate(
+                        github.rest.actions.listWorkflowRunArtifacts, {owner, repo, run_id});
+                      if (!artifacts.length) {
+                        return core.error(`No artifacts found`);
+                      }
+                      let body = `Download the artifacts for this pull request:\n`;
+                      for (const art of artifacts) {
+                        body += `\n* [${art.name}.zip](https://nightly.link/${owner}/${repo}/actions/artifacts/${art.id}.zip)`;
+                      }
+                      core.info("Review thread message body:", body);
+                      for (const pr of pull_requests) {
+                        await upsertComment(owner, repo, pr.number,
+                          "nightly-link", body);
+                      }

.github/workflows/publish-pr.yml

@@ -1,60 +1,108 @@
 name: Publish (PR)
 
 on:
-  pull_request:
-    branches:
-      - development
+    pull_request:
+        branches:
+            - development
+        paths:
+            - 'src/**'
 
 jobs:
-  publish:
-    runs-on: ${{ matrix.os }}
+    wait-for-lint:
+        runs-on: ubuntu-latest
+        steps:
+            - name: Wait for Test workflow to complete
+              uses: lewagon/wait-on-check-action@v1.4.1
+              with:
+                  ref: ${{ github.event.pull_request.head.sha }}
+                  check-name: 'lint'
+                  repo-token: ${{ secrets.GITHUB_TOKEN }}
+                  wait-interval: 10
+                  allowed-conclusions: success
 
-    strategy:
-      matrix:
-        os: [macos-latest]
+    publish:
+        needs: wait-for-lint
+        runs-on: ${{ matrix.os }}
 
-    steps:
-      - name: Checkout git repo
-        uses: actions/checkout@v3
+        strategy:
+            matrix:
+                os: [macos-latest, ubuntu-latest, windows-latest]
 
-      - name: Install Node and NPM
-        uses: actions/setup-node@v3
-        with:
-          node-version: 16
-          cache: npm
+        steps:
+            - name: Checkout git repo
+              uses: actions/checkout@v3
 
-      - name: Install dependencies
-        run: |
-          npm install --legacy-peer-deps
+            - name: Install Node and PNPM
+              uses: pnpm/action-setup@v4.1.0
+              with:
+                  version: 9
 
-      - name: Build releases
-        uses: nick-invision/retry@v2.8.2
-        with:
-          timeout_minutes: 30
-          max_attempts: 3
-          retry_on: error
-          command: |
-            npm run postinstall
-            npm run build
-            npm run package:pr
-          on_retry_command: npm cache clean --force
+            - name: Install dependencies
+              run: pnpm install
 
-      - uses: actions/upload-artifact@v3
-        with:
-          name: windows-binaries
-          path: |
-            release/build/*.exe
+            - name: Build for Windows
+              if: ${{ matrix.os == 'windows-latest' }}
+              uses: nick-invision/retry@v2.8.2
+              with:
+                  timeout_minutes: 30
+                  max_attempts: 3
+                  retry_on: error
+                  command: |
+                      pnpm run package:win:pr
 
-      - uses: actions/upload-artifact@v3
-        with:
-          name: linux-binaries
-          path: |
-            release/build/*.AppImage
-            release/build/*.deb
-            release/build/*.rpm
+            - name: Build for Linux
+              if: ${{ matrix.os == 'ubuntu-latest' }}
+              uses: nick-invision/retry@v2.8.2
+              with:
+                  timeout_minutes: 30
+                  max_attempts: 3
+                  retry_on: error
+                  command: |
+                      pnpm run package:linux:pr
 
-      - uses: actions/upload-artifact@v3
-        with:
-          name: macos-binaries
-          path: |
-            release/build/*.dmg
+            - name: Build for MacOS
+              if: ${{ matrix.os == 'macos-latest' }}
+              uses: nick-invision/retry@v2.8.2
+              with:
+                  timeout_minutes: 30
+                  max_attempts: 3
+                  retry_on: error
+                  command: |
+                      pnpm run package:mac:pr
+
+            - name: Zip Windows Binaries
+              if: ${{ matrix.os == 'windows-latest' }}
+              shell: pwsh
+              run: |
+                  Compress-Archive -Path "dist/*.exe" -DestinationPath "dist/windows-binaries.zip" -Force
+
+            - name: Zip Linux Binaries
+              if: ${{ matrix.os == 'ubuntu-latest' }}
+              run: |
+                  zip -r dist/linux-binaries.zip dist/*.{AppImage,deb,rpm}
+
+            - name: Zip MacOS Binaries
+              if: ${{ matrix.os == 'macos-latest' }}
+              run: |
+                  zip -r dist/macos-binaries.zip dist/*.dmg
+
+            - name: Upload Windows Binaries
+              if: ${{ matrix.os == 'windows-latest' }}
+              uses: actions/upload-artifact@v4
+              with:
+                  name: windows-binaries
+                  path: dist/windows-binaries.zip
+
+            - name: Upload Linux Binaries
+              if: ${{ matrix.os == 'ubuntu-latest' }}
+              uses: actions/upload-artifact@v4
+              with:
+                  name: linux-binaries
+                  path: dist/linux-binaries.zip
+
+            - name: Upload MacOS Binaries
+              if: ${{ matrix.os == 'macos-latest' }}
+              uses: actions/upload-artifact@v4
+              with:
+                  name: macos-binaries
+                  path: dist/macos-binaries.zip

.github/workflows/publish-windows.yml

@@ -0,0 +1,35 @@
+name: Publish Windows (Manual)
+
+on: workflow_dispatch
+
+jobs:
+    publish:
+        runs-on: ${{ matrix.os }}
+
+        strategy:
+            matrix:
+                os: [windows-latest]
+
+        steps:
+            - name: Checkout git repo
+              uses: actions/checkout@v1
+
+            - name: Install Node and PNPM
+              uses: pnpm/action-setup@v4.1.0
+              with:
+                  version: 9
+
+            - name: Install dependencies
+              run: pnpm install
+
+            - name: Build and Publish releases
+              env:
+                  GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+              uses: nick-invision/retry@v2.8.2
+              with:
+                  timeout_minutes: 30
+                  max_attempts: 3
+                  retry_on: error
+                  command: |
+                      pnpm run publish:win
+                  on_retry_command: pnpm cache delete

.github/workflows/publish-winget.yml

@@ -0,0 +1,21 @@
+name: Publish release to WinGet
+on:
+  release:
+    types: [released]
+  workflow_dispatch:
+    inputs:
+      tag_name:
+        description: "Specific tag name"
+        required: false
+        type: string
+
+jobs:
+  publish:
+    runs-on: windows-latest
+    steps:
+      - uses: vedantmgoyal9/winget-releaser@main
+        with:
+          identifier: jeffvli.Feishin
+          installers-regex: 'Feishin-*-win-x64\.exe'
+          token: ${{ secrets.WINGET_ACC_TOKEN }}
+          

.github/workflows/publish.yml

@@ -0,0 +1,75 @@
+name: Publish (Manual)
+
+on: workflow_dispatch
+
+jobs:
+    publish:
+        runs-on: ${{ matrix.os }}
+
+        strategy:
+            matrix:
+                os: [windows-latest, macos-latest, ubuntu-latest]
+
+        steps:
+            - name: Checkout git repo
+              uses: actions/checkout@v1
+
+            - name: Install Node and PNPM
+              uses: pnpm/action-setup@v4.1.0
+              with:
+                  version: 9
+
+            - name: Install dependencies
+              run: pnpm install
+
+            - name: Build and Publish releases (Windows)
+              if: matrix.os == 'windows-latest'
+              env:
+                  GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+              uses: nick-invision/retry@v2.8.2
+              with:
+                  timeout_minutes: 30
+                  max_attempts: 3
+                  retry_on: error
+                  command: |
+                      pnpm run publish:win
+                  on_retry_command: pnpm cache delete
+
+            - name: Build and Publish releases (macOS)
+              if: matrix.os == 'macos-latest'
+              env:
+                  GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+              uses: nick-invision/retry@v2.8.2
+              with:
+                  timeout_minutes: 30
+                  max_attempts: 3
+                  retry_on: error
+                  command: |
+                      pnpm run publish:mac
+                  on_retry_command: pnpm cache delete
+
+            - name: Build and Publish releases (Linux)
+              if: matrix.os == 'ubuntu-latest'
+              env:
+                  GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+              uses: nick-invision/retry@v2.8.2
+              with:
+                  timeout_minutes: 30
+                  max_attempts: 3
+                  retry_on: error
+                  command: |
+                      pnpm run publish:linux
+                  on_retry_command: pnpm cache delete
+
+            - name: Build and Publish releases (Linux ARM64)
+              if: matrix.os == 'ubuntu-latest'
+              env:
+                  GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+              uses: nick-invision/retry@v2.8.2
+              with:
+                  timeout_minutes: 30
+                  max_attempts: 3
+                  retry_on: error
+                  command: |
+                      pnpm run publish:linux-arm64
+                  on_retry_command: pnpm cache delete

.github/workflows/stale.yml

@@ -0,0 +1,47 @@
+name: 'Close stale issues and PRs'
+on:
+    workflow_dispatch:
+    schedule:
+        - cron: '30 1 * * *'
+permissions:
+    contents: read
+jobs:
+    stale:
+        permissions:
+            issues: write
+            pull-requests: write
+        runs-on: ubuntu-latest
+        steps:
+            - uses: dessant/lock-threads@v5
+              with:
+                  process-only: 'issues, prs'
+                  issue-inactive-days: 120
+                  pr-inactive-days: 120
+                  log-output: true
+                  add-issue-labels: 'frozen-due-to-age'
+                  add-pr-labels: 'frozen-due-to-age'
+            - uses: actions/stale@v9
+              with:
+                  operations-per-run: 999
+                  days-before-issue-stale: 180
+                  days-before-pr-stale: 180
+                  days-before-issue-close: 30
+                  days-before-pr-close: 30
+                  stale-issue-message: >
+                      This issue has been automatically marked as stale because it has not had recent activity. The resources of the Feishin team are limited, and so we are asking for your help.
+
+                      If this is a **bug** and you can still reproduce this error on the <code>development</code> branch, please reply with all of the information you have about it in order to keep the issue open.
+
+                      This issue will automatically be closed in the near future if no further activity occurs. Thank you for all your contributions.
+
+
+                  stale-pr-message: >
+                      This PR has been automatically marked as stale because it has not had recent activity. The resources of the Feishin team are limited, and so we are asking for your help.
+
+                      This PR will automatically be closed in the near future if no further activity occurs. Thank you for all your contributions.
+
+
+                  stale-issue-label: 'stale'
+                  exempt-issue-labels: 'keep,security'
+                  stale-pr-label: 'stale'
+                  exempt-pr-labels: 'keep,security'

.github/workflows/test.yml

@@ -3,32 +3,20 @@ name: Test
 on: [push, pull_request]
 
 jobs:
-  release:
-    runs-on: ${{ matrix.os }}
+    lint:
+        runs-on: ubuntu-latest
 
-    strategy:
-      matrix:
-        os: [macos-latest, windows-latest, ubuntu-latest]
+        steps:
+            - name: Check out Git repository
+              uses: actions/checkout@v1
 
-    steps:
-      - name: Check out Git repository
-        uses: actions/checkout@v1
+            - name: Install Node.js and PNPM
+              uses: pnpm/action-setup@v4.1.0
+              with:
+                  version: 9
 
-      - name: Install Node.js and NPM
-        uses: actions/setup-node@v2
-        with:
-          node-version: 16
-          cache: npm
+            - name: Install dependencies
+              run: pnpm install
 
-      - name: npm install
-        run: |
-          npm install --legacy-peer-deps
-
-      - name: npm test
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: |
-          npm run package
-          npm run lint
-          npm exec tsc
-          npm test
+            - name: Lint Files
+              run: pnpm run lint

.gitignore

@@ -1,31 +1,7 @@
-# Logs
-logs
-*.log
-
-# Runtime data
-pids
-*.pid
-*.seed
-
-# Coverage directory used by tools like istanbul
-coverage
-.eslintcache
-
-# Dependency directory
-# https://www.npmjs.org/doc/misc/npm-faq.html#should-i-check-my-node_modules-folder-into-git
 node_modules
-
-# OSX
+dist
+out
 .DS_Store
-
-release/app/dist
-release/build
-.erb/dll
-
-.idea
-npm-debug.log.*
-*.css.d.ts
-*.sass.d.ts
-*.scss.d.ts
-
-.env*
+.eslintcache
+*.log*
+release

.husky/pre-commit

@@ -1,4 +0,0 @@
-#!/bin/sh
-. "$(dirname "$0")/_/husky.sh"
-
-npx lint-staged

.npmrc

@@ -0,0 +1,2 @@
+legacy-peer-deps=true
+only-built-dependencies=electron,esbuild

.prettierignore

@@ -0,0 +1,6 @@
+out
+dist
+pnpm-lock.yaml
+LICENSE.md
+tsconfig.json
+tsconfig.*.json

.prettierrc

@@ -1,20 +0,0 @@
-{
-  "printWidth": 100,
-  "semi": true,
-  "singleQuote": true,
-  "overrides": [
-    {
-      "files": ["**/*.css", "**/*.scss", "**/*.html"],
-      "options": {
-        "singleQuote": false
-      }
-    }
-  ],
-  "trailingComma": "all",
-  "bracketSpacing": true,
-  "arrowParens": "always",
-  "proseWrap": "never",
-  "htmlWhitespaceSensitivity": "strict",
-  "endOfLine": "lf",
-  "singleAttributePerLine": true
-}

.prettierrc.yaml

@@ -0,0 +1,14 @@
+singleQuote: true
+semi: true
+printWidth: 100
+tabWidth: 4
+trailingComma: all
+useTabs: false
+arrowParens: always
+proseWrap: never
+htmlWhitespaceSensitivity: strict
+endOfLine: lf
+singleAttributePerLine: false
+bracketSpacing: true
+plugins:
+    - prettier-plugin-packagejson

.stylelintrc.json

@@ -1,31 +1,19 @@
 {
-  "processors": ["stylelint-processor-styled-components"],
-  "customSyntax": "postcss-scss",
-  "extends": [
-    "stylelint-config-standard-scss",
-    "stylelint-config-styled-components",
-    "stylelint-config-rational-order"
-  ],
-  "rules": {
-    "color-function-notation": ["legacy"],
-    "declaration-empty-line-before": null,
-    "order/properties-order": [],
-    "plugin/rational-order": [
-      true,
-      {
-        "border-in-box-model": false,
-        "empty-line-between-groups": false
-      }
+    "extends": [
+        "stylelint-config-standard",
+        "stylelint-config-css-modules",
+        "stylelint-config-recess-order"
     ],
-    "string-quotes": "single",
-    "declaration-block-no-redundant-longhand-properties": null,
-    "selector-class-pattern": null,
-    "selector-type-case": ["lower", { "ignoreTypes": ["/^\\$\\w+/"] }],
-    "selector-type-no-unknown": [
-      true,
-      { "ignoreTypes": ["/-styled-mixin/", "/^\\$\\w+/"] }
-    ],
-    "value-keyword-case": ["lower", { "ignoreKeywords": ["dummyValue"] }],
-    "declaration-colon-newline-after": null
-  }
+    "rules": {
+        "block-no-empty": null,
+        "selector-type-case": ["lower", { "ignoreTypes": ["/^\\$\\w+/"] }],
+        "selector-type-no-unknown": [true, { "ignoreTypes": ["/-styled-mixin/", "/^\\$\\w+/"] }],
+        "declaration-block-no-shorthand-property-overrides": null,
+        "declaration-block-no-redundant-longhand-properties": null,
+        "at-rule-no-unknown": [true, { "ignoreAtRules": ["mixin", "value"] }],
+        "function-no-unknown": [true, { "ignoreFunctions": ["darken", "alpha", "lighten"] }],
+        "declaration-property-value-no-unknown": null,
+        "no-descending-specificity": null,
+        "no-empty-source": null
+    }
 }

.vscode/extensions.json

@@ -1,8 +1,3 @@
 {
-  "recommendations": [
-    "dbaeumer.vscode-eslint",
-    "EditorConfig.EditorConfig",
-    "stylelint.vscode-stylelint",
-    "esbenp.prettier-vscode"
-  ]
+  "recommendations": ["dbaeumer.vscode-eslint"]
 }

.vscode/launch.json

@@ -2,29 +2,38 @@
   "version": "0.2.0",
   "configurations": [
     {
-      "name": "Electron: Main",
+      "name": "Debug Main Process",
       "type": "node",
       "request": "launch",
-      "protocol": "inspector",
-      "runtimeExecutable": "npm",
-      "runtimeArgs": [
-        "run start:main --inspect=5858 --remote-debugging-port=9223"
-      ],
-      "preLaunchTask": "Start Webpack Dev"
+      "cwd": "${workspaceRoot}",
+      "runtimeExecutable": "${workspaceRoot}/node_modules/.bin/electron-vite",
+      "windows": {
+        "runtimeExecutable": "${workspaceRoot}/node_modules/.bin/electron-vite.cmd"
+      },
+      "runtimeArgs": ["--sourcemap"],
+      "env": {
+        "REMOTE_DEBUGGING_PORT": "9222"
+      }
     },
     {
-      "name": "Electron: Renderer",
-      "type": "chrome",
+      "name": "Debug Renderer Process",
+      "port": 9222,
       "request": "attach",
-      "port": 9223,
-      "webRoot": "${workspaceFolder}",
-      "timeout": 15000
+      "type": "chrome",
+      "webRoot": "${workspaceFolder}/src/renderer",
+      "timeout": 60000,
+      "presentation": {
+        "hidden": true
+      }
     }
   ],
   "compounds": [
     {
-      "name": "Electron: All",
-      "configurations": ["Electron: Main", "Electron: Renderer"]
+      "name": "Debug All",
+      "configurations": ["Debug Main Process", "Debug Renderer Process"],
+      "presentation": {
+        "order": 1
+      }
     }
   ]
 }

.vscode/settings.json

@@ -1,43 +1,84 @@
 {
-  "files.associations": {
-    ".eslintrc": "jsonc",
-    ".prettierrc": "jsonc",
-    ".eslintignore": "ignore"
-  },
-  "eslint.validate": ["typescript"],
-  "eslint.workingDirectories": [
-    { "directory": "./", "changeProcessCWD": true },
-    { "directory": "./server", "changeProcessCWD": true }
-  ],
-  "typescript.tsserver.experimental.enableProjectDiagnostics": true,
-  "editor.tabSize": 2,
-  "editor.codeActionsOnSave": {
-    "source.fixAll.eslint": true,
-    "source.fixAll.stylelint": false
-  },
-  "css.validate": false,
-  "less.validate": false,
-  "scss.validate": false,
-  "javascript.validate.enable": false,
-  "javascript.format.enable": false,
-  "typescript.format.enable": false,
-  "search.exclude": {
-    ".git": true,
-    ".eslintcache": true,
-    ".erb/dll": true,
-    "release/{build,app/dist}": true,
-    "node_modules": true,
-    "npm-debug.log.*": true,
-    "test/**/__snapshots__": true,
-    "package-lock.json": true,
-    "*.{css,sass,scss}.d.ts": true
-  },
-  "i18n-ally.localesPaths": ["src/i18n", "src/i18n/locales"],
-  "typescript.tsdk": "node_modules\\typescript\\lib",
-  "typescript.preferences.importModuleSpecifier": "non-relative",
-  "stylelint.validate": ["css", "less", "postcss", "typescript", "typescriptreact", "scss"],
-  "typescript.updateImportsOnFileMove.enabled": "always",
-  "[typescript]": { "editor.defaultFormatter": "esbenp.prettier-vscode" },
-  "[typescriptreact]": { "editor.defaultFormatter": "esbenp.prettier-vscode" },
-  "typescript.format.insertSpaceAfterOpeningAndBeforeClosingTemplateStringBraces": true
+    "[typescript]": {
+        "editor.defaultFormatter": "esbenp.prettier-vscode"
+    },
+    "[javascript]": {
+        "editor.defaultFormatter": "esbenp.prettier-vscode"
+    },
+    "[json]": {
+        "editor.defaultFormatter": "esbenp.prettier-vscode"
+    },
+    "files.associations": {
+        ".eslintrc": "jsonc",
+        ".prettierrc": "jsonc",
+        ".eslintignore": "ignore"
+    },
+    "eslint.validate": ["typescript", "typescriptreact"],
+    "eslint.workingDirectories": [{ "directory": "./", "changeProcessCWD": true }],
+    "typescript.tsserver.experimental.enableProjectDiagnostics": false,
+    "editor.codeActionsOnSave": {
+        "source.fixAll.eslint": "explicit",
+        "source.fixAll.stylelint": "explicit",
+        "source.organizeImports": "never",
+        "source.formatDocument": "explicit"
+    },
+    "css.validate": true,
+    "javascript.validate.enable": false,
+    "javascript.format.enable": false,
+    "typescript.format.enable": false,
+    "search.exclude": {
+        ".git": true,
+        ".eslintcache": true,
+        ".erb/dll": true,
+        "release/{build,app/dist}": true,
+        "node_modules": true,
+        "npm-debug.log.*": true,
+        "test/**/__snapshots__": true,
+        "package-lock.json": true,
+        "*.{css,sass,scss}.d.ts": true,
+        "out/**/*": true,
+        "dist/**/*": true
+    },
+    "i18n-ally.localesPaths": ["src/i18n", "src/i18n/locales"],
+    "typescript.tsdk": "node_modules/typescript/lib",
+    "typescript.preferences.importModuleSpecifier": "non-relative",
+    "stylelint.config": null,
+    "stylelint.validate": ["css", "postcss"],
+    "typescript.updateImportsOnFileMove.enabled": "always",
+    "typescript.preferences.autoImportFileExcludePatterns": [
+        "@mantine/core",
+        "@mantine/modals",
+        "@mantine/dates",
+        "@mantine/hooks",
+        "@mantine/form",
+        "@radix-ui/react-context-menu"
+    ],
+    "[typescriptreact]": { "editor.defaultFormatter": "esbenp.prettier-vscode" },
+    "typescript.format.insertSpaceAfterOpeningAndBeforeClosingTemplateStringBraces": true,
+    "folderTemplates.structures": [
+        {
+            "name": "TypeScript Feature Component With CSS Modules",
+            "omitParentDirectory": true,
+            "structure": [
+                {
+                    "fileName": "<FTName | kebabcase>.tsx",
+                    "template": "Functional Component with CSS Modules"
+                },
+                {
+                    "fileName": "<FTName | kebabcase>.module.css"
+                }
+            ]
+        }
+    ],
+    "folderTemplates.fileTemplates": {
+        "Functional Component with CSS Modules": [
+            "import styles from './<FTName | kebabcase>.module.css';",
+            "",
+            "interface <FTName | pascalcase>Props {}",
+            "",
+            "export const <FTName | pascalcase> = ({}: <FTName | pascalcase>Props) => {",
+            "  return <div></div>;",
+            "};"
+        ]
+    }
 }

.vscode/tasks.json

@@ -1,25 +0,0 @@
-{
-  "version": "2.0.0",
-  "tasks": [
-    {
-      "type": "npm",
-      "label": "Start Webpack Dev",
-      "script": "start:renderer",
-      "options": {
-        "cwd": "${workspaceFolder}"
-      },
-      "isBackground": true,
-      "problemMatcher": {
-        "owner": "custom",
-        "pattern": {
-          "regexp": "____________"
-        },
-        "background": {
-          "activeOnStart": true,
-          "beginsPattern": "Compiling\\.\\.\\.$",
-          "endsPattern": "(Compiled successfully|Failed to compile)\\.$"
-        }
-      }
-    }
-  ]
-}

Dockerfile

@@ -0,0 +1,27 @@
+# --- Builder stage
+FROM node:23-alpine as builder
+WORKDIR /app
+
+# Copy package.json first to cache node_modules
+COPY package.json pnpm-lock.yaml .
+
+RUN npm install -g pnpm
+
+RUN pnpm install
+
+# Copy code and build with cached modules
+COPY . .
+RUN pnpm run build:web
+
+# --- Production stage
+FROM nginx:alpine-slim
+
+COPY --chown=nginx:nginx --from=builder /app/out/web /usr/share/nginx/html
+COPY ./settings.js.template /etc/nginx/templates/settings.js.template
+COPY ng.conf.template /etc/nginx/templates/default.conf.template
+
+ENV SERVER_LOCK=false SERVER_NAME="" SERVER_TYPE="" SERVER_URL=""
+ENV LEGACY_AUTHENTICATION="" ANALYTICS_DISABLED="" PUBLIC_PATH="/"
+
+EXPOSE 9180
+CMD ["nginx", "-g", "daemon off;"]

README.md

@@ -1,3 +1,5 @@
+<img src="assets/icons/icon.png" alt="logo" title="feishin" align="right" height="60px" width="60px" />
+
 # Feishin
 
   <p align="center">
@@ -25,6 +27,8 @@
     </a>
   </p>
 
+---
+
 Rewrite of [Sonixd](https://github.com/jeffvli/sonixd).
 
 ## Features
@@ -34,33 +38,175 @@ Rewrite of [Sonixd](https://github.com/jeffvli/sonixd).
 - [x] Modern UI
 - [x] Scrobble playback to your server
 - [x] Smart playlist editor (Navidrome)
+- [x] Synchronized and unsynchronized lyrics support
 - [ ] [Request a feature](https://github.com/jeffvli/feishin/issues) or [view taskboard](https://github.com/users/jeffvli/projects/5/views/1)
 
 ## Screenshots
 
-<a href="https://raw.githubusercontent.com/jeffvli/feishin/development/media/preview_home.png"><img src="https://raw.githubusercontent.com/jeffvli/feishin/development/media/preview_home.png" width="49.5%"/></a> <a href="https://raw.githubusercontent.com/jeffvli/feishin/development/media/preview_album_artist_detail.png"><img src="https://raw.githubusercontent.com/jeffvli/feishin/development/media/preview_album_artist_detail.png" width="49.5%"/></a> <a href="https://raw.githubusercontent.com/jeffvli/feishin/development/media/preview_album_detail.png"><img src="https://raw.githubusercontent.com/jeffvli/feishin/development/media/preview_album_detail.png" width="49.5%"/></a> <a href="https://raw.githubusercontent.com/jeffvli/feishin/development/media/preview_smart_playlist.png"><img src="https://raw.githubusercontent.com/jeffvli/feishin/development/media/preview_smart_playlist.png" width="49.5%"/></a>
+<a href="./media/preview_full_screen_player.png"><img src="./media/preview_full_screen_player.png" width="49.5%"/></a> <a href="./media/preview_album_artist_detail.png"><img src="./media/preview_album_artist_detail.png" width="49.5%"/></a> <a href="./media/preview_album_detail.png"><img src="./media/preview_album_detail.png" width="49.5%"/></a> <a href="./media/preview_smart_playlist.png"><img src="./media/preview_smart_playlist.png" width="49.5%"/></a>
 
 ## Getting Started
 
-Download the [latest desktop client](https://github.com/jeffvli/feishin/releases).
+### Desktop (recommended)
+
+Download the [latest desktop client](https://github.com/jeffvli/feishin/releases). The desktop client is the recommended way to use Feishin. It supports both the MPV and web player backends, as well as includes built-in fetching for lyrics.
+
+#### macOS Notes
+
+If you're using a device running macOS 12 (Monterey) or higher, [check here](https://github.com/jeffvli/feishin/issues/104#issuecomment-1553914730) for instructions on how to remove the app from quarantine.
+
+For media keys to work, you will be prompted to allow Feishin to be a Trusted Accessibility Client. After allowing, you will need to restart Feishin for the privacy settings to take effect.
+
+#### Linux Notes
+
+We provide a small install script to download the latest `.AppImage`, make it executable, and also download the icons required by Desktop Environments. Finally, it generates a `.desktop` file to add Feishin to your Application Launcher.
+
+Simply run the installer like this:
+
+```sh
+dir=/your/application/directory
+curl 'https://raw.githubusercontent.com/jeffvli/feishin/refs/heads/development/install-feishin-appimage' | sh -s -- "$dir"
+```
+
+The script also has an option to add launch arguments to run Feishin in native Wayland mode. Note that this is experimental in Electron and therefore not officially supported. If you want to use it, run this instead:
+
+```sh
+dir=/your/application/directory
+curl 'https://raw.githubusercontent.com/jeffvli/feishin/refs/heads/development/install-feishin-appimage' | sh -s -- "$dir" wayland-native
+```
+
+It also provides a simple uninstall routine, removing the downloaded files:
+
+```sh
+dir=/your/application/directory
+curl 'https://raw.githubusercontent.com/jeffvli/feishin/refs/heads/development/install-feishin-appimage' | sh -s -- "$dir" remove
+```
+
+The entry should show up in your Application Launcher immediately. If it does not, simply log out, wait 10 seconds, and log back in. Your Desktop Environment may alternatively provide a way to reload entries.
+
+### Web and Docker
+
+Visit [https://feishin.vercel.app](https://feishin.vercel.app) to use the hosted web version of Feishin. The web client only supports the web player backend.
+
+Feishin is also available as a Docker image. The images are hosted via `ghcr.io` and are available to view [here](https://github.com/jeffvli/feishin/pkgs/container/feishin). You can run the container using the following commands:
+
+```bash
+# Run the latest version
+docker run --name feishin -p 9180:9180 ghcr.io/jeffvli/feishin:latest
+
+# Build the image locally
+docker build -t feishin .
+docker run --name feishin -p 9180:9180 feishin
+```
+
+#### Docker Compose
+
+To install via Docker Compose, use the following snippet. This also works on Portainer.
+
+```yaml
+services:
+    feishin:
+        container_name: feishin
+        image: 'ghcr.io/jeffvli/feishin:latest'
+        restart: unless-stopped
+        environment:
+            - SERVER_NAME=jellyfin # pre-defined server name
+            - SERVER_LOCK=true # When true AND name/type/url are set, only username/password can be toggled
+            - SERVER_TYPE=jellyfin # the allowed types are: jellyfin, navidrome, subsonic. These values are case insensitive
+            - SERVER_URL= # http://address:port or https://address:port
+            - LEGACY_AUTHENTICATION=false # When SERVER_LOCK is true, sets the legacy (plaintext) authentication flag for Subsonic/OpenSubsonic servers
+            - ANALYTICS_DISABLED=true # Set to true to disable Umami analytics tracking
+        ports:
+            - 9180:9180
+            # Alternatively, to restrict to only localhost, - 127.0.0.1:9180:8190
+```
+
+### Configuration
+
+1. Upon startup you will be greeted with a prompt to select the path to your MPV binary. If you do not have MPV installed, you can download it [here](https://mpv.io/installation/) or install it using any package manager supported by your OS. After inputting the path, restart the app.
+
+2. After restarting the app, you will be prompted to select a server. Click the `Open menu` button and select `Manage servers`. Click the `Add server` button in the popup and fill out all applicable details. You will need to enter the full URL to your server, including the protocol and port if applicable (e.g. `https://navidrome.my-server.com` or `http://192.168.0.1:4533`).
+
+- **Navidrome** - For the best experience, select "Save password" when creating the server and configure the `SessionTimeout` setting in your Navidrome config to a larger value (e.g. 72h).
+    - **Linux users** - The default password store uses `libsecret`. `kwallet4/5/6` are also supported, but must be explicitly set in Settings > Window > Passwords/secret store.
+
+3. _Optional_ - If you want to host Feishin on a subpath (not `/`), then pass in the following environment variable: `PUBLIC_PATH=PATH`. For example, to host on `/feishin`, pass in `PUBLIC_PATH=/feishin`.
+
+4. _Optional_ - To hard code the server url, pass the following environment variables: `SERVER_NAME`, `SERVER_TYPE` (one of `jellyfin` or `navidrome` or `subsonic`), `SERVER_URL`. To prevent users from changing these settings, pass `SERVER_LOCK=true`. This can only be set if all three of the previous values are set. When `SERVER_LOCK=true`, you can also set `LEGACY_AUTHENTICATION=true` or `LEGACY_AUTHENTICATION=false` to configure the legacy authentication flag for the server (only applicable for Subsonic/OpenSubsonic servers).
+
+5. _Optional_ - To disable Umami analytics tracking in the Docker/web version, set the environment variable `ANALYTICS_DISABLED=true`. When enabled, the analytics script will not be loaded and all tracking will be disabled.
 
 ## FAQ
 
+### MPV is either not working or is rapidly switching between pause/play states
+
+First thing to do is check that your MPV binary path is correct. Navigate to the settings page and re-set the path and restart the app. If your issue still isn't resolved, try reinstalling MPV. Known working versions include `v0.35.x` and `v0.36.x`. `v0.34.x` is a known broken version.
+
 ### What music servers does Feishin support?
 
-Feishin supports any music server that implements a [Navidrome](https://www.navidrome.org/) or [Jellyfin](https://jellyfin.org/) API. **Subsonic API is not currently supported**. This will likely be added in [later when the new Subsonic API is decided on](https://support.symfonium.app/t/subsonic-servers-participation/1233).
+Feishin supports any music server that implements a [Navidrome](https://www.navidrome.org/), [Jellyfin](https://jellyfin.org/), or [OpenSubsonic compatible](https://opensubsonic.netlify.app/) API.
 
 - [Navidrome](https://github.com/navidrome/navidrome)
 - [Jellyfin](https://github.com/jellyfin/jellyfin)
-- ~~[Gonic](https://github.com/sentriz/gonic)~~
-- ~~[Astiga](https://asti.ga/)~~
-- ~~[Supysonic](https://github.com/spl0k/supysonic)~~
+- [OpenSubsonic](https://opensubsonic.netlify.app/) compatible servers, such as...
+    - [Airsonic-Advanced](https://github.com/airsonic-advanced/airsonic-advanced)
+    - [Ampache](https://ampache.org)
+    - [Astiga](https://asti.ga/)
+    - [Funkwhale](https://www.funkwhale.audio/)
+    - [Gonic](https://github.com/sentriz/gonic)
+    - [LMS](https://github.com/epoupon/lms)
+    - [Nextcloud Music](https://apps.nextcloud.com/apps/music)
+    - [Supysonic](https://github.com/spl0k/supysonic)
+    - [Qm-Music](https://github.com/chenqimiao/qm-music)
+    - More (?)
+
+### I have the issue "The SUID sandbox helper binary was found, but is not configured correctly" on Linux
+
+This happens when you have user (unprivileged) namespaces disabled (`sysctl kernel.unprivileged_userns_clone` returns 0). You can fix this by either enabling unprivileged namespaces, or by making the `chrome-sandbox` Setuid.
+
+```bash
+chmod 4755 chrome-sandbox
+sudo chown root:root chrome-sandbox
+```
+
+Ubuntu 24.04 specifically introduced breaking changes that affect how namespaces work. Please see https://discourse.ubuntu.com/t/ubuntu-24-04-lts-noble-numbat-release-notes/39890#:~:text=security%20improvements%20 for possible fixes.
 
 ## Development
 
-Built and tested using Node `v16.15.0`.
+Built and tested using Node `v23.11.0`.
 
-This project is built off of [electron-react-boilerplate](https://github.com/electron-react-boilerplate/electron-react-boilerplate) v4.6.0.
+This project is built off of [electron-vite](https://github.com/alex8088/electron-vite)
+
+- `pnpm run dev` - Start the development server
+- `pnpm run dev:watch` - Start the development server in watch mode (for main / preload HMR)
+- `pnpm run start` - Starts the app in production preview mode
+- `pnpm run build` - Builds the app for desktop
+- `pnpm run build:electron` - Build the electron app (main, preload, and renderer)
+- `pnpm run build:remote` - Build the remote app (remote)
+- `pnpm run build:web` - Build the standalone web app (renderer)
+- `pnpm run package` - Package the project
+- `pnpm run package:dev` - Package the project for development locally
+- `pnpm run package:linux` - Package the project for Linux locally
+- `pnpm run package:mac` - Package the project for Mac locally
+- `pnpm run package:win` - Package the project for Windows locally
+- `pnpm run publish:linux` - Publish the project for Linux
+- `pnpm run publish:linux:beta` - Publish the project for Linux (beta channel)
+- `pnpm run publish:linux-arm64` - Publish the project for Linux ARM64
+- `pnpm run publish:linux-arm64:beta` - Publish the project for Linux ARM64 (beta channel)
+- `pnpm run publish:mac` - Publish the project for Mac
+- `pnpm run publish:mac:beta` - Publish the project for Mac (beta channel)
+- `pnpm run publish:win` - Publish the project for Windows
+- `pnpm run publish:win:beta` - Publish the project for Windows (beta channel)
+- `pnpm run typecheck` - Type check the project
+- `pnpm run typecheck:node` - Type check the project with tsconfig.node.json
+- `pnpm run typecheck:web` - Type check the project with tsconfig.web.json
+- `pnpm run lint` - Lint the project
+- `pnpm run lint:fix` - Lint the project and fix linting errors
+- `pnpm run i18next` - Generate i18n files
+
+## Translation
+
+This project uses [Weblate](https://hosted.weblate.org/projects/feishin/) for translations. If you would like to contribute, please visit the link and submit a translation.
 
 ## License
 

assets/assets.d.ts

@@ -1,31 +1,31 @@
 type Styles = Record<string, string>;
 
 declare module '*.svg' {
-  const content: string;
-  export default content;
+    const content: string;
+    export default content;
 }
 
 declare module '*.png' {
-  const content: string;
-  export default content;
+    const content: string;
+    export default content;
 }
 
 declare module '*.jpg' {
-  const content: string;
-  export default content;
+    const content: string;
+    export default content;
 }
 
 declare module '*.scss' {
-  const content: Styles;
-  export default content;
+    const content: Styles;
+    export default content;
 }
 
 declare module '*.sass' {
-  const content: Styles;
-  export default content;
+    const content: Styles;
+    export default content;
 }
 
 declare module '*.css' {
-  const content: Styles;
-  export default content;
+    const content: Styles;
+    export default content;
 }

assets/entitlements.mac.plist

@@ -2,9 +2,11 @@
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0">
   <dict>
+    <key>com.apple.security.cs.allow-jit</key>
+    <true/>
     <key>com.apple.security.cs.allow-unsigned-executable-memory</key>
     <true/>
-    <key>com.apple.security.cs.allow-jit</key>
+    <key>com.apple.security.cs.allow-dyld-environment-variables</key>
     <true/>
   </dict>
 </plist>

dev-app-update.yml

@@ -0,0 +1,3 @@
+provider: generic
+url: https://example.com/auto-updates
+updaterCacheDirName: feishin-updater

docker-compose.yaml

@@ -0,0 +1,15 @@
+services:
+    feishin:
+        container_name: feishin
+        image: "ghcr.io/jeffvli/feishin:latest"
+        restart: unless-stopped
+        environment:
+            - SERVER_NAME=jellyfin # pre-defined server name
+            - SERVER_LOCK=false # When true AND name/type/url are set, only username/password can be toggled
+            - SERVER_TYPE=jellyfin # the allowed types are: jellyfin, navidrome, subsonic. These values are case insensitive
+            - SERVER_URL=http://localhost:8096 # http://address:port or https://address:port
+            - LEGACY_AUTHENTICATION=false # When SERVER_LOCK is true, sets the legacyauth flag for server authentication (true or false)
+            - ANALYTICS_DISABLED=false # Set to true to disable Umami analytics tracking
+        ports:
+            - 9180:9180
+            # Alternatively, to restrict to only localhost, - 127.0.0.1:9180:8190

electron-builder-beta.yml

@@ -0,0 +1,59 @@
+appId: org.jeffvli.feishin
+productName: Feishin
+artifactName: ${productName}-${version}-${os}-${arch}.${ext}
+electronVersion: 39.4.0
+directories:
+    buildResources: assets
+files:
+    - 'out/**/*'
+    - 'package.json'
+extraResources:
+    - assets/**
+asarUnpack:
+    - resources/**
+win:
+    target:
+        - zip
+        - nsis
+    icon: assets/icons/icon.png
+
+nsis:
+    allowToChangeInstallationDirectory: true
+    oneClick: false
+    shortcutName: ${productName}
+    uninstallDisplayName: ${productName}
+    createDesktopShortcut: always
+
+mac:
+    target:
+        target: default
+        arch:
+            - arm64
+            - x64
+    icon: assets/icons/icon.icns
+    type: distribution
+    hardenedRuntime: true
+    entitlements: assets/entitlements.mac.plist
+    entitlementsInherit: assets/entitlements.mac.plist
+    gatekeeperAssess: false
+    notarize: false
+
+dmg:
+    contents: [{ x: 130, y: 220 }, { x: 410, y: 220, type: link, path: /Applications }]
+
+linux:
+    target:
+        - AppImage
+        - deb
+        - tar.xz
+    category: AudioVideo;Audio;Player
+    icon: assets/icons/icon.png
+    artifactName: ${productName}-${os}-${arch}.${ext}
+
+npmRebuild: false
+publish:
+    provider: github
+    owner: jeffvli
+    repo: feishin
+    channel: beta
+    releaseType: draft

electron-builder.yml

@@ -0,0 +1,59 @@
+appId: org.jeffvli.feishin
+productName: Feishin
+artifactName: ${productName}-${version}-${os}-${arch}.${ext}
+electronVersion: 39.4.0
+directories:
+    buildResources: assets
+files:
+    - 'out/**/*'
+    - 'package.json'
+extraResources:
+    - assets/**
+asarUnpack:
+    - resources/**
+win:
+    target:
+        - zip
+        - nsis
+    icon: assets/icons/icon.ico
+
+nsis:
+    allowToChangeInstallationDirectory: true
+    oneClick: false
+    shortcutName: ${productName}
+    uninstallDisplayName: ${productName}
+    createDesktopShortcut: always
+
+mac:
+    target:
+        target: default
+        arch:
+            - arm64
+            - x64
+    icon: assets/icons/icon.icns
+    type: distribution
+    hardenedRuntime: true
+    entitlements: assets/entitlements.mac.plist
+    entitlementsInherit: assets/entitlements.mac.plist
+    gatekeeperAssess: false
+    notarize: false
+
+dmg:
+    contents: [{ x: 130, y: 220 }, { x: 410, y: 220, type: link, path: /Applications }]
+
+linux:
+    target:
+        - AppImage
+        - deb
+        - tar.xz
+    category: AudioVideo;Audio;Player
+    icon: assets/icons/icon.png
+    artifactName: ${productName}-${os}-${arch}.${ext}
+
+npmRebuild: false
+publish:
+    provider: github
+    owner: jeffvli
+    repo: feishin
+    channel: latest
+    releaseType: draft

electron.vite.config.ts

@@ -0,0 +1,79 @@
+import react from '@vitejs/plugin-react';
+import { externalizeDepsPlugin, UserConfig } from 'electron-vite';
+import { resolve } from 'path';
+import conditionalImportPlugin from 'vite-plugin-conditional-import';
+import dynamicImportPlugin from 'vite-plugin-dynamic-import';
+import { ViteEjsPlugin } from 'vite-plugin-ejs';
+
+const currentOSEnv = process.platform;
+const electronRendererTarget = 'chrome87';
+
+const config: UserConfig = {
+    main: {
+        build: {
+            rollupOptions: {
+                external: ['source-map-support'],
+            },
+            sourcemap: true,
+        },
+        define: {
+            'import.meta.env.IS_LINUX': JSON.stringify(currentOSEnv === 'linux'),
+            'import.meta.env.IS_MACOS': JSON.stringify(currentOSEnv === 'darwin'),
+            'import.meta.env.IS_WIN': JSON.stringify(currentOSEnv === 'win32'),
+        },
+        plugins: [
+            externalizeDepsPlugin(),
+            dynamicImportPlugin(),
+            conditionalImportPlugin({
+                currentEnv: currentOSEnv,
+                envs: ['win32', 'linux', 'darwin'],
+            }),
+        ],
+        resolve: {
+            alias: {
+                '/@/main': resolve('src/main'),
+                '/@/shared': resolve('src/shared'),
+            },
+        },
+    },
+    preload: {
+        build: {
+            sourcemap: true,
+        },
+        plugins: [externalizeDepsPlugin()],
+        resolve: {
+            alias: {
+                '/@/preload': resolve('src/preload'),
+                '/@/shared': resolve('src/shared'),
+            },
+        },
+    },
+    renderer: {
+        build: {
+            cssMinify: 'esbuild',
+            minify: 'esbuild',
+            modulePreload: {
+                polyfill: false,
+            },
+            sourcemap: true,
+            target: electronRendererTarget,
+        },
+        css: {
+            modules: {
+                generateScopedName: 'fs-[name]-[local]',
+                localsConvention: 'camelCase',
+            },
+        },
+        plugins: [react(), ViteEjsPlugin({ web: false })],
+        resolve: {
+            alias: {
+                '/@/i18n': resolve('src/i18n'),
+                '/@/remote': resolve('src/remote'),
+                '/@/renderer': resolve('src/renderer'),
+                '/@/shared': resolve('src/shared'),
+            },
+        },
+    },
+};
+
+export default config;

eslint.config.mjs

@@ -0,0 +1,55 @@
+import eslintConfigPrettier from '@electron-toolkit/eslint-config-prettier';
+import tseslint from '@electron-toolkit/eslint-config-ts';
+import perfectionist from 'eslint-plugin-perfectionist';
+import eslintPluginReact from 'eslint-plugin-react';
+import eslintPluginReactHooks from 'eslint-plugin-react-hooks';
+import eslintPluginReactRefresh from 'eslint-plugin-react-refresh';
+
+export default tseslint.config(
+    { ignores: ['**/node_modules', '**/dist', '**/out'] },
+    tseslint.configs.recommended,
+    perfectionist.configs['recommended-natural'],
+    eslintPluginReact.configs.flat.recommended,
+    eslintPluginReact.configs.flat['jsx-runtime'],
+    {
+        settings: {
+            react: {
+                version: 'detect',
+            },
+        },
+    },
+    {
+        files: ['**/*.{ts,tsx}'],
+        plugins: {
+            'react-hooks': eslintPluginReactHooks,
+            'react-refresh': eslintPluginReactRefresh,
+        },
+        rules: {
+            ...eslintPluginReactHooks.configs.recommended.rules,
+            ...eslintPluginReactRefresh.configs.vite.rules,
+            '@typescript-eslint/explicit-function-return-type': 'off',
+            '@typescript-eslint/no-duplicate-enum-values': 'off',
+            '@typescript-eslint/no-explicit-any': 'off',
+            '@typescript-eslint/no-unused-vars': 'warn',
+            curly: ['error', 'all'],
+            indent: [
+                'error',
+                'tab',
+                {
+                    offsetTernaryExpressions: true,
+                    SwitchCase: 1,
+                },
+            ],
+            'no-unused-vars': 'off',
+            'no-use-before-define': 'off',
+            quotes: ['error', 'single'],
+            'react-hooks/refs': 'off',
+            'react-hooks/set-state-in-effect': 'off',
+            'react-refresh/only-export-components': 'off',
+            'react/display-name': 'off',
+            semi: ['error', 'always'],
+            'single-attribute-per-line': 'off',
+        },
+    },
+    eslintConfigPrettier,
+);

feishin.desktop.tmpl

@@ -0,0 +1,13 @@
+[Desktop Entry]
+Name=Feishin
+GenericName=Music player
+Exec=${FEISHIN_DESKTOP_EXECUTABLE} ${FEISHIN_DESKTOP_ARGS}
+TryExec=${FEISHIN_DESKTOP_EXECUTABLE}
+Terminal=false
+Type=Application
+Icon=org.jeffvli.feishin
+StartupWMClass=feishin
+SingleMainWindow=true
+Categories=AudioVideo;Audio;Player;Music;
+Keywords=Navidrome;Jellyfin;Subsonic;OpenSubsonic
+Comment=A player for your self-hosted music server

install-feishin-appimage

@@ -0,0 +1,79 @@
+#!/bin/sh
+
+set -eu
+
+if [ "$#" -lt 1 ]; then
+    echo "Usage: $0 <installation-directory> <option>"
+    echo "Options:"
+    echo "  wayland-native   Enable native Wayland support"
+    echo "  remove           Remove Feishin AppImage and desktop entries"
+    exit 1
+fi
+
+dir="$(readlink -f "${1}")"
+arg="${2:-""}"
+arch="$(uname -m)"
+
+if [ "$arg" != "wayland-native" ] && [ "$arg" != "remove" ] && [ "$arg" != "" ]; then
+    echo "Invalid option: $arg"
+    echo "Valid options are: wayland-native, remove"
+    exit 1
+fi
+
+if [ "${arch}" != "x86_64" ] && [ "${arch}" != "aarch64" ]; then
+	echo "CPU architecture not recognised (not x86_64 or aarch64). Aborting."
+	exit 1
+fi
+
+# workaround if we're not renaming the artifact
+if [ "${arch}" = "aarch64" ]; then
+	arch="arm64"
+fi
+
+if [ ! -d "${dir}" ]; then
+	echo "${dir} is not a directory or does not exist. Please provide an existing directory."
+	exit 1
+fi
+
+localShare="${XDG_DATA_HOME:-$HOME/.local/share}"
+localShareIcons="${localShare}/icons/hicolor"
+
+if [ "${arg}" = "remove" ]; then
+	rm -v \
+		"${localShareIcons}/512x512/apps/org.jeffvli.feishin.png" \
+		"${localShareIcons}/256x256/apps/org.jeffvli.feishin.png" \
+		"${localShareIcons}/128x128/apps/org.jeffvli.feishin.png" \
+		"${localShareIcons}/64x64/apps/org.jeffvli.feishin.png" \
+		"${localShareIcons}/32x32/apps/org.jeffvli.feishin.png" \
+		"${localShare}/applications/org.jeffvli.feishin.desktop" \
+		"${dir}/Feishin-linux-${arch}.AppImage"
+	exit 0
+fi
+
+curl --fail -L --create-dirs --write-out '%{filename_effective}\n' \
+	-o "${dir}/Feishin-linux-${arch}.AppImage" "https://github.com/jeffvli/feishin/releases/latest/download/Feishin-linux-${arch}.AppImage" \
+	-o "${localShareIcons}/512x512/apps/org.jeffvli.feishin.png" 'https://github.com/jeffvli/feishin/blob/development/assets/icons/512x512.png?raw=true' \
+	-o "${localShareIcons}/256x256/apps/org.jeffvli.feishin.png" 'https://github.com/jeffvli/feishin/blob/development/assets/icons/256x256.png?raw=true' \
+	-o "${localShareIcons}/128x128/apps/org.jeffvli.feishin.png" 'https://github.com/jeffvli/feishin/blob/development/assets/icons/128x128.png?raw=true' \
+	-o "${localShareIcons}/64x64/apps/org.jeffvli.feishin.png" 'https://github.com/jeffvli/feishin/blob/development/assets/icons/64x64.png?raw=true' \
+	-o "${localShareIcons}/32x32/apps/org.jeffvli.feishin.png" 'https://github.com/jeffvli/feishin/blob/development/assets/icons/32x32.png?raw=true'
+chmod -v u+x "${dir}/Feishin-linux-${arch}.AppImage"
+
+waylandFlags=""
+if [ "${arg}" = "wayland-native" ]; then
+	waylandFlags="--enable-features=UseOzonePlatform,WaylandWindowDecorations --ozone-platform-hint=auto"
+fi
+
+# this is for Debian-based kernels and ALT respectively
+# https://unix.stackexchange.com/a/303214/145722
+sandboxFlag=""
+if [ "$(sysctl kernel.unprivileged_userns_clone 2>/dev/null)" = "0" ] \
+	|| [ "$(sysctl kernel.userns_restrict 2>/dev/null)" = "1" ]; then
+	sandboxFlag="--no-sandbox"
+fi
+
+mkdir -pv "${localShare}/applications"
+
+export FEISHIN_DESKTOP_EXECUTABLE="${dir}/Feishin-linux-${arch}.AppImage"
+export FEISHIN_DESKTOP_ARGS="${sandboxFlag} ${waylandFlags}"
+curl --fail https://raw.githubusercontent.com/jeffvli/feishin/refs/heads/development/feishin.desktop.tmpl | envsubst > "${localShare}/applications/org.jeffvli.feishin.desktop"