stemdeckapp/stemdeck

[!IMPORTANT]
macOS first launch (no code signing yet). After dragging StemDeck to Applications, clear the Gatekeeper quarantine flag or macOS will say the app is damaged:

xattr -dr com.apple.quarantine /Applications/StemDeck.app

Optional: start from a clean slate. To reproduce a true first-run experience, open each path in Finder via the Go menu, then Go to Folder (Shift+Cmd+G), and move the folders to Trash:

• ~/Library/Application Support/StemDeck
• ~/Library/WebKit/app.stemdeck.desktop
• ~/Library/Caches/stemdeck
• ~/Library/Caches/app.stemdeck.desktop

You can also delete ~/Library/Preferences/app.stemdeck.desktop.plist the same way. This is optional; the app will work without it.

What's new in 0.8.0 Alpha 12

A focused fix release for Windows NVIDIA GPU acceleration. No changes for macOS or Docker/self-hosted users.

Windows: NVIDIA GPUs are reliably used again

Two issues could leave a Windows machine with a perfectly good NVIDIA GPU running stem separation on the CPU — several times slower — while Settings → Compute device showed CUDA (NVIDIA) — not available:

• Switching builds no longer strands you on CPU. If you had ever run the CPU build (or a run that fell back to CPU) and then installed the NVIDIA build over the same data folder, the app remembered the old "CPU-only" decision and never re-checked for your GPU. It now re-detects the GPU automatically on the next launch when the installed build changes — no more manually deleting %LOCALAPPDATA%\StemDeck to unstick it.
• The NVIDIA build now always ships CUDA support. The GPU-enabled Windows package is now built to include the CUDA runtime deterministically, so it can't silently regress to a CPU-only build.

If your Windows NVIDIA setup was stuck on CPU, updating to this release fixes it on the next launch. You can confirm under Settings → General → Compute device: it should read Auto (currently: cuda).

Installing

• macOS: drop the .app into Applications and launch (run the xattr command above first).
• Windows: unzip the downloaded .zip, then run StemDeck.exe from the extracted folder. For GPU acceleration, use the NVIDIA zip and make sure nvidia-smi reports your GPU; the CPU zip runs anywhere.
• Linux: download the .tar.gz for your hardware, extract it, and run ./StemDeck. Install the WebKitGTK + GTK runtime prerequisites first (FFmpeg is fetched automatically on first launch):

  sudo apt install libwebkit2gtk-4.1-0 libgtk-3-0
  

  The NVIDIA build additionally needs a working NVIDIA driver such that nvidia-smi reports your GPU (the CUDA runtime itself is bundled -- no separate CUDA toolkit install needed). If you have no NVIDIA GPU, use the CPU-only tarball.
• Docker / Unraid: install "StemDeck" from Unraid Community Applications, or pull ghcr.io/stemdeckapp/stemdeck:edge and map port 8000 plus the /app/jobs and /cache volumes. Add --runtime=nvidia for GPU acceleration. See the README for the full docker run command.