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 ÔÇö fresh-install cleanup. To reproduce a true first-run with no leftover state from earlier builds:

ÔÜá´©Å rm -rf is permanent and cannot be undone. If you're not comfortable running terminal commands, use Finder instead: open each path via Go ÔåÆ Go to Folder (ÔçºÔîÿG) and move the folders to Trash manually.

rm -rf ~/Library/Application\ Support/StemDeck
rm -rf ~/Library/WebKit/app.stemdeck.desktop
rm -f  ~/Library/Preferences/app.stemdeck.desktop.plist
rm -rf ~/Library/Caches/stemdeck ~/Library/Caches/app.stemdeck.desktop

This is optional ÔÇö the app will work without it.

What's new in 0.7.0 Alpha 4

Reliability

• Fixed choppy audio on Safari / the macOS desktop app. Playback no longer streams a separate audio element per stem (which underran WKWebView's buffers and stuttered). Stems now play sample-accurately with no dropouts or inter-stem drift. (#165)

Architecture

• New Web Audio decode-and-mix playback engine. Each active stem is decoded once and mixed on a single audio clock ÔÇö zero streaming connections during playback, identical behavior across Safari, the desktop app, and Chrome. Per-stem gain boost above unity now works. A memory guard falls back to streaming for very long full-stem tracks. (#165)

Library

• Edit Library ÔÇö a new window from the Settings button lists every track in your library with its name, source (YouTube / SoundCloud / local file), and location (imported file or URL), in a scrollable list. (#168)
• Out-of-sync detection ÔÇö tracks whose audio is no longer on disk (e.g. cleared after the 24h job retention) are flagged in red, with a count shown at a glance. (#168)
• Sync again ÔÇö reconciles your library with the backend and automatically re-downloads + re-separates any out-of-sync tracks from their original source to restore them. (Local-file imports can't be auto-restored and stay flagged for manual re-upload.) (#168)

UI

• Transport buttons now show their state in color ÔÇö Play turns green while playing, Stop turns red when stopped, Loop turns blue while looping. (#166)

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.

Artifact build

• macOS arm64 and x64 DMGs and runtime packs were built and inspected on a macOS Woodpecker agent before upload.

Artifact scan

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