stemdeckapp/stemdeck

[!IMPORTANT]
macOS users run this after installing:

xattr -dr com.apple.quarantine /Applications/StemDeck.app

macOS Gatekeeper will block the app on launch without this step. Proper code signing is planned for a future release.

Optional: clean up a previous install before running

⚠️ rm -rf is permanent and cannot be undone. If you're not comfortable running terminal commands, use Finder instead: open each path in Finder via Go → Go to Folder (⇧⌘G) and move the folders to Trash manually.

If you want a fully fresh start (clears stored library, runtime cache, and preferences):

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 1

SoundCloud support, instant waveform rendering, and smarter library track handling.

New Features

• SoundCloud support — paste any soundcloud.com, www.soundcloud.com, or on.soundcloud.com link and StemDeck will download and separate it just like a YouTube track. Tracks are labelled "SoundCloud" with "Compressed (MP3)" quality in the library.
• Instant waveform rendering from pre-computed peaks — waveforms now appear immediately when you click a library track, before any audio is ready to play. The pipeline pre-computes 1500 [min, max] peak pairs per stem at the end of separation and caches them as peaks.json. The frontend fetches this small file on load and renders overview and footer waveforms in milliseconds. Old library tracks without peaks.json fall back gracefully to the previous client-side decode path.
• Unavailable tracks shown clearly in library — if a track's audio files are no longer on the server (after a reinstall, data migration, or fresh dev server), the library item is now greyed out with a grey status dot. Clicking it surfaces a clear message: "This track's audio is no longer available. Re-upload to restore it." Previously the UI would silently do nothing.

Setup UX

• Connectivity feedback during setup — warns after 30 s of no download progress; escalates after 60 s with an actionable message.
• Fix: PowerShell resolved by absolute path on Windows — setup no longer fails when PowerShell is not on PATH. Closes #130.
• Fix: friendlier error messages for known setup failures — maps CUDA install failure patterns to user-friendly guidance. Closes #132.

Installing

Drop the new .app into your Applications folder and launch. No manual migration steps required.

Artifact build

• macOS arm64 and x64 DMGs and runtime packs were built and inspected before upload.

Artifact scan

• Windows portable packages 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 Woodpecker agent before upload.