convert remaining locales to sentence case

Currently translated at 100.0% (1205 of 1205 strings) (Dutch)
Translation: feishin/Translation
Translate-URL: https://hosted.weblate.org/projects/feishin/translation/nl/

Translated using Weblate

Currently translated at 100.0% (1205 of 1205 strings) (Dutch)
Translation: feishin/Translation
Translate-URL: https://hosted.weblate.org/projects/feishin/translation/nl/

Co-authored-by: Joren Vansteenkiste <vansteenkiste.joren@telenet.be>
Co-authored-by: bokse <weblate@bokse.nl>

.gitattributes

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

.github/workflows/publish-alpha.yml

@@ -0,0 +1,189 @@
+# Alpha builds published to Cloudflare R2 with date versioning (e.g. 1.0.0-alpha-20260205).
+# Required repo secrets: R2_ACCESS_KEY_ID, R2_SECRET_ACCESS_KEY (from R2 API token in Cloudflare dashboard).
+name: Publish Alpha
+
+on:
+    workflow_dispatch:
+        inputs:
+            version:
+                description: 'Semantic version number (e.g., 1.0.0) - alpha suffix will be added automatically'
+                required: false
+                type: string
+    schedule:
+        # Run at 3:00 AM PST daily (11:00 UTC; PST = UTC-8)
+        - cron: '0 11 * * *'
+
+jobs:
+    check-new-commits:
+        runs-on: ubuntu-latest
+        outputs:
+            has_new_commits: ${{ steps.manual.outputs.has_new_commits || steps.check.outputs['has-new-commits'] }}
+        steps:
+            - name: Set has new commits (manual trigger)
+              id: manual
+              if: github.event_name == 'workflow_dispatch'
+              run: echo "has_new_commits=true" >> "$GITHUB_OUTPUT"
+
+            - name: Check for new commits (24 hr interval)
+              id: check
+              if: github.event_name != 'workflow_dispatch'
+              uses: adriangl/check-new-commits-action@v1
+              with:
+                  token: ${{ secrets.GITHUB_TOKEN }}
+                  seconds: 86400
+
+    prepare:
+        needs: check-new-commits
+        if: needs.check-new-commits.outputs.has_new_commits == 'true'
+        runs-on: ubuntu-latest
+        outputs:
+            version: ${{ steps.version.outputs.version }}
+        steps:
+            - name: Checkout git repo
+              uses: actions/checkout@v6
+
+            - name: Install Node and PNPM
+              uses: pnpm/action-setup@v4
+              with:
+                  version: 10
+
+            - name: Install dependencies
+              run: pnpm install
+
+            - name: Set date-based alpha version
+              id: version
+              shell: pwsh
+              run: |
+                  $inputVersion = "${{ github.event.inputs.version }}"
+                  Write-Host "Input version: $inputVersion"
+
+                  if ($inputVersion -eq "" -or $inputVersion -eq "null") {
+                      # No input version provided (scheduled run or manual without input), auto-increment patch version
+                      Write-Host "No version provided, auto-incrementing patch version..."
+
+                      $currentVersion = (Get-Content package.json | ConvertFrom-Json).version
+                      Write-Host "Current version: $currentVersion"
+
+                      $cleanVersion = $currentVersion -replace '-.*$', ''
+                      $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]
+                      $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
+                      }
+                  }
+
+                  # Date in YYYYMMDD (PST / America/Los_Angeles)
+                  $pst = [TimeZoneInfo]::FindSystemTimeZoneById('America/Los_Angeles')
+                  $dateInPst = [TimeZoneInfo]::ConvertTimeFromUtc([DateTime]::UtcNow, $pst)
+                  $dateStr = $dateInPst.ToString("yyyyMMdd")
+                  $alphaVersion = "$inputVersion-alpha-$dateStr"
+                  Write-Host "Alpha version: $alphaVersion"
+
+                  # Update package.json
+                  $packageJson = Get-Content package.json | ConvertFrom-Json
+                  $packageJson.version = $alphaVersion
+                  $packageJson | ConvertTo-Json -Depth 10 | Set-Content package.json
+
+                  echo "version=$alphaVersion" >> $env:GITHUB_OUTPUT
+
+    cleanup:
+        needs: prepare
+        runs-on: ubuntu-latest
+        env:
+            AWS_ACCESS_KEY_ID: ${{ secrets.R2_ACCESS_KEY_ID }}
+            AWS_SECRET_ACCESS_KEY: ${{ secrets.R2_SECRET_ACCESS_KEY }}
+            R2_ENDPOINT_URL: ${{ secrets.R2_ENDPOINT_URL }}
+        steps:
+            - name: Delete all objects in R2 bucket
+              run: |
+                  aws s3 rm s3://feishin-nightly --recursive --endpoint-url $R2_ENDPOINT_URL
+
+    publish:
+        needs: [prepare, cleanup]
+        runs-on: ${{ matrix.os }}
+        env:
+            AWS_ACCESS_KEY_ID: ${{ secrets.R2_ACCESS_KEY_ID }}
+            AWS_SECRET_ACCESS_KEY: ${{ secrets.R2_SECRET_ACCESS_KEY }}
+
+        strategy:
+            matrix:
+                os: [windows-latest, macos-26, ubuntu-latest]
+
+        steps:
+            - name: Checkout git repo
+              uses: actions/checkout@v6
+
+            - name: Install Node and PNPM
+              uses: pnpm/action-setup@v4
+              with:
+                  version: 10
+
+            - name: Install dependencies
+              run: pnpm install
+
+            - name: Set version from prepare job
+              shell: pwsh
+              run: |
+                  $version = "${{ needs.prepare.outputs.version }}"
+                  Write-Host "Setting version: $version"
+                  $packageJson = Get-Content package.json | ConvertFrom-Json
+                  $packageJson.version = $version
+                  $packageJson | ConvertTo-Json -Depth 10 | Set-Content package.json
+
+            - name: Build and Publish to R2 (Windows)
+              if: matrix.os == 'windows-latest'
+              uses: nick-invision/retry@v3.0.2
+              with:
+                  timeout_minutes: 30
+                  max_attempts: 3
+                  retry_on: error
+                  command: |
+                      pnpm run publish:win:alpha
+                  on_retry_command: pnpm cache delete
+
+            - name: Build and Publish to R2 (macOS)
+              if: matrix.os == 'macos-26'
+              uses: nick-invision/retry@v3.0.2
+              with:
+                  timeout_minutes: 30
+                  max_attempts: 3
+                  retry_on: error
+                  command: |
+                      pnpm run publish:mac:alpha
+                  on_retry_command: pnpm cache delete
+
+            - name: Build and Publish to R2 (Linux)
+              if: matrix.os == 'ubuntu-latest'
+              uses: nick-invision/retry@v3.0.2
+              with:
+                  timeout_minutes: 30
+                  max_attempts: 3
+                  retry_on: error
+                  command: |
+                      pnpm run publish:linux:alpha
+                  on_retry_command: pnpm cache delete
+
+            - name: Build and Publish to R2 (Linux ARM64)
+              if: matrix.os == 'ubuntu-latest'
+              uses: nick-invision/retry@v3.0.2
+              with:
+                  timeout_minutes: 30
+                  max_attempts: 3
+                  retry_on: error
+                  command: |
+                      pnpm run publish:linux-arm64:alpha
+                  on_retry_command: pnpm cache delete

.github/workflows/publish-beta.yml

@@ -15,19 +15,21 @@ jobs:
             version: ${{ steps.version.outputs.version }}
         steps:
             - name: Checkout git repo
-              uses: actions/checkout@v1
+              uses: actions/checkout@v6
 
             - name: Install Node and PNPM
-              uses: pnpm/action-setup@v4.1.0
+              uses: pnpm/action-setup@v4
               with:
-                  version: 9
+                  version: 10
 
             - name: Install dependencies
               run: pnpm install
 
-            - name: Validate and set version with beta suffix
+            - 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"
@@ -67,8 +69,34 @@ jobs:
                       }
                   }
 
-                  # Add beta suffix
-                  $versionWithBeta = "$inputVersion-beta"
+                  # 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
@@ -81,48 +109,22 @@ jobs:
                   # Set output for other jobs
                   echo "version=$versionWithBeta" >> $env:GITHUB_OUTPUT
 
-            - name: Delete existing releases and tags
-              shell: pwsh
-              env:
-                  GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-              run: |
-                  # Get the version that was set in the previous step
-                  $versionWithBeta = "${{ steps.version.outputs.version }}"
-                  Write-Host "Checking for existing releases with tag: $versionWithBeta"
-
-                  # Find and delete any releases with isPrerelease "true"
-                  Write-Host "Deleting existing 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) {
-                          Write-Host "  - Tag: $($release.tagName), Title: $($release.name)"
-                          gh release delete $release.tagName --yes --cleanup-tag
-                          Write-Host "  Deleted release with tag: $($release.tagName)"
-                      }
-                  } else {
-                      Write-Host "No releases found with isPrerelease 'true'"
-                  }
-
     publish:
         needs: prepare
         runs-on: ${{ matrix.os }}
 
         strategy:
             matrix:
-                os: [windows-latest, macos-latest, ubuntu-latest]
+                os: [windows-latest, macos-26, ubuntu-latest]
 
         steps:
             - name: Checkout git repo
-              uses: actions/checkout@v1
+              uses: actions/checkout@v6
 
             - name: Install Node and PNPM
-              uses: pnpm/action-setup@v4.1.0
+              uses: pnpm/action-setup@v4
               with:
-                  version: 9
+                  version: 10
 
             - name: Install dependencies
               run: pnpm install
@@ -144,7 +146,7 @@ jobs:
               if: matrix.os == 'windows-latest'
               env:
                   GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-              uses: nick-invision/retry@v2.8.2
+              uses: nick-invision/retry@v3.0.2
               with:
                   timeout_minutes: 30
                   max_attempts: 3
@@ -154,10 +156,10 @@ jobs:
                   on_retry_command: pnpm cache delete
 
             - name: Build and Publish releases (macOS)
-              if: matrix.os == 'macos-latest'
+              if: matrix.os == 'macos-26'
               env:
                   GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-              uses: nick-invision/retry@v2.8.2
+              uses: nick-invision/retry@v3.0.2
               with:
                   timeout_minutes: 30
                   max_attempts: 3
@@ -170,7 +172,7 @@ jobs:
               if: matrix.os == 'ubuntu-latest'
               env:
                   GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-              uses: nick-invision/retry@v2.8.2
+              uses: nick-invision/retry@v3.0.2
               with:
                   timeout_minutes: 30
                   max_attempts: 3
@@ -183,7 +185,7 @@ jobs:
               if: matrix.os == 'ubuntu-latest'
               env:
                   GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-              uses: nick-invision/retry@v2.8.2
+              uses: nick-invision/retry@v3.0.2
               with:
                   timeout_minutes: 30
                   max_attempts: 3
@@ -197,7 +199,7 @@ jobs:
         runs-on: ubuntu-latest
         steps:
             - name: Checkout git repo
-              uses: actions/checkout@v1
+              uses: actions/checkout@v6
 
             - name: Edit release with commits and title
               shell: pwsh
@@ -316,6 +318,10 @@ jobs:
                             $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"
@@ -328,5 +334,48 @@ jobs:
               env:
                   GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
               run: |
-                  gh release edit $tagVersion --prerelease
+                  # 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@v6
+
+            - 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

@@ -20,7 +20,7 @@ jobs:
             packages: write
         steps:
             - name: Checkout repository
-              uses: actions/checkout@v4
+              uses: actions/checkout@v6
             - name: Log in to the Container registry
               uses: docker/login-action@65b78e6e13532edd9afa3aa52ac7964289d1a9c1
               with:
@@ -51,5 +51,4 @@ jobs:
                   labels: ${{ steps.meta.outputs.labels }}
                   platforms: |
                       linux/amd64
-                      linux/arm/v7
                       linux/arm64/v8

.github/workflows/publish-docker.yml

@@ -15,7 +15,7 @@ jobs:
             packages: write
         steps:
             - name: Checkout repository
-              uses: actions/checkout@v4
+              uses: actions/checkout@v6
             - name: Log in to the Container registry
               uses: docker/login-action@65b78e6e13532edd9afa3aa52ac7964289d1a9c1
               with:

.github/workflows/publish-linux.yml

@@ -12,12 +12,12 @@ jobs:
 
         steps:
             - name: Checkout git repo
-              uses: actions/checkout@v1
+              uses: actions/checkout@v6
 
             - name: Install Node and PNPM
-              uses: pnpm/action-setup@v4.1.0
+              uses: pnpm/action-setup@v4
               with:
