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 13

In-app update details. When a newer release is available, StemDeck now shows you what changed and exactly how to get it.

See what's new without leaving the app

The "New release available" notification (under the bell icon) is now clickable. Opening it shows the full release notes for the new version, plus a one-click way to get it that matches how you run StemDeck:

• Desktop (macOS, Windows, Linux): a Download button that points at the correct build for your machine automatically, including the right NVIDIA or CPU variant on Windows and Linux.
• Docker / self-hosted: the exact docker pull command for the new version, so you can update your container and restart.

Nothing auto-updates and nothing is installed for you. StemDeck just surfaces the release and the right download, and you decide when to update.

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.