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 9

Choose the export sample rate

Exported mixes and regions were always rendered at 44.1 kHz — fine for most software, but some hardware samplers only accept a specific rate and would reject the file. Settings → Export now has a Sample rate control (22.05 / 32 / 44.1 / 48 kHz) that applies to every WAV, FLAC, and MP3 export.

Settings reorganized into General / Network / Export

The Settings panel's tabs were cleaned up to group things by what they actually control:

• General — max track length, compute device, out-of-sync tracks
• Network — network availability + QR codes, and Port (moved here from Advanced)
• Export — the new sample rate control, and MP4 video quality (moved here from General)

The dialog is now a fixed size across all three tabs, so switching tabs no longer resizes the window.

Fixes

• The Port field in Settings now shows the port StemDeck is actually running on, instead of a stale saved value that could disagree with reality.
• In server mode, the network-access toggle now correctly shows as on (read-only) with an inline note explaining it's controlled by server configuration, rather than looking editable and then silently rejecting changes.

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.
• 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.

Artifact scan

• Windows portable packages (CPU + NVIDIA) scanned with ClamAV in CI before upload.
• Linux portable packages (CPU + NVIDIA) scanned with ClamAV in CI before upload.

Artifact build

• macOS arm64 and x64 DMGs and runtime packs built and inspected on a macOS runner before upload.
• Windows portable ZIPs (CPU + NVIDIA) built on a Windows runner.
• Linux portable tarballs (CPU + NVIDIA) built on a Linux runner.