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

Upgrading from alpha.9 or earlier? If after installing you still see an old version or are missing recent features, clear the cached runtime once and relaunch:

rm -rf ~/Library/Application\ Support/StemDeck/runtime ~/Library/Application\ Support/StemDeck/runtime.old

What's new in 0.7.0 Alpha 17

Linux support (new)

• Portable Linux builds. StemDeck now ships portable .tar.gz packages for Linux x86_64 in two variants, each bundling a self-contained Python runtime (PyTorch + Demucs) alongside the desktop app — extract and run ./StemDeck, no toolchain required. (#220)
  • StemDeck-Linux-x64.tar.gz — CPU-only (smaller; runs anywhere).
  • StemDeck-Linux-x64.NVIDIA.tar.gz — NVIDIA/CUDA (CUDA-enabled PyTorch baked in; uses an NVIDIA GPU, falls back to CPU when none is present).
• Built and ClamAV-scanned in CI before upload, matching the Windows and macOS release pipelines.

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 runtime prerequisites first — StemDeck links your system's WebKitGTK and calls ffmpeg from PATH:

  sudo apt install ffmpeg 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.

Artifact scan

• The Linux portable packages (CPU and NVIDIA) were scanned with ClamAV in CI before upload.

Artifact scan

• Windows portable packages were scanned with ClamAV in CI before upload.

Artifact scan

• The Linux portable packages (CPU and NVIDIA) were scanned with ClamAV in CI before upload.

Artifact scan

• The Linux portable packages (CPU and NVIDIA) were scanned with ClamAV in CI before upload.

Artifact scan

• Windows portable packages were scanned with ClamAV in CI before upload.