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 pullcommand 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
.appinto Applications and launch (run thexattrcommand above first). - Windows: unzip the downloaded
.zip, then runStemDeck.exefrom the extracted folder. For GPU acceleration, use the NVIDIA zip and make surenvidia-smireports your GPU; the CPU zip runs anywhere. - Linux: download the
.tar.gzfor your hardware, extract it, and run./StemDeck. Install the WebKitGTK + GTK runtime prerequisites first (FFmpeg is fetched automatically on first launch):The NVIDIA build additionally needs a working NVIDIA driver such thatsudo apt install libwebkit2gtk-4.1-0 libgtk-3-0nvidia-smireports 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:edgeand map port 8000 plus the/app/jobsand/cachevolumes. Add--runtime=nvidiafor GPU acceleration. See the README for the fulldocker runcommand.