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.8.0 Alpha 3

QR codes for network access

When server mode is enabled in Settings > Advanced, StemDeck now shows a QR code for each local IP address. Scan it with your phone camera and it opens the StemDeck mobile player directly in the browser - no typing required.

• One QR per network interface
• Codes start blurred so a nearby camera does not scan them accidentally; tap any card to reveal
• Each QR encodes the full mobile URL (http://{ip}:{port}/mobile/)

Mobile player improvements

• Faster start. The mobile player no longer waits for the full audio file to download before playback begins. Audio now starts within a few seconds on WiFi.
• Much lower memory usage. Peak RAM for a typical 4-stem track dropped from around 420 MB to around 28 MB, which eliminates crashes on older or lower-memory phones.
• No track length limit. The previous cap (roughly 7 minutes for 4-stem tracks) is gone. Tracks of any length now load and play correctly on mobile.
• OOM crash on Load fixed. Loading a long track on mobile Safari no longer crashes the browser tab.
• Stuck "Preparing audio" fixed. Opening the app with tracks already in the library no longer leaves the mixer stuck in a loading state.
• Play button now shows correct state (paused vs. playing) visually.
• Seek now stays in sync. Dragging the waveform to a new position no longer causes stems to drift out of time with each other.
• Prev/Next track buttons now work and navigate the library correctly.

Development server

• Default port changed from 8000 to 8080 to match the desktop app and settings UI.
• The dev server now binds to 0.0.0.0 by default, making it reachable from phones and other devices on the same network without any extra configuration.

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.

Artifact scan

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

Artifact build

• macOS arm64 and x64 DMGs and runtime packs were built and inspected on a macOS GitHub Actions runner 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 build

• macOS arm64 and x64 DMGs and runtime packs were built and inspected on a macOS GitHub Actions runner before upload.

Artifact scan

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