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 15
OGG and Opus support
- Import OGG and Opus files. Drop an
.ogg(Vorbis or Opus) or.opusfile onto the import bar — no need to convert first. Requested in #330. (#331) - Export as OGG. The export panel gains an OGG option (Vorbis, ~192 kbps — the same quality tier as the MP3 export) for the mix, loop-region, and stems ZIP downloads. (#331)
- Mobile fix. The phone UI's file picker already listed
.oggbut the server rejected it with an error — that mismatch is gone. (#331)
Housekeeping
- CI dependency updates (GitHub Actions). No functional changes beyond the above — if you don't need OGG/Opus, there is no urgency 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. You do not need to install the CUDA toolkit — StemDeck downloads the CUDA runtime it needs on first launch (a one-time download of roughly 2.5 GB). 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.