-                  version: 9
+                  version: 10
 
             - name: Install dependencies
               run: pnpm install
@@ -25,7 +25,7 @@ jobs:
             - name: Build and Publish releases
               env:
                   GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-              uses: nick-invision/retry@v2.8.2
+              uses: nick-invision/retry@v3.0.2
               with:
                   timeout_minutes: 30
                   max_attempts: 3
@@ -37,7 +37,7 @@ jobs:
             - name: Build and Publish releases (arm64)
               env:
                   GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-              uses: nick-invision/retry@v2.8.2
+              uses: nick-invision/retry@v3.0.2
               with:
                   timeout_minutes: 30
                   max_attempts: 3

.github/workflows/publish-macos.yml

@@ -8,24 +8,25 @@ jobs:
 
         strategy:
             matrix:
-                os: [macos-latest]
+                os: [macos-26]
 
         steps:
             - name: Checkout git repo
-              uses: actions/checkout@v1
+              uses: actions/checkout@v6
 
             - name: Install Node and PNPM
-              uses: pnpm/action-setup@v4.1.0
+              uses: pnpm/action-setup@v4
               with:
-                  version: 9
+                  version: 10
 
             - name: Install dependencies
               run: pnpm install
 
             - name: Build and Publish releases
               env:
+                  NODE_OPTIONS: --max-old-space-size=4096
                   GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-              uses: nick-invision/retry@v2.8.2
+              uses: nick-invision/retry@v3.0.2
               with:
                   timeout_minutes: 30
                   max_attempts: 3

.github/workflows/publish-pr.yml

@@ -1,33 +1,52 @@
 name: Publish (PR)
 
 on:
+    workflow_dispatch:
     pull_request:
         branches:
             - development
+        paths:
+            - 'src/**'
+            - 'electron-builder*.yml'
 
 jobs:
+    wait-for-lint:
+        if: github.event_name == 'pull_request'
+        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
+
     publish:
+        needs: wait-for-lint
+        if: always() && (needs.wait-for-lint.result == 'success' || needs.wait-for-lint.result == 'skipped')
         runs-on: ${{ matrix.os }}
 
         strategy:
             matrix:
-                os: [macos-latest, ubuntu-latest, windows-latest]
+                os: [macos-26, ubuntu-latest, windows-latest]
 
         steps:
             - name: Checkout git repo
-              uses: actions/checkout@v3
+              uses: actions/checkout@v6
 
             - name: Install Node and PNPM
-              uses: pnpm/action-setup@v4.1.0
+              uses: pnpm/action-setup@v4
               with:
-                  version: 9
+                  version: 10
 
             - name: Install dependencies
               run: pnpm install
 
             - name: Build for Windows
               if: ${{ matrix.os == 'windows-latest' }}
-              uses: nick-invision/retry@v2.8.2
+              uses: nick-invision/retry@v3.0.2
               with:
                   timeout_minutes: 30
                   max_attempts: 3
@@ -37,7 +56,7 @@ jobs:
 
             - name: Build for Linux
               if: ${{ matrix.os == 'ubuntu-latest' }}
-              uses: nick-invision/retry@v2.8.2
+              uses: nick-invision/retry@v3.0.2
               with:
                   timeout_minutes: 30
                   max_attempts: 3
@@ -46,8 +65,8 @@ jobs:
                       pnpm run package:linux:pr
 
             - name: Build for MacOS
-              if: ${{ matrix.os == 'macos-latest' }}
-              uses: nick-invision/retry@v2.8.2
+              if: ${{ matrix.os == 'macos-26' }}
+              uses: nick-invision/retry@v3.0.2
               with:
                   timeout_minutes: 30
                   max_attempts: 3
@@ -67,27 +86,27 @@ jobs:
                   zip -r dist/linux-binaries.zip dist/*.{AppImage,deb,rpm}
 
             - name: Zip MacOS Binaries
-              if: ${{ matrix.os == 'macos-latest' }}
+              if: ${{ matrix.os == 'macos-26' }}
               run: |
                   zip -r dist/macos-binaries.zip dist/*.dmg
 
             - name: Upload Windows Binaries
               if: ${{ matrix.os == 'windows-latest' }}
-              uses: actions/upload-artifact@v4
+              uses: actions/upload-artifact@v7
               with:
                   name: windows-binaries
                   path: dist/windows-binaries.zip
 
             - name: Upload Linux Binaries
               if: ${{ matrix.os == 'ubuntu-latest' }}
-              uses: actions/upload-artifact@v4
+              uses: actions/upload-artifact@v7
               with:
                   name: linux-binaries
                   path: dist/linux-binaries.zip
 
             - name: Upload MacOS Binaries
-              if: ${{ matrix.os == 'macos-latest' }}
-              uses: actions/upload-artifact@v4
+              if: ${{ matrix.os == 'macos-26' }}
+              uses: actions/upload-artifact@v7
               with:
                   name: macos-binaries
                   path: dist/macos-binaries.zip

.github/workflows/publish-windows.yml

@@ -12,12 +12,12 @@ jobs:
 
         steps:
             - name: Checkout git repo
-              uses: actions/checkout@v1
+              uses: actions/checkout@v6
 
             - name: Install Node and PNPM
-              uses: pnpm/action-setup@v4.1.0
+              uses: pnpm/action-setup@v4
               with:
-                  version: 9
+                  version: 10
 
             - name: Install dependencies
               run: pnpm install
@@ -25,7 +25,7 @@ jobs:
             - name: Build and Publish releases
               env:
                   GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-              uses: nick-invision/retry@v2.8.2
+              uses: nick-invision/retry@v3.0.2
               with:
                   timeout_minutes: 30
                   max_attempts: 3

.github/workflows/publish-winget.yml

@@ -0,0 +1,20 @@
+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|arm64)\.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-26, ubuntu-latest]
+
+        steps:
+            - name: Checkout git repo
+              uses: actions/checkout@v6
+
+            - name: Install Node and PNPM
+              uses: pnpm/action-setup@v4
+              with:
+                  version: 10
+
+            - 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@v3.0.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-26'
+              env:
+                  GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+              uses: nick-invision/retry@v3.0.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@v3.0.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@v3.0.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/test.yml

@@ -4,20 +4,16 @@ on: [push, pull_request]
 
 jobs:
     lint:
-        runs-on: ${{ matrix.os }}
-
-        strategy:
-            matrix:
-                os: [macos-latest, windows-latest, ubuntu-latest]
+        runs-on: ubuntu-latest
 
         steps:
             - name: Check out Git repository
-              uses: actions/checkout@v1
+              uses: actions/checkout@v6
 
             - name: Install Node.js and PNPM
-              uses: pnpm/action-setup@v4.1.0
+              uses: pnpm/action-setup@v4
               with:
-                  version: 9
+                  version: 10
 
             - name: Install dependencies
               run: pnpm install

.npmrc

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

.vscode/settings.json

@@ -14,9 +14,7 @@
         ".eslintignore": "ignore"
     },
     "eslint.validate": ["typescript", "typescriptreact"],
-    "eslint.workingDirectories": [
-        { "directory": "./", "changeProcessCWD": true },
-    ],
+    "eslint.workingDirectories": [{ "directory": "./", "changeProcessCWD": true }],
     "typescript.tsserver.experimental.enableProjectDiagnostics": false,
     "editor.codeActionsOnSave": {
         "source.fixAll.eslint": "explicit",
@@ -42,7 +40,7 @@
         "dist/**/*": true
     },
     "i18n-ally.localesPaths": ["src/i18n", "src/i18n/locales"],
-    "typescript.tsdk": "node_modules\\typescript\\lib",
+    "typescript.tsdk": "node_modules/typescript/lib",
     "typescript.preferences.importModuleSpecifier": "non-relative",
     "stylelint.config": null,
     "stylelint.validate": ["css", "postcss"],
@@ -50,7 +48,10 @@
     "typescript.preferences.autoImportFileExcludePatterns": [
         "@mantine/core",
         "@mantine/modals",
-        "@mantine/dates"
+        "@mantine/dates",
+        "@mantine/hooks",
+        "@mantine/form",
+        "@radix-ui/react-context-menu"
     ],
     "[typescriptreact]": { "editor.defaultFormatter": "esbenp.prettier-vscode" },
     "typescript.format.insertSpaceAfterOpeningAndBeforeClosingTemplateStringBraces": true,

Dockerfile

@@ -1,5 +1,5 @@
 # --- Builder stage
-FROM node:23-alpine as builder
+FROM node:23-alpine AS builder
 WORKDIR /app
 
 # Copy package.json first to cache node_modules
@@ -14,12 +14,14 @@ COPY . .
 RUN pnpm run build:web
 
 # --- Production stage
-FROM nginx:alpine-slim
+FROM nginxinc/nginx-unprivileged: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
+COPY --chown=nginx:nginx ./settings.js.template /etc/nginx/templates/settings.js.template
+COPY --chown=nginx:nginx ng.conf.template /etc/nginx/templates/default.conf.template
+
+ENV SERVER_LOCK=false SERVER_NAME="" SERVER_TYPE="" SERVER_URL="" REMOTE_URL=""
+ENV LEGACY_AUTHENTICATION="" ANALYTICS_DISABLED="" PUBLIC_PATH="/"
 
-ENV PUBLIC_PATH="/"
 EXPOSE 9180
 CMD ["nginx", "-g", "daemon off;"]

README.md

