release: merge dev → master (normalization, auto-gain, explorer, tidal, player fixes)

.dev-url

@@ -1 +1 @@
-http://localhost:5174
+http://localhost:5175

.github/workflows/ci.yml

@@ -22,7 +22,7 @@ jobs:
     if: github.event_name != 'pull_request' || github.base_ref != 'master' || github.head_ref == 'dev'
     runs-on: ubuntu-22.04
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
 
       - name: Setup Node.js
         uses: actions/setup-node@v6
@@ -61,7 +61,7 @@ jobs:
     if: github.event_name != 'pull_request' || github.base_ref != 'master' || github.head_ref == 'dev'
     runs-on: ubuntu-22.04
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
 
       - name: Setup Node.js
         uses: actions/setup-node@v6

.github/workflows/release.yml

@@ -44,7 +44,7 @@ jobs:
     name: Build (${{ matrix.platform }})
 
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
 
       - uses: actions/setup-node@v6
         with:
@@ -128,60 +128,60 @@ jobs:
   # Requires secret: CHOCOLATEY_API_KEY
   # One-time setup: submit chocolatey/djmanager.nuspec to chocolatey.org for
   # initial package approval, then CI pushes all future updates automatically.
-  chocolatey:
-    if: github.ref_name == 'master'
-    needs: [setup, create-release]
-    runs-on: windows-latest
-    steps:
-      - uses: actions/checkout@v6
-
-      - uses: actions/download-artifact@v8
-        with:
-          name: dist-win
-          path: dist-win/
-
-      - name: Compute installer SHA256 and build download URL
-        id: installer
-        shell: pwsh
-        run: |
-          $exe = Get-ChildItem dist-win\*.exe | Select-Object -First 1
-          if (-not $exe) { throw "No .exe found in dist-win/" }
-          $sha256 = (Get-FileHash $exe.FullName -Algorithm SHA256).Hash.ToLower()
-          $url    = "https://github.com/${{ github.repository }}/releases/download/${{ needs.setup.outputs.tag }}/$($exe.Name)"
-          "sha256=$sha256" >> $env:GITHUB_OUTPUT
-          "url=$url"       >> $env:GITHUB_OUTPUT
-          Write-Host "Installer: $($exe.Name)"
-          Write-Host "SHA256:    $sha256"
-          Write-Host "URL:       $url"
-
-      - name: Generate chocolateyInstall.ps1 from template
-        shell: pwsh
-        run: |
-          $script = Get-Content chocolatey/tools/chocolateyInstall.ps1.template -Raw
-          $script = $script -replace '{{INSTALLER_URL}}',    '${{ steps.installer.outputs.url }}'
-          $script = $script -replace '{{INSTALLER_SHA256}}', '${{ steps.installer.outputs.sha256 }}'
-          Set-Content chocolatey/tools/chocolateyInstall.ps1 $script
-          Write-Host "Generated install script:"
-          Get-Content chocolatey/tools/chocolateyInstall.ps1
-
-      - name: Stamp version in nuspec
-        shell: pwsh
-        run: |
-          (Get-Content chocolatey/djmanager.nuspec) `
-            -replace '<version>.*</version>', '<version>${{ needs.setup.outputs.version }}</version>' |
-            Set-Content chocolatey/djmanager.nuspec
-
-      - name: Pack Chocolatey package
-        shell: pwsh
-        run: choco pack chocolatey/djmanager.nuspec --out dist-choco/
-
-      - name: Push to Chocolatey.org
-        shell: pwsh
-        run: |
-          $pkg = Get-ChildItem dist-choco\*.nupkg | Select-Object -First 1
-          if (-not $pkg) { throw "No .nupkg found in dist-choco/" }
-          Write-Host "Pushing $($pkg.Name)"
-          choco push $pkg.FullName --source https://push.chocolatey.org --api-key ${{ secrets.CHOCOLATEY_API_KEY }}
+  #chocolatey:
+  #  if: github.ref_name == 'master'
+  #  needs: [setup, create-release]
+  #  runs-on: windows-latest
+  #  steps:
+  #    - uses: actions/checkout@v7
+  #
+  #    - uses: actions/download-artifact@v8
+  #      with:
+  #        name: dist-win
+  #        path: dist-win/
+  #
+  #    - name: Compute installer SHA256 and build download URL
+  #      id: installer
+  #      shell: pwsh
+  #      run: |
+  #        $exe = Get-ChildItem dist-win\*.exe | Select-Object -First 1
+  #        if (-not $exe) { throw "No .exe found in dist-win/" }
+  #        $sha256 = (Get-FileHash $exe.FullName -Algorithm SHA256).Hash.ToLower()
+  #        $url    = "https://github.com/${{ github.repository }}/releases/download/${{ needs.setup.outputs.tag }}/$($exe.Name)"
+  #        "sha256=$sha256" >> $env:GITHUB_OUTPUT
+  #        "url=$url"       >> $env:GITHUB_OUTPUT
+  #        Write-Host "Installer: $($exe.Name)"
+  #        Write-Host "SHA256:    $sha256"
+  #        Write-Host "URL:       $url"
+  #
+  #    - name: Generate chocolateyInstall.ps1 from template
+  #      shell: pwsh
+  #      run: |
+  #        $script = Get-Content chocolatey/tools/chocolateyInstall.ps1.template -Raw
+  #        $script = $script -replace '{{INSTALLER_URL}}',    '${{ steps.installer.outputs.url }}'
+  #        $script = $script -replace '{{INSTALLER_SHA256}}', '${{ steps.installer.outputs.sha256 }}'
+  #        Set-Content chocolatey/tools/chocolateyInstall.ps1 $script
+  #        Write-Host "Generated install script:"
+  #        Get-Content chocolatey/tools/chocolateyInstall.ps1
+  #
+  #    - name: Stamp version in nuspec
+  #      shell: pwsh
+  #      run: |
+  #        (Get-Content chocolatey/djmanager.nuspec) `
+  #          -replace '<version>.*</version>', '<version>${{ needs.setup.outputs.version }}</version>' |
+  #          Set-Content chocolatey/djmanager.nuspec
+  #
+  #    - name: Pack Chocolatey package
+  #      shell: pwsh
+  #      run: choco pack chocolatey/djmanager.nuspec --out dist-choco/
+  #
+  #    - name: Push to Chocolatey.org
+  #      shell: pwsh
+  #      run: |
+  #        $pkg = Get-ChildItem dist-choco\*.nupkg | Select-Object -First 1
+  #        if (-not $pkg) { throw "No .nupkg found in dist-choco/" }
+  #        Write-Host "Pushing $($pkg.Name)"
+  #        choco push $pkg.FullName --source https://push.chocolatey.org --api-key ${{ secrets.CHOCOLATEY_API_KEY }}
 
   # ── Sync dev + bump version after master release ─────────────────────────────
   # Always merges master → dev first so dev has the exact released code,
