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 17
A fix-only release, entirely about exporting. Both issues were reported by @MetalMan1245 against Alpha 15 and 16.
Exports are named after the song
- Stems no longer export as
bass.wav. Every file you export now carries the song name, so several songs' stems can share a project folder without colliding or overwriting each other. (#336)05_Welcome_To_Paradise_Green_Day_Dookie_bass.wav 05_Welcome_To_Paradise_Green_Day_Dookie_vocals.wav - The mix export had the same problem, and worse. It downloaded as
mixdown.wavfor every song, so exporting a few into one folder producedmixdown.wav,mixdown(1).wav,mixdown(2).wav. It is now<Song>_exported_mix.wav, and<Song>_region.wavfor a loop region. - Applies everywhere a file leaves the app: the stems zip, single-stem downloads, loop-region exports, and the MP3 versions of each.
- The per-stem download button now actually saves the file on desktop. It previously handed the stem to your operating system, which opened it in a browser or media player instead of downloading it. It now opens a normal Save dialog.
Export menu no longer gets stuck
- "Export All Stems" stayed greyed out after the first export and stayed that way for every song until you restarted the app. Any export triggered it, not just the stems zip. Desktop builds only, which is why it survived Alpha 15 and 16. (#335)
- The button no longer claims to be done before it is. It used to reset after a fixed 1.2 seconds regardless of how long the export really took, so on a large zip it reported success while the file was still being written, and a failed export looked exactly like a successful one. It now waits for the real thing and tells you when a save fails.
- No more phantom "Exporting..." when there is nothing to export.
- A failed export now offers a plain Dismiss instead of a "Try again" button that sent you to the URL import box.
Notes on the beat detection model
Unchanged from Alpha 16, repeated here for anyone upgrading from Alpha 15 or earlier:
- The first time you use the click track, StemDeck downloads a 77 MB beat-detection model (MIT licensed, code and weights). It is cached alongside the Demucs models, so this happens once.
- If that download is unavailable, for example on a machine with no internet, detection falls back to the classic librosa tracker automatically. The click still works; it is just more likely to pick half or double tempo on fast material, which
/2andx2correct. - Known limitation: tracks whose time signature changes bar to bar, such as odd-time progressive material, get a usable steady pulse but the bar accents will not follow the written meter. No current beat tracker handles that automatically. The grid editor is the way to fix it by hand.
- Tracks with no drums fall back to detecting on the full mix and are less reliable.
Installing
- macOS: drop the
.appinto Applications and launch (run thexattrcommand above first). - Windows: unzip the downloaded
.zip, then runStemDeck.exefrom the extracted folder. For GPU acceleration, use the NVIDIA zip and make surenvidia-smireports your GPU; the CPU zip runs anywhere. - Linux: download the
.tar.gzfor your hardware, extract it, and run./StemDeck. Install the WebKitGTK + GTK runtime prerequisites first (FFmpeg is fetched automatically on first launch):
The NVIDIA build additionally needs a working NVIDIA driver such thatsudo apt install libwebkit2gtk-4.1-0 libgtk-3-0nvidia-smireports your GPU. You do not need to install the CUDA toolkit; StemDeck downloads the CUDA runtime it needs on first launch (a one-time download of roughly 2.5 GB). 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:edgeand map port 8000 plus the/app/jobsand/cachevolumes. Add--runtime=nvidiafor GPU acceleration. See the README for the fulldocker runcommand.