@@ -43,7 +43,7 @@ Rewrite of [Sonixd](https://github.com/jeffvli/sonixd).
 
 ## Screenshots
 
-<a href="https://raw.githubusercontent.com/jeffvli/feishin/development/media/preview_full_screen_player.png"><img src="https://raw.githubusercontent.com/jeffvli/feishin/development/media/preview_full_screen_player.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
 
@@ -59,15 +59,34 @@ For media keys to work, you will be prompted to allow Feishin to be a Trusted Ac
 
 #### Linux Notes
 
-If you're using a Linux device, a `.desktop` file is recommended for easy launching of Feishin.
+Feishin is available in [Flathub](https://flathub.org/en/apps/org.jeffvli.feishin).
 
-Download the [latest release (AppImage)](https://github.com/jeffvli/feishin/releases) and [application icon](https://github.com/jeffvli/feishin/blob/development/resources/icon.png?raw=true) to your `~/applications/` folder. This folder may need to be created if it does not already exist.
+Alternatively, you can install it as an Appimage.
+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.
 
-Rename the icon to `Feishin-linux-x86_64.png`.
+Simply run the installer like this:
 
-Save the [example desktop file](https://raw.githubusercontent.com/jeffvli/feishin/refs/heads/development/feishin.desktop) as `~/.local/share/applications/feishin.desktop`.
+```sh
+dir=/your/application/directory
+curl 'https://raw.githubusercontent.com/jeffvli/feishin/refs/heads/development/install-feishin-appimage' | sh -s -- "$dir"
+```
 
-You will now see Feishin show up in your menu. The properties in the example desktop file may need to be modified to match your system.
+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
 
@@ -86,25 +105,25 @@ docker run --name feishin -p 9180:9180 feishin
 
 #### Docker Compose
 
-To install via Docker Compose use the following snippit. This also works on Portainer.
+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_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 # navidrome also works
-            - SERVER_URL= # http://address:port
-            - PUID=1000
-            - PGID=1000
-            - UMASK=002
-            - TZ=America/Los_Angeles
+            - SERVER_TYPE=jellyfin # the allowed types are: jellyfin, navidrome, subsonic. These values are case insensitive
+            - SERVER_URL= # http://address:port or https://address:port
+            - REMOTE_URL= # http://address or https://address
+            - 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
-        restart: unless-stopped
+            # Alternatively, to restrict to only localhost, - 127.0.0.1:9180:8190
 ```
 
 ### Configuration
@@ -114,11 +133,17 @@ services:
 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 score.
+    - **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`), `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.
+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_ - If your server uses a separate public-facing URL than what integrating applications use internally to communicate with your server, such as a separate Navidrome `ShareURL`, set `REMOTE_URL` to said public-facing URL.
+
+6. _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.
+
+7. _Optional_ - App settings (theme, language, sidebar options, etc.) can be overridden with environment variables on first run. The variables use the `FS_` prefix (e.g. `FS_GENERAL_THEME=defaultDark`, `FS_GENERAL_LANGUAGE=de`). See [the settings environment variable documentation](docs/ENV_SETTINGS.md) for the full list.
 
 ## FAQ
 
@@ -144,6 +169,10 @@ Feishin supports any music server that implements a [Navidrome](https://www.navi
     - [Qm-Music](https://github.com/chenqimiao/qm-music)
     - More (?)
 
+- [Plex](https://www.plex.tv/media-server-downloads)
+    - [Feishin fork by lux032](https://github.com/lux032/feishin) - Plex is not natively supported. Use the fork by lux032 to use Plex with Feishin.
+
+
 ### 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.
@@ -153,7 +182,7 @@ chmod 4755 chrome-sandbox
 sudo chown root:root chrome-sandbox
 ```
 
-Ubunutu 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.
+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
 

docker-compose.yaml

@@ -1,13 +1,16 @@
-version: '3.5'
 services:
     feishin:
         container_name: feishin
-        image: ghcr.io/jeffvli/feishin:latest
+        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
+            # - REMOTE_URL=http://share.localhost # Used for compatibility with external functionality, such as custom sharing URLs on Navidrome
+            - 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
-        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 # navidrome also works
-            - SERVER_URL= # http://address:port
+            # Alternatively, to restrict to only localhost, - 127.0.0.1:9180:8190

docs/ENV_SETTINGS.md

@@ -0,0 +1,129 @@
+# Environment variables for settings (web / Docker)
+
+These variables override app settings **on first run** when no persisted settings exist. They are injected via `settings.js` (from `settings.js.template`) and only apply to the **web** build.
+
+**Format:** All values are strings; booleans use `true`/`false`, numbers are numeric strings. Leave unset or empty to use the default.
+
+---
+
+## General
+
+| Setting | Default | Env variable | Available values / Description |
+|-------------|---------|--------------|--------------------------------|
+| `general.accent` | `rgb(53, 116, 252)` | `FS_GENERAL_ACCENT` | CSS `rgb(r, g, b)` string (e.g. `rgb(53, 116, 252)`). Invalid values are ignored. |
+| `general.albumBackground` | `false` | `FS_GENERAL_ALBUM_BACKGROUND` | `true` / `false` — Show album background image. |
+| `general.albumBackgroundBlur` | `3` | `FS_GENERAL_ALBUM_BACKGROUND_BLUR` | Blur amount for album background (number). |
+| `general.artistBackground` | `true` | `FS_GENERAL_ARTIST_BACKGROUND` | `true` / `false` — Show artist background image. |
+| `general.artistBackgroundBlur` | `3` | `FS_GENERAL_ARTIST_BACKGROUND_BLUR` | Blur amount for artist background (number). |
+| `general.blurExplicitImages` | `false` | `FS_GENERAL_BLUR_EXPLICIT_IMAGES` | `true` / `false` — Blur explicit images. |
+| `general.combinedLyricsAndVisualizer` | `false` | `FS_GENERAL_COMBINED_LYRICS_AND_VISUALIZER` | `true` / `false` — Combine lyrics and visualizer panel. |
+| `general.enableGridMultiSelect` | `false` | `FS_GENERAL_ENABLE_GRID_MULTI_SELECT` | `true` / `false` — Enable multi-select in grid views. |
+| `general.externalLinks` | `true` | `FS_GENERAL_EXTERNAL_LINKS` | `true` / `false` — Show external links in UI. |
+| `general.followCurrentSong` | `true` | `FS_GENERAL_FOLLOW_CURRENT_SONG` | `true` / `false` — Follow current song in list. |
+| `general.followSystemTheme` | `false` | `FS_GENERAL_FOLLOW_SYSTEM_THEME` | `true` / `false` — Use OS light/dark preference. |
+| `general.homeFeature` | `true` | `FS_GENERAL_HOME_FEATURE` | `true` / `false` — Show home featured carousel. |
+| `general.homeFeatureStyle` | `single` | `FS_GENERAL_HOME_FEATURE_STYLE` | `multiple` / `single` — Home featured carousel style. |
+| `general.language` | `en` | `FS_GENERAL_LANGUAGE` | UI language code (e.g. `en`, `de`, `fr`). |
+| `general.theme` | `defaultDark` | `FS_GENERAL_THEME` | One of: `ayuDark`, `ayuLight`, `catppuccinLatte`, `catppuccinMocha`, `defaultDark`, `defaultLight`, `dracula`, `githubDark`, `githubLight`, `glassyDark`, `gruvboxDark`, `gruvboxLight`, `highContrastDark`, `highContrastLight`, `materialDark`, `materialLight`, `monokai`, `nightOwl`, `nord`, `oneDark`, `rosePine`, `rosePineDawn`, `rosePineMoon`, `shadesOfPurple`, `solarizedDark`, `solarizedLight`, `tokyoNight`, `vscodeDarkPlus`, `vscodeLightPlus`. |
+| `general.themeDark` | `defaultDark` | `FS_GENERAL_THEME_DARK` | Same as theme (used when system is dark). |
+| `general.themeLight` | `defaultLight` | `FS_GENERAL_THEME_LIGHT` | Same as theme (used when system is light). |
+| `general.lastfmApiKey` | *(empty)* | `FS_GENERAL_LASTFM_API_KEY` | Last.fm API key. |
+| `general.lastFM` | `true` | `FS_GENERAL_LAST_FM` | `true` / `false` — Enable Last.fm. |
+| `general.listenBrainz` | `true` | `FS_GENERAL_LISTEN_BRAINZ` | `true` / `false` — ListenBrainz links. |
+| `general.musicBrainz` | `true` | `FS_GENERAL_MUSIC_BRAINZ` | `true` / `false` — MusicBrainz links. |
+| `general.nativeAspectRatio` | `false` | `FS_GENERAL_NATIVE_ASPECT_RATIO` | `true` / `false` — Use native cover art aspect ratio. |
+| `general.pathReplace` | *(empty)* | `FS_GENERAL_PATH_REPLACE` | Path pattern to replace (e.g. server path in Docker). |
+| `general.pathReplaceWith` | *(empty)* | `FS_GENERAL_PATH_REPLACE_WITH` | Replacement path. |
+| `general.playerbarOpenDrawer` | `false` | `FS_GENERAL_PLAYERBAR_OPEN_DRAWER` | `true` / `false` — Open queue/lyrics as drawer from player bar. |
+| `general.primaryShade` | `6` | `FS_GENERAL_PRIMARY_SHADE` | Mantine primary shade 0–9 (number). |
+| `general.qobuz` | `true` | `FS_GENERAL_QOBUZ` | `true` / `false` — Qobuz links. |
+| `general.resume` | `true` | `FS_GENERAL_RESUME` | `true` / `false` — Resume playback on load. |
+| `general.showLyricsInSidebar` | `true` | `FS_GENERAL_SHOW_LYRICS_IN_SIDEBAR` | `true` / `false` — Show lyrics in sidebar. |
+| `general.showRatings` | `true` | `FS_GENERAL_SHOW_RATINGS` | `true` / `false` — Show star ratings. |
+| `general.showVisualizerInSidebar` | `true` | `FS_GENERAL_SHOW_VISUALIZER_IN_SIDEBAR` | `true` / `false` — Show visualizer in sidebar. |
+| `general.sidebarCollapsedNavigation` | `true` | `FS_GENERAL_SIDEBAR_COLLAPSED_NAVIGATION` | `true` / `false` — Start with collapsed sidebar nav. |
+| `general.sidebarCollapseShared` | `false` | `FS_GENERAL_SIDEBAR_COLLAPSE_SHARED` | `true` / `false` — Share sidebar collapse state. |
+| `general.sidebarPlaylistList` | `true` | `FS_GENERAL_SIDEBAR_PLAYLIST_LIST` | `true` / `false` — Show playlist list in sidebar. |
+| `general.sidebarPlaylistSorting` | `false` | `FS_GENERAL_SIDEBAR_PLAYLIST_SORTING` | `true` / `false` — Enable playlist sorting in sidebar. |
+| `general.sideQueueType` | `sideQueue` | `FS_GENERAL_SIDE_QUEUE_TYPE` | `sideDrawerQueue` / `sideQueue` — Side play queue style. |
+| `general.sideQueueLayout` | `horizontal` | `FS_GENERAL_SIDE_QUEUE_LAYOUT` | `horizontal` / `vertical` — Attached side queue layout orientation. |
+| `general.useThemeAccentColor` | `false` | `FS_GENERAL_USE_THEME_ACCENT_COLOR` | `true` / `false` — Use theme’s accent color instead of custom. |
+| `general.useThemePrimaryShade` | `true` | `FS_GENERAL_USE_THEME_PRIMARY_SHADE` | `true` / `false` — Use theme’s primary shade. |
+| `general.zoomFactor` | `100` | `FS_GENERAL_ZOOM_FACTOR` | UI zoom percentage (number). |
+
+---
+
+## Playback
+
+| Setting path | Default | Env variable | Available values / Description |
+|-------------|---------|--------------|--------------------------------|
+| `playback.mediaSession` | `false` | `FS_PLAYBACK_MEDIA_SESSION` | `true` / `false` — Media Session API (e.g. browser/media keys). |
+| `playback.webAudio` | `true` | `FS_PLAYBACK_WEB_AUDIO` | `true` / `false` — Use Web Audio for playback. |
+| `playback.audioFadeOnStatusChange` | `true` | `FS_PLAYBACK_AUDIO_FADE_ON_STATUS_CHANGE` | `true` / `false` — Fade on play/pause. |
+| `playback.preservePitch` | `true` | `FS_PLAYBACK_PRESERVE_PITCH` | `true` / `false` — Preserve pitch when changing speed. |
+| `playback.scrobble.enabled` | `true` | `FS_PLAYBACK_SCROBBLE_ENABLED` | `true` / `false` — Enable scrobbling. |
+| `playback.scrobble.notify` | `false` | `FS_PLAYBACK_SCROBBLE_NOTIFY` | `true` / `false` — Scrobble notifications. |
+| `playback.scrobble.scrobbleAtDuration` | `240` | `FS_PLAYBACK_SCROBBLE_AT_DURATION` | Seconds of playback before scrobble. |
+| `playback.scrobble.scrobbleAtPercentage` | `75` | `FS_PLAYBACK_SCROBBLE_AT_PERCENTAGE` | Percentage of track before scrobble. |
+| `playback.transcode.enabled` | `false` | `FS_PLAYBACK_TRANSCODE_ENABLED` | `true` / `false` — Enable transcoding. |
+
+---
+
+## Discord
+
+| Setting path | Default | Env variable | Available values / Description |
+|-------------|---------|--------------|--------------------------------|
+| `discord.enabled` | `false` | `FS_DISCORD_ENABLED` | `true` / `false` — Discord rich presence. |
+| `discord.clientId` | *(built-in)* | `FS_DISCORD_CLIENT_ID` | Custom Discord application ID. |
+| `discord.displayType` | `feishin` | `FS_DISCORD_DISPLAY_TYPE` | `artist` / `feishin` / `song`. |
+| `discord.linkType` | `none` | `FS_DISCORD_LINK_TYPE` | `last_fm` / `musicbrainz` / `musicbrainz_last_fm` / `none`. |
+| `discord.showAsListening` | `false` | `FS_DISCORD_SHOW_AS_LISTENING` | `true` / `false`. |
+| `discord.showPaused` | `true` | `FS_DISCORD_SHOW_PAUSED` | `true` / `false` — Show paused state. |
+| `discord.showServerImage` | `false` | `FS_DISCORD_SHOW_SERVER_IMAGE` | `true` / `false`. |
+| `discord.showStateIcon` | `true` | `FS_DISCORD_SHOW_STATE_ICON` | `true` / `false`. |
+
+---
+
+## Lyrics
+
+| Setting path | Default | Env variable | Available values / Description |
+|-------------|---------|--------------|--------------------------------|
+| `lyrics.fetch` | `true` | `FS_LYRICS_FETCH` | `true` / `false` — Fetch lyrics. |
+| `lyrics.follow` | `true` | `FS_LYRICS_FOLLOW` | `true` / `false` — Follow current line. |
+| `lyrics.delayMs` | `0` | `FS_LYRICS_DELAY_MS` | Sync delay in milliseconds. |
+| `lyrics.preferLocalLyrics` | `true` | `FS_LYRICS_PREFER_LOCAL` | `true` / `false` — Prefer local lyric files. |
+| `lyrics.showMatch` | `true` | `FS_LYRICS_SHOW_MATCH` | `true` / `false`. |
+| `lyrics.showProvider` | `true` | `FS_LYRICS_SHOW_PROVIDER` | `true` / `false`. |
+| `lyrics.enableAutoTranslation` | `false` | `FS_LYRICS_ENABLE_AUTO_TRANSLATION` | `true` / `false`. |
+| `lyrics.translationApiKey` | *(empty)* | `FS_LYRICS_TRANSLATION_API_KEY` | API key for lyric translation. |
+| `lyrics.translationTargetLanguage` | `en` | `FS_LYRICS_TRANSLATION_TARGET_LANGUAGE` | Target language code. |
+| `lyrics.alignment` | `center` | `FS_LYRICS_ALIGNMENT` | `center` / `left` / `right`. |
+
+---
+
+## Auto DJ
+
+| Setting path | Default | Env variable | Available values / Description |
+|-------------|---------|--------------|--------------------------------|
+| `autoDJ.enabled` | `false` | `FS_AUTO_DJ_ENABLED` | `true` / `false`. |
+| `autoDJ.itemCount` | `5` | `FS_AUTO_DJ_ITEM_COUNT` | Number of items to add. |
+| `autoDJ.timing` | `1` | `FS_AUTO_DJ_TIMING` | Timing value (number). |
+
+---
+
+## CSS
+
+| Setting path | Default | Env variable | Available values / Description |
+|-------------|---------|--------------|--------------------------------|
+| `css.content` | *(empty)* | `FS_CSS_CONTENT` | Custom CSS string (sanitized like in-app custom CSS). Set `FS_CSS_ENABLED=true` to apply. |
+| `css.enabled` | `false` | `FS_CSS_ENABLED` | `true` / `false` — Enable custom CSS. |
+
+---
+
+## Font
+
+| Setting path | Default | Env variable | Available values / Description |
+|-------------|---------|--------------|--------------------------------|
+| `font.type` | `builtIn` | `FS_FONT_TYPE` | `builtIn` / `system` / `custom`. |
+| `font.builtIn` | `Inter` | `FS_FONT_BUILT_IN` | Built-in font name. |
+| `font.system` | *(empty)* | `FS_FONT_SYSTEM` | System font name (when type is `system`). |

electron-builder-alpha.yml

@@ -0,0 +1,74 @@
+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:
+        - target: zip
+          arch:
+              - x64
+              - arm64
+        - target: nsis
+          arch:
+              - x64
+              - arm64
+    icon: assets/icons/icon.ico
+
+nsis:
+    allowToChangeInstallationDirectory: true
+    oneClick: false
+    shortcutName: ${productName}
+    uninstallDisplayName: ${productName}
+    createDesktopShortcut: always
+
+mac:
+    target:
+        - target: dmg
+          arch:
+              - arm64
+              - x64
+        - target: zip
+          arch:
+              - arm64
+              - x64
+    icon: media/feishin.icon
+    type: distribution
+    hardenedRuntime: false
+    identity: '-'
+    gatekeeperAssess: false
+    notarize: false
+    extendInfo:
+        NSAudioCaptureUsageDescription: "System audio access is required for mpv visualizer capture in Feishin"
+        NSLocalNetworkUsageDescription: 'Local network is necessary for accessing servers hosted on the same system as Feishin'
+
+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}
+
+toolsets:
+    appimage: '1.0.2'
+
+npmRebuild: false
+
+publish:
+    provider: s3
+    bucket: feishin-nightly
+    channel: alpha
+    endpoint: https://065f090c64de2dc707dd70ac72db9669.r2.cloudflarestorage.com

electron-builder-beta.yml

@@ -1,7 +1,7 @@
 appId: org.jeffvli.feishin
 productName: Feishin
 artifactName: ${productName}-${version}-${os}-${arch}.${ext}
-electronVersion: 35.1.5
+electronVersion: 39.4.0
 directories:
     buildResources: assets
 files:
@@ -13,9 +13,15 @@ asarUnpack:
     - resources/**
 win:
     target:
-        - zip
-        - nsis
-    icon: assets/icons/icon.png
+        - target: zip
+          arch:
+              - x64
+              - arm64
+        - target: nsis
+          arch:
+              - x64
+              - arm64
+    icon: assets/icons/icon.ico
 
 nsis:
     allowToChangeInstallationDirectory: true
@@ -26,17 +32,23 @@ nsis:
 
 mac:
     target:
-        target: default
-        arch:
-            - arm64
-            - x64
-    icon: assets/icons/icon.icns
+        - target: dmg
+          arch:
+              - arm64
+              - x64
+        - target: zip
+          arch:
+              - arm64
+              - x64
+    icon: media/feishin.icon
     type: distribution
-    hardenedRuntime: true
-    entitlements: assets/entitlements.mac.plist
-    entitlementsInherit: assets/entitlements.mac.plist
+    hardenedRuntime: false
+    identity: '-'
     gatekeeperAssess: false
     notarize: false
+    extendInfo:
+        NSAudioCaptureUsageDescription: "System audio access is required for mpv visualizer capture in Feishin"
+        NSLocalNetworkUsageDescription: 'Local network is necessary for accessing servers hosted on the same system as Feishin'
 
 dmg:
     contents: [{ x: 130, y: 220 }, { x: 410, y: 220, type: link, path: /Applications }]
@@ -44,11 +56,15 @@ dmg:
 linux:
     target:
         - AppImage
+        - deb
         - tar.xz
     category: AudioVideo;Audio;Player
     icon: assets/icons/icon.png
     artifactName: ${productName}-${os}-${arch}.${ext}
 
+toolsets:
+    appimage: '1.0.2'
+
 npmRebuild: false
 publish:
     provider: github

electron-builder.yml

@@ -1,7 +1,7 @@
 appId: org.jeffvli.feishin
 productName: Feishin
 artifactName: ${productName}-${version}-${os}-${arch}.${ext}
-electronVersion: 35.1.5
+electronVersion: 39.4.0
 directories:
     buildResources: assets
 files:
@@ -13,9 +13,15 @@ asarUnpack:
     - resources/**
 win:
     target:
-        - zip
-        - nsis
-    icon: assets/icons/icon.png
+        - target: zip
+          arch:
+              - x64
+              - arm64
+        - target: nsis
+          arch:
+              - x64
+              - arm64
+    icon: assets/icons/icon.ico
 
 nsis:
     allowToChangeInstallationDirectory: true
@@ -26,17 +32,23 @@ nsis:
 
 mac:
     target:
-        target: default
-        arch:
-            - arm64
-            - x64
-    icon: assets/icons/icon.icns
+        - target: dmg
+          arch:
+              - arm64
+              - x64
+        - target: zip
+          arch:
+              - arm64
+              - x64
+    icon: media/feishin.icon
     type: distribution
-    hardenedRuntime: true
-    entitlements: assets/entitlements.mac.plist
-    entitlementsInherit: assets/entitlements.mac.plist
+    hardenedRuntime: false
+    identity: '-'
     gatekeeperAssess: false
     notarize: false
+    extendInfo:
+        NSAudioCaptureUsageDescription: 'System audio access is required for mpv visualizer capture in Feishin'
+        NSLocalNetworkUsageDescription: 'Local network is necessary for accessing servers hosted on the same system as Feishin'
 
 dmg:
     contents: [{ x: 130, y: 220 }, { x: 410, y: 220, type: link, path: /Applications }]
@@ -44,12 +56,17 @@ dmg:
 linux:
     target:
         - AppImage
+        - deb
         - tar.xz
     category: AudioVideo;Audio;Player
     icon: assets/icons/icon.png
     artifactName: ${productName}-${os}-${arch}.${ext}
 
+toolsets:
+    appimage: '1.0.2'
+
 npmRebuild: false
+afterAllArtifactBuild: scripts/after-all-artifact-build.mjs
 publish:
     provider: github
     owner: jeffvli

electron.vite.config.ts

@@ -1,11 +1,13 @@
-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';
 
+import { createReactPlugin } from './vite.react-plugin';
+
 const currentOSEnv = process.platform;
+const electronRendererTarget = 'chrome87';
 
 const config: UserConfig = {
     main: {
@@ -36,6 +38,9 @@ const config: UserConfig = {
         },
     },
     preload: {
+        build: {
+            sourcemap: true,
+        },
         plugins: [externalizeDepsPlugin()],
         resolve: {
             alias: {
@@ -45,13 +50,22 @@ const config: UserConfig = {
         },
     },
     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 })],
+        plugins: [createReactPlugin(), ViteEjsPlugin({ web: false })],
         resolve: {
             alias: {
                 '/@/i18n': resolve('src/i18n'),

eslint.config.mjs

@@ -25,7 +25,7 @@ export default tseslint.config(
             'react-refresh': eslintPluginReactRefresh,
         },
         rules: {
-            ...eslintPluginReactHooks.configs.recommended.rules,
+            ...eslintPluginReactHooks.configs['recommended-latest'].rules,
             ...eslintPluginReactRefresh.configs.vite.rules,
             '@typescript-eslint/explicit-function-return-type': 'off',
             '@typescript-eslint/no-duplicate-enum-values': 'off',
@@ -43,6 +43,8 @@ export default tseslint.config(
             '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'],

feishin.desktop

@@ -1,9 +0,0 @@
-[Desktop Entry]
-Name=Feishin
-Comment=An Electron-based music streaming app
-Exec=/home/username/.applications/Feishin-linux-x86_64.AppImage
-Icon=/home/username/.applications/Feishin-linux-x86_64.png
-Terminal=false
-Type=Application
-Categories=AudioVideo;Audio;Music;Player;
-StartupNotify=true

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"

media/feishin.icon/Assets/feishin.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="512" height="512"><g style="display:inline" transform="translate(-53.452 -43.352)scale(1.11813)"><circle cx="256" cy="240.312" r="21.5" style="opacity:1;fill:#000;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:2.19597;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;paint-order:markers fill stroke;filter:url(#filter249)"/><path d="M220.85 277.951 183.5 315.6l36 36.1 20-19.7s5.856-6.2 16.5-6.2 16.5 6.2 16.5 6.2l20 19.7 36-36.1-37.35-37.649A51.5 51.5 0 0 1 256 291.812a51.5 51.5 0 0 1-35.15-13.86" style="opacity:1;fill:#000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;filter:url(#filter249)"/><path d="M256 145.4a25.7 25.7 0 0 0-18.229 7.551L66.97 323.47A25.42 25.42 0 0 0 59.5 341.5c0 14.083 11.417 25.5 25.5 25.5a25.42 25.42 0 0 0 18.031-7.469l103.895-103.597a51.5 51.5 0 0 1-2.426-15.621 51.5 51.5 0 0 1 51.5-51.5 51.5 51.5 0 0 1 51.5 51.5 51.5 51.5 0 0 1-2.426 15.62L408.97 359.532A25.42 25.42 0 0 0 427 367c14.083 0 25.5-11.417 25.5-25.5a25.42 25.42 0 0 0-7.469-18.031L274.23 152.95a25.7 25.7 0 0 0-18.229-7.55" style="display:inline;opacity:1;fill:#000;fill-opacity:1;stroke-width:2.2;stroke-linecap:round;stroke-linejoin:round;paint-order:markers fill stroke;filter:url(#filter249)"/></g></svg>

media/feishin.icon/icon.json

@@ -0,0 +1,202 @@
+{
+  "fill-specializations" : [
+    {
+      "value" : {
+        "linear-gradient" : [
+          "display-p3:0.87416,0.87416,0.87416,1.00000",
+          "display-p3:0.99575,0.99575,0.99575,1.00000"
+        ],
+        "orientation" : {
+          "start" : {
+            "x" : 0.5,
+            "y" : 1
+          },
+          "stop" : {
+            "x" : 0.5,
+            "y" : 0.3
+          }
+        }
+      }
+    },
+    {
+      "appearance" : "dark",
+      "value" : "system-dark"
+    }
+  ],
+  "groups" : [
+    {
+      "blend-mode-specializations" : [
+        {
+          "appearance" : "tinted",
+          "value" : "normal"
+        }
+      ],
+      "blur-material-specializations" : [
+        {
+          "value" : 0.7
+        },
+        {
+          "appearance" : "dark",
+          "value" : 0.7
+        },
+        {
+          "appearance" : "tinted",
+          "value" : null
+        }
+      ],
+      "hidden" : false,
+      "layers" : [
+        {
+          "blend-mode-specializations" : [
+            {
+              "appearance" : "tinted",
+              "value" : "normal"
+            }
+          ],
+          "fill-specializations" : [
+            {
+              "value" : {
+                "solid" : "extended-gray:0.00000,1.00000"
+              }
+            },
+            {
+              "appearance" : "dark",
+              "value" : {
+                "linear-gradient" : [
+                  "display-p3:0.78674,0.78674,0.78674,1.00000",
+                  "display-p3:0.87416,0.87416,0.87416,1.00000"
+                ],
+                "orientation" : {
+                  "start" : {
+                    "x" : 0.5,
+                    "y" : 1
+                  },
+                  "stop" : {
+                    "x" : 0.5,
+                    "y" : 0
+                  }
+                }
+              }
+            },
+            {
+              "appearance" : "tinted",
+              "value" : {
+                "solid" : "gray:1.00000,1.00000"
+              }
+            }
+          ],
+          "glass-specializations" : [
+            {
+              "value" : true
+            },
+            {
+              "appearance" : "dark",
+              "value" : true
+            },
+            {
+              "appearance" : "tinted",
+              "value" : true
+            }
+          ],
+          "hidden" : false,
+          "image-name" : "feishin.svg",
+          "name" : "feishin",
+          "opacity-specializations" : [
+            {
+              "value" : 1
+            },
+            {
+              "appearance" : "tinted",
+              "value" : 1
+            }
+          ],
+          "position" : {
+            "scale" : 0.79,
+            "translation-in-points" : [
+              18,
+              -2
+            ]
+          }
+        }
+      ],
+      "lighting-specializations" : [
+        {
+          "value" : "individual"
+        },
+        {
+          "appearance" : "tinted",
+          "value" : "combined"
+        }
+      ],
+      "position" : {
+        "scale" : 2.2,
+        "translation-in-points" : [
+          0,
+          0
+        ]
+      },
+      "shadow-specializations" : [
+        {
+          "value" : {
+            "kind" : "neutral",
+            "opacity" : 1
+          }
+        },
+        {
+          "appearance" : "dark",
+          "value" : {
+            "kind" : "layer-color",
+            "opacity" : 0.5
+          }
+        },
+        {
+          "appearance" : "tinted",
+          "value" : {
+            "kind" : "neutral",
+            "opacity" : 1
+          }
+        }
+      ],
+      "specular-specializations" : [
+        {
+          "value" : false
+        },
+        {
+          "appearance" : "dark",
+          "value" : false
+        },
+        {
+          "appearance" : "tinted",
+          "value" : true
+        }
+      ],
+      "translucency-specializations" : [
+        {
+          "value" : {
+            "enabled" : true,
+            "value" : 0.29
+          }
+        },
+        {
+          "appearance" : "dark",
+          "value" : {
+            "enabled" : false,
+            "value" : 0.29
+          }
+        },
+        {
+          "appearance" : "tinted",
+          "value" : {
+            "enabled" : true,
+            "value" : 0.5
+          }
+        }
+      ]
+    }
+  ],
+  "supported-platforms" : {
+    "squares" : [
+      "macOS"
+    ]
+  }
+}

media/feishin.svg

@@ -0,0 +1,104 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+   width="512"
+   height="512"
+   viewBox="0 0 512 512"
+   version="1.1"
+   id="svg1"
+   xml:space="preserve"
+   xmlns:xlink="http://www.w3.org/1999/xlink"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:svg="http://www.w3.org/2000/svg"><defs
+     id="defs1"><linearGradient
+       id="linearGradient1"><stop
+         style="stop-color:#dfdfdf;stop-opacity:1;"
+         offset="0"
+         id="stop1" /><stop
+         style="stop-color:#ffffff;stop-opacity:1;"
+         offset="1"
+         id="stop2" /></linearGradient><filter
+       style="color-interpolation-filters:sRGB"
+       id="filter249"
+       x="-0.61395349"
+       y="-0.61395349"
+       width="2.227907"
+       height="2.5069767"><feFlood
+         result="flood"
+         in="SourceGraphic"
+         flood-opacity="0.498039"
+         flood-color="rgb(0,0,0)"
+         id="feFlood247" /><feGaussianBlur
+         result="blur"
+         in="SourceGraphic"
+         stdDeviation="1.000000"
+         id="feGaussianBlur247" /><feOffset
+         result="offset"
+         in="blur"
+         dx="0.000000"
+         dy="2"
+         id="feOffset247" /><feComposite
+         result="comp1"
+         operator="in"
+         in="flood"
+         in2="offset"
+         id="feComposite248" /><feComposite
+         result="fbSourceGraphic"
+         operator="over"
+         in="SourceGraphic"
+         id="feComposite249"
+         in2="comp1" /><feColorMatrix
+         result="fbSourceGraphicAlpha"
+         in="fbSourceGraphic"
+         values="0 0 0 -1 0 0 0 0 -1 0 0 0 0 -1 0 0 0 0 1 0"
+         id="feColorMatrix122" /><feFlood
+         id="feFlood122"
+         result="flood"
+         in="fbSourceGraphic"
+         flood-opacity="0.196078"
+         flood-color="rgb(0,0,0)" /><feGaussianBlur
+         id="feGaussianBlur122"
+         result="blur"
+         in="fbSourceGraphic"
+         stdDeviation="10.000000" /><feOffset
+         id="feOffset122"
+         result="offset"
+         in="blur"
+         dx="0.000000"
+         dy="10.000000" /><feComposite
+         id="feComposite122"
+         result="comp1"
+         operator="in"
+         in="flood"
+         in2="offset" /><feComposite
+         id="feComposite123"
+         result="comp2"
+         operator="over"
+         in="fbSourceGraphic"
+         in2="comp1" /></filter><linearGradient
+       xlink:href="#linearGradient1"
+       id="linearGradient2"
+       x1="256"
+       y1="0"
+       x2="256"
+       y2="512"
+       gradientUnits="userSpaceOnUse" /></defs><g
+     id="layer1"
+     style="display:inline"><circle
+       style="display:inline;fill:url(#linearGradient2);stroke-width:25;stroke-linecap:round;stroke-linejoin:round;paint-order:markers fill stroke"
+       id="background"
+       cx="256"
+       cy="256"
+       r="256" /><circle
+       style="opacity:1;fill:#000000;fill-opacity:1;fill-rule:nonzero;stroke:none;stroke-width:2.19597;stroke-linecap:round;stroke-linejoin:round;stroke-miterlimit:4;stroke-dasharray:none;stroke-dashoffset:0;stroke-opacity:1;paint-order:markers fill stroke;filter:url(#filter249)"
+       id="dot"
+       cx="256"
+       cy="240.31155"
+       r="21.5" /><path
+       id="bottom"
+       style="opacity:1;fill:#000000;fill-opacity:1;stroke:none;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;filter:url(#filter249)"
+       d="M 220.84961,277.95117 183.5,315.59961 219.5,351.69922 239.5,332 c 0,0 5.85615,-6.19922 16.5,-6.19922 10.64385,0 16.5,6.19922 16.5,6.19922 l 20,19.69922 36,-36.09961 -37.34961,-37.64844 A 51.5,51.5 0 0 1 256,291.8125 51.5,51.5 0 0 1 220.84961,277.95117 Z" /><path
+       id="main"
+       style="display:inline;opacity:1;fill:#000000;fill-opacity:1;stroke-width:2.2;stroke-linecap:round;stroke-linejoin:round;paint-order:markers fill stroke;filter:url(#filter249)"
+       d="m 256,145.40039 c -7.11895,0 -13.56326,2.88552 -18.22852,7.55078 L 66.96875,323.46875 C 62.354158,328.08334 59.5,334.45837 59.5,341.5 c 0,14.08326 11.416739,25.5 25.5,25.5 7.04163,0 13.41666,-2.85416 18.03125,-7.46875 L 206.92578,255.93359 A 51.5,51.5 0 0 1 204.5,240.3125 a 51.5,51.5 0 0 1 51.5,-51.5 51.5,51.5 0 0 1 51.5,51.5 51.5,51.5 0 0 1 -2.42578,15.62109 L 408.96875,359.53125 C 413.58334,364.14585 419.95837,367 427,367 c 14.08326,0 25.5,-11.41674 25.5,-25.5 0,-7.04163 -2.85415,-13.41666 -7.46875,-18.03125 L 274.22852,152.95117 C 269.56326,148.2859 263.11895,145.40039 256,145.40039 Z" /></g></svg>

ng.conf.template

@@ -1,5 +1,6 @@
 server {
   listen 9180;
+  listen [::]:9180;
   sendfile on;
   default_type application/octet-stream;
 
@@ -19,9 +20,11 @@ server {
 
   location ${PUBLIC_PATH}settings.js {
     alias /etc/nginx/conf.d/settings.js;
+    add_header Cache-Control "no-store";
   }
 
   location ${PUBLIC_PATH}/settings.js {
     alias /etc/nginx/conf.d/settings.js;
+    add_header Cache-Control "no-store";
   }
 }

org.jeffvli.feishin.metainfo.xml

@@ -0,0 +1,100 @@
+<?xml version="1.0" encoding="utf-8"?>
+<component type="desktop-application">
+  <id>org.jeffvli.feishin</id>
+  <name>Feishin</name>
+  <summary>Jellyfin, Navidrome, and OpenSubsonic Compatible Music Player</summary>
+  <metadata_license>CC0-1.0</metadata_license>
+  <project_license>GPL-3.0-only</project_license>
+  <content_rating type="oars-1.1"/>
+  <description>
+    <p>A modern, cross-platform music player for Jellyfin, Navidrome, and OpenSubsonic servers.</p>
+    <p>Features</p>
+    <ul>
+      <li>MPV player backend</li>
+      <li>Web player backend</li>
+      <li>Jellyfin server support</li>
+      <li>Navidrome server support</li>
+      <li>OpenSubsonic server support</li>
+      <li>Modern UI</li>
+      <li>Scrobble playback to your server</li>
+      <li>Smart playlist editor (Navidrome)</li>
+      <li>Synchronized and unsynchronized lyrics support</li>
+    </ul>
+  </description>
+  <developer id="org.jeffvli">
+    <name>jeffvli</name>
+  </developer>
+  <launchable type="desktop-id">org.jeffvli.feishin.desktop</launchable>
+  <url type="homepage">https://github.com/jeffvli/feishin</url>
+  <screenshots>
+    <screenshot type="default">
+      <caption>The main menu</caption>
+      <image type="source">https://raw.githubusercontent.com/jeffvli/feishin/development/media/preview_home.png</image>
+    </screenshot>
+    <screenshot>
+      <caption>Browsing an album</caption>
+      <image type="source">https://raw.githubusercontent.com/jeffvli/feishin/development/media/preview_album_detail.png</image>
+    </screenshot>
+    <screenshot>
+      <caption>Smart playlist creation</caption>
+      <image type="source">https://raw.githubusercontent.com/jeffvli/feishin/development/media/preview_smart_playlist.png</image>
+    </screenshot>
+  </screenshots>
+  <categories>
+    <category>AudioVideo</category>
+    <category>Audio</category>
+    <category>Player</category>
+    <category>Music</category>
+  </categories>
+  <releases>
+    <release date="2025-10-13" type="stable" version="0.21.2"></release>
+    <release date="2025-10-13" type="stable" version="0.21.1"></release>
+    <release date="2025-10-13" type="stable" version="0.21.0"></release>
+    <release date="2025-09-11" type="stable" version="0.20.1"></release>
+    <release date="2025-09-07" type="stable" version="0.20.0"></release>
+    <release date="2025-07-31" type="stable" version="0.19.0"></release>
+    <release date="2025-07-08" type="stable" version="0.18.0"></release>
+    <release date="2025-06-30" type="stable" version="0.17.0"></release>
+    <release date="2025-06-26" type="stable" version="0.16.0"></release>
+    <release date="2025-06-25" type="stable" version="0.15.1"></release>
+    <release date="2025-06-25" type="stable" version="0.15.0"></release>
+    <release date="2025-06-03" type="stable" version="0.14.0"></release>
+    <release date="2025-05-26" type="stable" version="0.13.0"></release>
+    <release date="2025-05-13" type="stable" version="0.12.7"></release>
+    <release date="2025-05-08" type="stable" version="0.12.6"></release>
+    <release date="2025-05-07" type="stable" version="0.12.5"></release>
+    <release date="2025-03-10" type="stable" version="0.12.3"></release>
+    <release date="2025-01-25" type="stable" version="0.12.2"></release>
+    <release date="2024-11-20" type="stable" version="0.12.1"></release>
+    <release date="2024-11-19" type="stable" version="0.12.0"></release>
+    <release date="2024-10-15" type="stable" version="0.11.1"></release>
+    <release date="2024-10-10" type="stable" version="0.11.0"></release>
+    <release date="2024-09-29" type="stable" version="0.10.1"></release>
+    <release date="2024-09-27" type="stable" version="0.10.0"></release>
+    <release date="2024-09-11" type="stable" version="0.9.0"></release>
+    <release date="2024-09-04" type="stable" version="0.8.1"></release>
+    <release date="2024-09-03" type="stable" version="0.8.0"></release>
+    <release date="2024-07-30" type="stable" version="0.7.3"></release>
+    <release date="2024-07-30" type="stable" version="0.7.2"></release>
+    <release date="2024-05-07" type="stable" version="0.7.1"></release>
+    <release date="2024-05-07" type="stable" version="0.7.0"></release>
+    <release date="2024-03-13" type="stable" version="0.6.1"></release>
+    <release date="2024-03-06" type="stable" version="0.6.0"></release>
+    <release date="2023-12-14" type="stable" version="0.5.3"></release>
+    <release date="2023-11-18" type="stable" version="0.5.2"></release>
+    <release date="2023-11-02" type="stable" version="0.5.1"></release>
+    <release date="2023-10-31" type="stable" version="0.5.0"></release>
+    <release date="2023-10-08" type="stable" version="0.4.1"></release>
+    <release date="2023-09-25" type="stable" version="0.4.0"></release>
+    <release date="2023-08-08" type="stable" version="0.3.0"></release>
+    <release date="2023-06-14" type="stable" version="0.2.0"></release>
+    <release date="2023-05-22" type="stable" version="0.1.1"></release>
+    <release date="2023-05-22" type="stable" version="0.1.0"></release>
+    <release date="2023-04-03" type="development" version="0.0.1-alpha6"></release>
+    <release date="2023-02-09" type="development" version="0.0.1-alpha5"></release>
+    <release date="2023-01-16" type="development" version="0.0.1-alpha4"></release>
+    <release date="2023-01-03" type="development" version="0.0.1-alpha3"></release>
+    <release date="2022-12-30" type="development" version="0.0.1-alpha2"></release>
+    <release date="2022-11-21" type="development" version="0.0.1-alpha1"></release>
+  </releases>
+</component>

package.json

@@ -1,6 +1,6 @@
 {
     "name": "feishin",
-    "version": "0.21.0",
+    "version": "1.11.0",
     "description": "A modern self-hosted music player.",
     "keywords": [
         "subsonic",
@@ -16,11 +16,12 @@
     "license": "GPL-3.0",
     "author": {
         "name": "jeffvli",
+        "email": "feishin@users.noreply.github.com",
         "url": "https://github.com/jeffvli/"
     },
     "main": "./out/main/index.js",
     "scripts": {
-        "build": "pnpm run typecheck && pnpm run build:electron && pnpm run build:remote",
+        "build": "pnpm run build:electron && pnpm run build:remote",
         "build:electron": "electron-vite build",
         "build:remote": "vite build --config remote.vite.config.ts",
         "build:web": "vite build --config web.vite.config.ts",
@@ -29,150 +30,161 @@
         "dev:watch": "electron-vite dev --watch",
         "i18next": "i18next -c src/i18n/i18next-parser.config.js",
         "postinstall": "electron-builder install-app-deps",
-        "lint": "pnpm run lint-code && pnpm run lint-styles",
+        "lint": "pnpm run typecheck && pnpm run lint-code && pnpm run lint-styles",
+        "lint:fix": "pnpm run lint-code:fix && pnpm run lint-styles:fix",
         "lint-code": "eslint --max-warnings=0 --cache .",
         "lint-code:fix": "eslint --cache --fix .",
         "lint-styles": "stylelint --max-warnings=0 'src/**/*.{css,scss}'",
         "lint-styles:fix": "stylelint 'src/**/*.{css,scss}' --fix",
-        "lint:fix": "pnpm run lint-code:fix && pnpm run lint-styles:fix",
         "package": "pnpm run build && electron-builder",
         "package:dev": "pnpm run build && electron-builder --dir",
         "package:linux": "pnpm run build && electron-builder --linux",
-        "package:linux-arm64:pr": "pnpm run build && electron-builder --linux --arm64 --publish never",
         "package:linux:pr": "pnpm run build && electron-builder --linux --publish never",
+        "package:linux-arm64:pr": "pnpm run build && electron-builder --linux --arm64 --publish never",
         "package:mac": "pnpm run build && electron-builder --mac",
         "package:mac:pr": "pnpm run build && electron-builder --mac --publish never",
         "package:win": "pnpm run build && electron-builder --win",
         "package:win:pr": "pnpm run build && electron-builder --win --publish never",
+        "package:win-arm64:pr": "pnpm run build && electron-builder --win --arm64 --publish never",
         "publish:linux": "pnpm run build && electron-builder --publish always --linux",
-        "publish:linux-arm64": "pnpm run build && electron-builder --publish always --linux --arm64",
-        "publish:linux-arm64:beta": "pnpm run build && electron-builder --config electron-builder-beta.yml --publish always --linux --arm64",
+        "publish:linux:alpha": "pnpm run build && electron-builder --config electron-builder-alpha.yml --publish always --linux",
         "publish:linux:beta": "pnpm run build && electron-builder --config electron-builder-beta.yml --publish always --linux",
+        "publish:linux-arm64": "pnpm run build && electron-builder --publish always --linux --arm64",
+        "publish:linux-arm64:alpha": "pnpm run build && electron-builder --config electron-builder-alpha.yml --publish always --linux --arm64",
+        "publish:linux-arm64:beta": "pnpm run build && electron-builder --config electron-builder-beta.yml --publish always --linux --arm64",
         "publish:mac": "pnpm run build && electron-builder --publish always --mac",
+        "publish:mac:alpha": "pnpm run build && electron-builder --config electron-builder-alpha.yml --publish always --mac",
         "publish:mac:beta": "pnpm run build && electron-builder --config electron-builder-beta.yml --publish always --mac",
         "publish:win": "pnpm run build && electron-builder --publish always --win",
+        "publish:win:alpha": "pnpm run build && electron-builder --config electron-builder-alpha.yml --publish always --win",
         "publish:win:beta": "pnpm run build && electron-builder --config electron-builder-beta.yml --publish always --win",
+        "publish:win-arm64": "pnpm run build && electron-builder --publish always --win --arm64",
+        "publish:win-arm64:alpha": "pnpm run build && electron-builder --config electron-builder-alpha.yml --publish always --win --arm64",
+        "publish:win-arm64:beta": "pnpm run build && electron-builder --config electron-builder-beta.yml --publish always --win --arm64",
         "start": "electron-vite preview",
         "typecheck": "pnpm run typecheck:node && pnpm run typecheck:web",
         "typecheck:node": "tsc --noEmit -p tsconfig.node.json --composite false",
-        "typecheck:web": "tsc --noEmit -p tsconfig.web.json --composite false"
+        "typecheck:web": "tsc --noEmit -p tsconfig.web.json --composite false",
+        "version": "pnpm version --no-git-tag-version",
+        "postversion": "node ./scripts/update-app-stream.mjs"
+    },
+    "resolutions": {
+        "react-router": "7.14.0",
+        "xml2js": "0.5.0"
     },
     "dependencies": {
-        "@ag-grid-community/client-side-row-model": "^28.2.1",
-        "@ag-grid-community/core": "^28.2.1",
-        "@ag-grid-community/infinite-row-model": "^28.2.1",
-        "@ag-grid-community/react": "^28.2.1",
-        "@ag-grid-community/styles": "^28.2.1",
-        "@atlaskit/pragmatic-drag-and-drop": "1.4.0",
-        "@atlaskit/pragmatic-drag-and-drop-auto-scroll": "^2.1.0",
-        "@atlaskit/pragmatic-drag-and-drop-hitbox": "^1.0.3",
-        "@electron-toolkit/preload": "^3.0.1",
+        "@atlaskit/pragmatic-drag-and-drop": "1.7.7",
+        "@atlaskit/pragmatic-drag-and-drop-auto-scroll": "^2.1.5",
+        "@atlaskit/pragmatic-drag-and-drop-hitbox": "^1.1.0",
+        "@electron-toolkit/preload": "^3.0.2",
         "@electron-toolkit/utils": "^4.0.0",
-        "@mantine/colors-generator": "^8.2.8",
-        "@mantine/core": "^8.2.8",
-        "@mantine/dates": "^8.2.8",
-        "@mantine/form": "^8.2.8",
-        "@mantine/hooks": "^8.2.8",
-        "@mantine/modals": "^8.2.8",
-        "@mantine/notifications": "^8.2.8",
-        "@tanstack/react-query": "^4.32.1",
-        "@tanstack/react-query-devtools": "^4.32.1",
-        "@tanstack/react-query-persist-client": "^4.32.1",
-        "@ts-rest/core": "^3.23.0",
-        "@xhayper/discord-rpc": "^1.3.0",
-        "audiomotion-analyzer": "^4.5.0",
-        "auto-text-size": "^0.2.3",
-        "axios": "^1.12.0",
-        "cheerio": "^1.0.0",
-        "clsx": "^2.0.0",
-        "cmdk": "^0.2.0",
-        "dayjs": "^1.11.6",
-        "dompurify": "^3.1.6",
+        "@mantine/colors-generator": "^9.1.1",
+        "@mantine/core": "^9.1.1",
+        "@mantine/dates": "^9.1.1",
+        "@mantine/form": "^9.1.1",
+        "@mantine/hooks": "^9.1.1",
+        "@mantine/modals": "^9.1.1",
+        "@mantine/notifications": "^9.1.1",
+        "@radix-ui/react-context-menu": "^2.2.16",
+        "@tanstack/react-query": "^5.96.2",
+        "@tanstack/react-query-devtools": "^5.96.2",
+        "@tanstack/react-query-persist-client": "^5.96.2",
+        "@ts-rest/core": "^3.52.1",
+        "@wavesurfer/react": "^1.0.12",
+        "@xhayper/discord-rpc": "^1.3.3",
+        "audiomotion-analyzer": "^4.5.4",
+        "axios": "^1.14.0",
+        "butterchurn": "3.0.0-beta.5",
+        "butterchurn-presets": "3.0.0-beta.4",
+        "cheerio": "^1.2.0",
+        "clsx": "^2.1.1",
+        "cmdk": "^1.1.1",
+        "dayjs": "^1.11.20",
+        "dompurify": "^3.3.3",
         "electron-debug": "^3.2.0",
         "electron-localshortcut": "^3.2.1",
-        "electron-log": "^5.1.1",
-        "electron-store": "^8.1.0",
-        "electron-updater": "^6.3.9",
-        "fast-average-color": "^9.3.0",
-        "format-duration": "^2.0.0",
-        "fuse.js": "^6.6.2",
-        "i18next": "^21.10.0",
-        "idb-keyval": "^6.2.1",
-        "immer": "^9.0.21",
+        "electron-log": "^5.4.3",
+        "electron-store": "^8.2.0",
+        "electron-updater": "^6.8.3",
+        "fast-average-color": "9.5.0",
+        "fast-xml-parser": "^5.5.10",
+        "format-duration": "^3.0.2",
+        "fuse.js": "^7.2.0",
+        "i18next": "^25.10.10",
+        "icecast-metadata-stats": "^0.1.12",
+        "idb-keyval": "^6.2.2",
+        "immer": "^10.2.0",
         "is-electron": "^2.2.2",
-        "lodash": "^4.17.21",
+        "lodash": "^4.18.1",
         "md5": "^2.3.0",
-        "memoize-one": "^6.0.0",
-        "motion": "^12.18.1",
+        "motion": "^12.38.0",
         "mpris-service": "^2.1.2",
-        "nanoid": "^3.3.3",
+        "nanoid": "^3.3.11",
         "node-mpv": "github:jeffvli/Node-MPV#32b4d64395289ad710c41d481d2707a7acfc228f",
-        "overlayscrollbars": "^2.11.1",
+        "overlayscrollbars": "^2.14.0",
         "overlayscrollbars-react": "^0.5.6",
-        "qs": "^6.14.0",
-        "react": "^19.1.0",
-        "react-dom": "^19.1.0",
-        "react-error-boundary": "^3.1.4",
-        "react-i18next": "^11.18.6",
-        "react-icons": "^5.5.0",
-        "react-image": "^4.1.0",
-        "react-intersection-observer": "^9.16.0",
-        "react-loading-skeleton": "^3.5.0",
-        "react-player": "^2.11.0",
-        "react-router": "^6.16.0",
-        "react-router-dom": "^6.16.0",
-        "react-virtualized-auto-sizer": "^1.0.17",
-        "react-window": "^1.8.9",
-        "react-window-infinite-loader": "^1.0.9",
-        "semver": "^7.5.4",
-        "swiper": "^9.3.1",
-        "use-sync-external-store": "^1.5.0",
-        "ws": "^8.18.2",
-        "zod": "^3.22.3",
-        "zustand": "^5.0.5"
+        "qs": "^6.15.0",
+        "react": "^19.2.4",
+        "react-call": "^1.8.2",
+        "react-dom": "^19.2.4",
+        "react-error-boundary": "^5.0.0",
+        "react-i18next": "^16.6.6",
+        "react-icons": "^5.6.0",
+        "react-player": "^2.16.1",
+        "react-router": "^7.14.0",
+        "react-split-pane": "^3.2.0",
+        "react-virtualized-auto-sizer": "^1.0.26",
+        "react-window": "1.8.11",
+        "react-window-v2": "npm:react-window@^2.2.7",
+        "semver": "^7.7.4",
+        "string-to-color": "^2.2.2",
+        "wavesurfer.js": "^7.12.5",
+        "ws": "^8.20.0",
+        "zod": "^3.25.76",
+        "zustand": "^5.0.12"
     },
     "devDependencies": {
         "@electron-toolkit/eslint-config-prettier": "^3.0.0",
-        "@electron-toolkit/eslint-config-ts": "^3.0.0",
-        "@electron-toolkit/tsconfig": "^1.0.1",
-        "@types/electron-localshortcut": "^3.1.0",
-        "@types/lodash": "^4.17.18",
-        "@types/md5": "^2.3.5",
-        "@types/node": "^22.15.32",
-        "@types/react": "^18.3.23",
-        "@types/react-dom": "^18.3.7",
-        "@types/react-window": "^1.8.5",
-        "@types/react-window-infinite-loader": "^1.0.6",
+        "@electron-toolkit/eslint-config-ts": "^3.1.0",
+        "@electron-toolkit/tsconfig": "^2.0.0",
+        "@types/electron-localshortcut": "^3.1.3",
+        "@types/lodash": "^4.17.24",
+        "@types/md5": "^2.3.6",
+        "@types/node": "^24.12.2",
+        "@types/react": "^19.2.14",
+        "@types/react-dom": "^19.2.3",
+        "@types/react-window": "^1.8.8",
         "@types/source-map-support": "^0.5.10",
         "@types/ws": "^8.18.1",
-        "@vitejs/plugin-react": "^4.3.4",
-        "concurrently": "^7.1.0",
-        "cross-env": "^7.0.3",
-        "electron": "^37.4.0",
-        "electron-builder": "^26.0.12",
-        "electron-devtools-installer": "^3.2.0",
-        "electron-vite": "^3.1.0",
-        "eslint": "^9.24.0",
-        "eslint-plugin-perfectionist": "^4.13.0",
-        "eslint-plugin-prettier": "^5.4.0",
+        "@vitejs/plugin-react": "^5.2.0",
+        "babel-plugin-react-compiler": "^1.0.0",
+        "concurrently": "^9.2.1",
+        "cross-env": "^10.1.0",
+        "electron": "^39.8.6",
+        "electron-builder": "^26.8.2",
+        "electron-devtools-installer": "^4.0.0",
+        "electron-vite": "^4.0.1",
+        "eslint": "^9.39.4",
+        "eslint-plugin-perfectionist": "^4.15.1",
+        "eslint-plugin-prettier": "^5.5.5",
         "eslint-plugin-react": "^7.37.5",
-        "eslint-plugin-react-hooks": "^5.2.0",
-        "eslint-plugin-react-refresh": "^0.4.19",
-        "i18next-parser": "^9.0.2",
-        "postcss-preset-mantine": "^1.17.0",
-        "prettier": "^3.5.3",
-        "prettier-plugin-packagejson": "^2.5.14",
-        "sass-embedded": "^1.89.0",
-        "stylelint": "^16.14.1",
-        "stylelint-config-css-modules": "^4.4.0",
-        "stylelint-config-recess-order": "^7.1.0",
-        "stylelint-config-standard": "^38.0.0",
-        "typescript": "^5.8.3",
-        "vite": "^6.3.6",
+        "eslint-plugin-react-hooks": "^7.0.1",
+        "eslint-plugin-react-refresh": "^0.4.26",
+        "i18next-parser": "^9.4.0",
+        "postcss-preset-mantine": "^1.18.0",
+        "postcss-simple-vars": "^7.0.1",
+        "prettier": "^3.8.1",
+        "prettier-plugin-packagejson": "^2.5.22",
+        "stylelint": "^16.26.1",
+        "stylelint-config-css-modules": "^4.6.0",
+        "stylelint-config-recess-order": "^7.7.0",
+        "stylelint-config-standard": "^39.0.1",
+        "typescript": "^5.9.3",
+        "vite": "^7.3.1",
         "vite-plugin-conditional-import": "^0.1.7",
         "vite-plugin-dynamic-import": "^1.6.0",
         "vite-plugin-ejs": "^1.7.0",
-        "vite-plugin-pwa": "^1.0.3"
+        "vite-plugin-pwa": "^1.2.0"
     },
     "pnpm": {
         "onlyBuiltDependencies": [

postcss.config.cjs

@@ -1,5 +1,16 @@
 module.exports = {
     plugins: {
         'postcss-preset-mantine': {},
+        'postcss-simple-vars': {
+            variables: {
+                'mantine-breakpoint-2xl': '120em',
+                'mantine-breakpoint-3xl': '160em',
+                'mantine-breakpoint-lg': '75em',
+                'mantine-breakpoint-md': '62em',
+                'mantine-breakpoint-sm': '48em',
+                'mantine-breakpoint-xl': '88em',
+                'mantine-breakpoint-xs': '36em',
+            },
+        },
     },
 };

remote.vite.config.ts

@@ -1,13 +1,15 @@
-import react from '@vitejs/plugin-react';
 import path from 'path';
 import { defineConfig, normalizePath } from 'vite';
 import { ViteEjsPlugin } from 'vite-plugin-ejs';
 
 import { version } from './package.json';
+import { createReactPlugin } from './vite.react-plugin';
 
 export default defineConfig({
     build: {
+        cssMinify: 'esbuild',
         emptyOutDir: true,
+        minify: 'esbuild',
         outDir: path.resolve(__dirname, './out/remote'),
         rollupOptions: {
             input: {
@@ -21,6 +23,7 @@ export default defineConfig({
                 assetFileNames: '[name].[ext]',
                 chunkFileNames: '[name].js',
                 entryFileNames: '[name].js',
+                sourcemapExcludeSources: false,
             },
         },
         sourcemap: true,
@@ -32,7 +35,7 @@ export default defineConfig({
         },
     },
     plugins: [
-        react(),
+        createReactPlugin(),
         ViteEjsPlugin({
             prod: process.env.NODE_ENV === 'production',
             root: normalizePath(path.resolve(__dirname, './src/remote')),

scripts/after-all-artifact-build.mjs

@@ -0,0 +1,45 @@
+import { execSync } from 'child_process';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+/**
+ * Electron-builder afterAllArtifactBuild hook
+ * Runs the app stream update script only for Linux builds
+ * Returns the metainfo file path to be included in published artifacts
+ */
+
+// This is not a typescript file, and is called by electron-builder, so we cannot use typescript features here.
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type
+export default async function afterAllArtifactBuild(buildResult) {
+    // Check if this build includes Linux as a target
+    const isLinux = Array.from(buildResult.platformToTargets.keys()).some(
+        (platform) => platform.name === 'linux',
+    );
+
+    if (isLinux) {
+        const updateScriptPath = path.join(__dirname, 'update-app-stream.mjs');
+        const projectRoot = path.resolve(__dirname, '..');
+        const metainfoFile = path.resolve(projectRoot, 'org.jeffvli.feishin.metainfo.xml');
+
+        console.log('Running app stream update for Linux build...');
+
+        try {
+            execSync(`node ${updateScriptPath} --replace-if-version-missing`, {
+                cwd: projectRoot,
+                stdio: 'inherit',
+            });
+
+            // Return the metainfo file to be included in published artifacts
+            return [metainfoFile];
+        } catch (error) {
+            console.error('Failed to update app stream:', error.message);
+            throw error;
+        }
+    }
+
+    // Return empty array if not a Linux build
+    return [];
+}

scripts/update-app-stream.mjs

@@ -0,0 +1,56 @@
+import { XMLBuilder, XMLParser } from 'fast-xml-parser';
+import fs from 'fs';
+import path from 'path';
+
+const args = process.argv.slice(2);
+
+// Parse flags and positional arguments
+const flags = args.filter((arg) => arg.startsWith('--'));
+const positionalArgs = args.filter((arg) => !arg.startsWith('--'));
+const replaceIfVersionMissing = flags.includes('--replace-if-version-missing');
+
+if (positionalArgs.length > 3) {
+    console.error(
+        'Usage: node update-app-stream.js [package-file] [date] [metainfo-file] [--replace-if-version-missing]',
+    );
+    process.exit(1);
+}
+
+const packageFile = positionalArgs[0] || path.resolve(process.cwd(), 'package.json');
+
+const packageContent = fs.readFileSync(packageFile, 'utf8');
+const packageJson = JSON.parse(packageContent);
+const version = packageJson.version;
+
+const time = Math.floor((Date.parse(positionalArgs[1]) || Date.now()) / 1000);
+const metainfoFile =
+    positionalArgs[2] || path.resolve(process.cwd(), 'org.jeffvli.feishin.metainfo.xml');
+
+const parser = new XMLParser({ ignoreAttributes: false });
+const metainfoContent = fs.readFileSync(metainfoFile, 'utf8');
+const metainfo = parser.parse(metainfoContent);
+
+const newRelease = {
+    '@_date': new Date(time * 1000).toISOString().split('T')[0],
+    '@_type': version.includes('-') ? 'development' : 'stable',
+    '@_version': version,
+};
+
+if (replaceIfVersionMissing) {
+    // Replace all releases with only the current version
+    metainfo.component.releases.release = [newRelease];
+} else {
+    // Default behavior: add new release if it doesn't exist
+    const releaseExists =
+        metainfo.component.releases.release.findIndex(
+            (release) => release['@_version'] === version,
+        ) !== -1;
+    if (!releaseExists) {
+        metainfo.component.releases.release.unshift(newRelease);
+    }
+}
+
+const builder = new XMLBuilder({ format: true, ignoreAttributes: false, indentBy: '  ' });
+fs.writeFileSync(metainfoFile, builder.build(metainfo), 'utf8');
+
+console.log(`Updated ${metainfoFile} with version ${version}`);

settings.js.template

@@ -1 +1,90 @@
-"use strict";window.SERVER_URL="${SERVER_URL}";window.SERVER_NAME="${SERVER_NAME}";window.SERVER_TYPE="${SERVER_TYPE}";window.SERVER_LOCK=${SERVER_LOCK};
+"use strict";
+
+window.SERVER_URL = "${SERVER_URL}";
+window.REMOTE_URL = "${REMOTE_URL}";
+window.SERVER_NAME = "${SERVER_NAME}";
+window.SERVER_TYPE = "${SERVER_TYPE}";
+window.SERVER_LOCK = "${SERVER_LOCK}";
+window.LEGACY_AUTHENTICATION = "${LEGACY_AUTHENTICATION}";
+window.ANALYTICS_DISABLED = "${ANALYTICS_DISABLED}";
+
+window.FS_GENERAL_ACCENT = "${FS_GENERAL_ACCENT}";
+window.FS_GENERAL_ALBUM_BACKGROUND = "${FS_GENERAL_ALBUM_BACKGROUND}";
+window.FS_GENERAL_ALBUM_BACKGROUND_BLUR = "${FS_GENERAL_ALBUM_BACKGROUND_BLUR}";
+window.FS_GENERAL_ARTIST_BACKGROUND = "${FS_GENERAL_ARTIST_BACKGROUND}";
+window.FS_GENERAL_ARTIST_BACKGROUND_BLUR = "${FS_GENERAL_ARTIST_BACKGROUND_BLUR}";
+window.FS_GENERAL_BLUR_EXPLICIT_IMAGES = "${FS_GENERAL_BLUR_EXPLICIT_IMAGES}";
+window.FS_GENERAL_COMBINED_LYRICS_AND_VISUALIZER = "${FS_GENERAL_COMBINED_LYRICS_AND_VISUALIZER}";
+window.FS_GENERAL_ENABLE_GRID_MULTI_SELECT = "${FS_GENERAL_ENABLE_GRID_MULTI_SELECT}";
+window.FS_GENERAL_EXTERNAL_LINKS = "${FS_GENERAL_EXTERNAL_LINKS}";
+window.FS_GENERAL_FOLLOW_CURRENT_SONG = "${FS_GENERAL_FOLLOW_CURRENT_SONG}";
+window.FS_GENERAL_FOLLOW_SYSTEM_THEME = "${FS_GENERAL_FOLLOW_SYSTEM_THEME}";
+window.FS_GENERAL_HOME_FEATURE = "${FS_GENERAL_HOME_FEATURE}";
+window.FS_GENERAL_HOME_FEATURE_STYLE = "${FS_GENERAL_HOME_FEATURE_STYLE}";
+window.FS_GENERAL_LANGUAGE = "${FS_GENERAL_LANGUAGE}";
+window.FS_GENERAL_LAST_FM = "${FS_GENERAL_LAST_FM}";
+window.FS_GENERAL_LASTFM_API_KEY = "${FS_GENERAL_LASTFM_API_KEY}";
+window.FS_GENERAL_LISTEN_BRAINZ = "${FS_GENERAL_LISTEN_BRAINZ}";
+window.FS_GENERAL_MUSIC_BRAINZ = "${FS_GENERAL_MUSIC_BRAINZ}";
+window.FS_GENERAL_NATIVE_ASPECT_RATIO = "${FS_GENERAL_NATIVE_ASPECT_RATIO}";
+window.FS_GENERAL_PATH_REPLACE = "${FS_GENERAL_PATH_REPLACE}";
+window.FS_GENERAL_PATH_REPLACE_WITH = "${FS_GENERAL_PATH_REPLACE_WITH}";
+window.FS_GENERAL_PLAYERBAR_OPEN_DRAWER = "${FS_GENERAL_PLAYERBAR_OPEN_DRAWER}";
+window.FS_GENERAL_PRIMARY_SHADE = "${FS_GENERAL_PRIMARY_SHADE}";
+window.FS_GENERAL_QOBUZ = "${FS_GENERAL_QOBUZ}";
+window.FS_GENERAL_RESUME = "${FS_GENERAL_RESUME}";
+window.FS_GENERAL_SHOW_LYRICS_IN_SIDEBAR = "${FS_GENERAL_SHOW_LYRICS_IN_SIDEBAR}";
+window.FS_GENERAL_SHOW_RATINGS = "${FS_GENERAL_SHOW_RATINGS}";
+window.FS_GENERAL_SHOW_VISUALIZER_IN_SIDEBAR = "${FS_GENERAL_SHOW_VISUALIZER_IN_SIDEBAR}";
+window.FS_GENERAL_SIDEBAR_COLLAPSED_NAVIGATION = "${FS_GENERAL_SIDEBAR_COLLAPSED_NAVIGATION}";
+window.FS_GENERAL_SIDEBAR_COLLAPSE_SHARED = "${FS_GENERAL_SIDEBAR_COLLAPSE_SHARED}";
+window.FS_GENERAL_SIDEBAR_PLAYLIST_LIST = "${FS_GENERAL_SIDEBAR_PLAYLIST_LIST}";
+window.FS_GENERAL_SIDEBAR_PLAYLIST_SORTING = "${FS_GENERAL_SIDEBAR_PLAYLIST_SORTING}";
+window.FS_GENERAL_SIDE_QUEUE_TYPE = "${FS_GENERAL_SIDE_QUEUE_TYPE}";
+window.FS_GENERAL_SIDE_QUEUE_LAYOUT = "${FS_GENERAL_SIDE_QUEUE_LAYOUT}";
+window.FS_GENERAL_THEME = "${FS_GENERAL_THEME}";
+window.FS_GENERAL_THEME_DARK = "${FS_GENERAL_THEME_DARK}";
+window.FS_GENERAL_THEME_LIGHT = "${FS_GENERAL_THEME_LIGHT}";
+window.FS_GENERAL_USE_THEME_ACCENT_COLOR = "${FS_GENERAL_USE_THEME_ACCENT_COLOR}";
+window.FS_GENERAL_USE_THEME_PRIMARY_SHADE = "${FS_GENERAL_USE_THEME_PRIMARY_SHADE}";
+window.FS_GENERAL_ZOOM_FACTOR = "${FS_GENERAL_ZOOM_FACTOR}";
+
+window.FS_PLAYBACK_MEDIA_SESSION = "${FS_PLAYBACK_MEDIA_SESSION}";
+window.FS_PLAYBACK_WEB_AUDIO = "${FS_PLAYBACK_WEB_AUDIO}";
+window.FS_PLAYBACK_AUDIO_FADE_ON_STATUS_CHANGE = "${FS_PLAYBACK_AUDIO_FADE_ON_STATUS_CHANGE}";
+window.FS_PLAYBACK_PRESERVE_PITCH = "${FS_PLAYBACK_PRESERVE_PITCH}";
+window.FS_PLAYBACK_SCROBBLE_ENABLED = "${FS_PLAYBACK_SCROBBLE_ENABLED}";
+window.FS_PLAYBACK_SCROBBLE_NOTIFY = "${FS_PLAYBACK_SCROBBLE_NOTIFY}";
+window.FS_PLAYBACK_SCROBBLE_AT_DURATION = "${FS_PLAYBACK_SCROBBLE_AT_DURATION}";
+window.FS_PLAYBACK_SCROBBLE_AT_PERCENTAGE = "${FS_PLAYBACK_SCROBBLE_AT_PERCENTAGE}";
+window.FS_PLAYBACK_TRANSCODE_ENABLED = "${FS_PLAYBACK_TRANSCODE_ENABLED}";
+
+window.FS_DISCORD_ENABLED = "${FS_DISCORD_ENABLED}";
+window.FS_DISCORD_CLIENT_ID = "${FS_DISCORD_CLIENT_ID}";
+window.FS_DISCORD_DISPLAY_TYPE = "${FS_DISCORD_DISPLAY_TYPE}";
+window.FS_DISCORD_LINK_TYPE = "${FS_DISCORD_LINK_TYPE}";
+window.FS_DISCORD_SHOW_AS_LISTENING = "${FS_DISCORD_SHOW_AS_LISTENING}";
+window.FS_DISCORD_SHOW_PAUSED = "${FS_DISCORD_SHOW_PAUSED}";
+window.FS_DISCORD_SHOW_SERVER_IMAGE = "${FS_DISCORD_SHOW_SERVER_IMAGE}";
+window.FS_DISCORD_SHOW_STATE_ICON = "${FS_DISCORD_SHOW_STATE_ICON}";
+
+window.FS_LYRICS_FETCH = "${FS_LYRICS_FETCH}";
+window.FS_LYRICS_FOLLOW = "${FS_LYRICS_FOLLOW}";
+window.FS_LYRICS_DELAY_MS = "${FS_LYRICS_DELAY_MS}";
+window.FS_LYRICS_PREFER_LOCAL = "${FS_LYRICS_PREFER_LOCAL}";
+window.FS_LYRICS_SHOW_MATCH = "${FS_LYRICS_SHOW_MATCH}";
+window.FS_LYRICS_SHOW_PROVIDER = "${FS_LYRICS_SHOW_PROVIDER}";
+window.FS_LYRICS_ENABLE_AUTO_TRANSLATION = "${FS_LYRICS_ENABLE_AUTO_TRANSLATION}";
+window.FS_LYRICS_TRANSLATION_API_KEY = "${FS_LYRICS_TRANSLATION_API_KEY}";
+window.FS_LYRICS_TRANSLATION_TARGET_LANGUAGE = "${FS_LYRICS_TRANSLATION_TARGET_LANGUAGE}";
+window.FS_LYRICS_ALIGNMENT = "${FS_LYRICS_ALIGNMENT}";
+
+window.FS_AUTO_DJ_ENABLED = "${FS_AUTO_DJ_ENABLED}";
+window.FS_AUTO_DJ_ITEM_COUNT = "${FS_AUTO_DJ_ITEM_COUNT}";
+window.FS_AUTO_DJ_TIMING = "${FS_AUTO_DJ_TIMING}";
+
+window.FS_CSS_CONTENT = "${FS_CSS_CONTENT}";
+window.FS_CSS_ENABLED = "${FS_CSS_ENABLED}";
+window.FS_FONT_TYPE = "${FS_FONT_TYPE}";
+window.FS_FONT_BUILT_IN = "${FS_FONT_BUILT_IN}";
+window.FS_FONT_SYSTEM = "${FS_FONT_SYSTEM}";

src/i18n/i18n.ts

@@ -1,4 +1,4 @@
-import { PostProcessorModule, StringMap, TOptions } from 'i18next';
+import { PostProcessorModule } from 'i18next';
 import i18n from 'i18next';
 import { initReactI18next } from 'react-i18next';
 
@@ -203,20 +203,17 @@ const titleCasePostProcessor: PostProcessorModule = {
     type: 'postProcessor',
 };
 
-const ignoreSentenceCaseLanguages = ['de'];
+// const ignoreSentenceCaseLanguages = ['de'];
 
 const sentenceCasePostProcessor: PostProcessorModule = {
     name: 'sentenceCase',
-    process: (value: string, _key: string, _options: TOptions<StringMap>, translator: any) => {
+    process: (value: string) => {
         const sentences = value.split('. ');
 
         return sentences
             .map((sentence) => {
                 return (
-                    sentence.charAt(0).toLocaleUpperCase() +
-                    (!ignoreSentenceCaseLanguages.includes(translator.language)
-                        ? sentence.slice(1).toLocaleLowerCase()
-                        : sentence.slice(1))
+                    sentence.charAt(0).toLocaleUpperCase() + sentence.slice(1).toLocaleLowerCase()
                 );
             })
             .join('. ');

src/i18n/locales/ar.json

@@ -1,27 +1,33 @@
 {
     "action": {
-        "addToFavorites": "إضافة الى $t(entity.favorite_other)",
-        "addToPlaylist": "إضافة الى $t(entity.playlist_one)",
+        "addToFavorites": "إضافة الى $t(entity.favorite, {\"count\": 2})",
+        "addToPlaylist": "إضافة الى $t(entity.playlist, {\"count\": 1})",
         "clearQueue": "مسح قائمة الإنتظار",
-        "createPlaylist": "إنشاء $t(entity.playlist_one)",
-        "deletePlaylist": "حذف $t(entity.playlist_one)",
+        "createPlaylist": "إنشاء $t(entity.playlist, {\"count\": 1})",
+        "deletePlaylist": "حذف $t(entity.playlist, {\"count\": 1})",
         "deselectAll": "إلغاء تحديد الكل",
-        "editPlaylist": "تعديل $t(entity.playlist_one)",
+        "editPlaylist": "تعديل $t(entity.playlist, {\"count\": 1})",
         "goToPage": "اذهب الى صفحة",
         "moveToNext": "الذهاب الى التالي",
         "moveToBottom": "الذهاب الى الأسفل",
         "moveToTop": "الذهاب الى الأعلى",
         "refresh": "$t(common.refresh)",
-        "removeFromFavorites": "حذف من $t(entity.favorite_other)",
-        "removeFromPlaylist": "حذف من $t(entity.playlist_one)",
+        "removeFromFavorites": "حذف من $t(entity.favorite, {\"count\": 2})",
+        "removeFromPlaylist": "حذف من $t(entity.playlist, {\"count\": 1})",
         "removeFromQueue": "حذف من قائمة الإنتظار",
         "setRating": "تحديد التقييم",
         "toggleSmartPlaylistEditor": "تشغيل / إطفاء وضع التعديل لـ $t(entity.smartPlaylist)",
-        "viewPlaylists": "إظهار $t(entity.playlist_other)",
+        "viewPlaylists": "إظهار $t(entity.playlist, {\"count\": 2})",
         "openIn": {
             "lastfm": "فتح في Last.fm",
             "musicbrainz": "فتح في MusicBrainz"
-        }
+        },
+        "addOrRemoveFromSelection": "إضافة أو إزالة من الإختيارات",
+        "selectRangeOfItems": "اختر مجموعة من العناصر",
+        "goToCurrent": "الانتقال إلى العنصر الحالي",
+        "createRadioStation": "يخلق $t(entity.radioStation, {\"count\": 1})",
+        "deleteRadioStation": "يمسح $t(entity.radioStation, {\"count\": 1})",
+        "selectAll": "تحديد الكل"
     },
     "common": {
         "action_zero": "عملية",
@@ -59,7 +65,7 @@
         "configure": "تعديل",
         "confirm": "تأكيد",
         "create": "إنشاء",
-        "currentSong": "$t(entity.track_one) الحالي",
+        "currentSong": "$t(entity.track, {\"count\": 1}) الحالي",
         "decrease": "تنقيص",
         "delete": "حذف",
         "descending": "تنازلي",
@@ -102,7 +108,7 @@
         "path": "المسار",
         "playerMustBePaused": "يجب إيقاف المشغل",
         "preview": "معاينة",
-        "previousSong": "$t(entity.track_one) السابق",
+        "previousSong": "$t(entity.track, {\"count\": 1}) السابق",
         "quit": "خروج",
         "random": "عشوائي",
         "rating": "التقييم",
@@ -117,7 +123,12 @@
         "saveAndReplace": "حفظ واستبدال",
         "saveAs": "حفظ بإسم",
         "search": "بحث",
-        "setting": "إعداد",
+        "setting_zero": "إعداد",
+        "setting_one": "",
+        "setting_two": "",
+        "setting_few": "",
+        "setting_many": "",
+        "setting_other": "",
         "share": "نشر",
         "size": "حجم",
         "sortOrder": "الترتيب",