@@ -193,7 +193,7 @@ jobs:
     permissions:
       contents: write
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
         with:
           ref: dev
           fetch-depth: 0

.gitignore

@@ -165,6 +165,9 @@ env/
 # Sample/test audio files
 samples/
 
+# Reverse-engineering test tracks (generated locally, not for version control)
+reverse-engineering/test-tracks/
+
 # Dev-only downloaded binaries (generated by scripts/download-analyzer.sh)
 build-resources/analysis
 build-resources/analysis.exe

CLAUDE.md

@@ -140,6 +140,27 @@ Audio is served over a local HTTP server (`src/audio/mediaServer.js`) instead of
 
 `--playlist-items "1,3,5"` is passed when the user deselects tracks in the selection step.
 
+### TIDAL Download
+
+`src/audio/tidalDlManager.js` wraps the `tdn` CLI from the [tidal-dl-ng](https://github.com/Radexito/tidal-dl-ng-For-DJ) Python package:
+
+- `findTidalDlPath()` — searches `~/.local/bin`, common platform paths, then falls back to `which tdn`
+- `checkTidalSetup()` — checks binary presence + reads `~/.config/tidal-dl-ng/token.json` for login state
+- `startLogin(onUrl)` — spawns `tdn login` with `NO_COLOR=1 TERM=dumb`, parses `link.tidal.com` URL from stdout via regex, resolves when the process exits 0
+- `downloadTidal(url, outputDir, onProgress)` — saves the tidal-dl-ng `settings.json`, patches `download_base_path` to `userData/tidal_tmp` and `quality_audio` to `HiRes_Lossless`, spawns `tdn dl <url>`, **always restores** the original config in both success and error paths, then scans the output dir for new audio files by mtime
+
+IPC channels: `tidal-check`, `tidal-login`, `tidal-download-url`. Events pushed to renderer: `tidal-progress` (per-line stdout), `tidal-login-url` (device-link URL for browser).
+
+### Top-level navigation
+
+`Sidebar.jsx` has a `MENU_ITEMS` array that drives the top nav. Each item has an `id` string. `App.jsx` receives `selectedPlaylistId` and branches on it:
+
+- `'download'` → `<DownloadView>` (yt-dlp)
+- `'tidal'` → `<TidalDownloadView>`
+- anything else → `<MusicLibrary selectedPlaylist={id}>` (handles both `'music'` and playlist UUIDs)
+
+**Adding a new top-level view**: add entry to `MENU_ITEMS`, add a branch in `App.jsx`, create the view component.
+
 ### Renderer / UI
 
 - Track list uses `react-window` (`FixedSizeList`) for virtualization — `ROW_HEIGHT = 50`, `PAGE_SIZE = 50`
@@ -171,6 +192,17 @@ Handled client-side by `renderer/src/searchParser.js`. Supports field-qualified
 - **Platform-specific test stubs**: `usbUtils.test.js` stubs `process.platform` via `vi.stubGlobal` so Linux-branch tests run correctly on Windows. Use the same pattern for any test that branches on `process.platform`.
 - **Windows path in tests**: when constructing HTTP URLs from OS file paths in tests, convert with `'/' + filePath.replace(/\\/g, '/')` so paths are valid on Windows (e.g. `/C:/path/to/file`).
 
+## GitHub API
+
+`gh` CLI is **not installed** on this machine. Use `git credential fill` to retrieve the stored OAuth token, then call the GitHub REST API directly with `curl`:
+
+```bash
+TOKEN=$(git credential fill <<< $'protocol=https\nhost=github.com' | grep password | cut -d= -f2)
+curl -s -X POST "https://api.github.com/repos/Radexito/DjManager/issues" \
+  -H "Authorization: token $TOKEN" -H "Content-Type: application/json" \
+  -d '{"title":"...", "body":"..."}'
+```
+
 ## Known Issues
 
 - **yt-dlp ffmpeg path**: yt-dlp spawned as subprocess can't find bundled ffmpeg. Pass `--ffmpeg-location <bundled ffmpeg dir>` to the yt-dlp spawn call using `getFfmpegRuntimePath()` from `deps.js`.