github stemdeckapp/stemdeck v0.8.0-alpha.17
0.8.0 Alpha 17

latest releases: v0.18.1, v0.18.0, v0.17.3...
one month ago

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.wav for every song, so exporting a few into one folder produced mixdown.wav, mixdown(1).wav, mixdown(2).wav. It is now <Song>_exported_mix.wav, and <Song>_region.wav for 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 /2 and x2 correct.
  • 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 .app into Applications and launch (run the xattr command above first).
  • Windows: unzip the downloaded .zip, then run StemDeck.exe from the extracted folder. For GPU acceleration, use the NVIDIA zip and make sure nvidia-smi reports your GPU; the CPU zip runs anywhere.
  • 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. 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:edge and map port 8000 plus the /app/jobs and /cache volumes. Add --runtime=nvidia for GPU acceleration. See the README for the full docker run command.

Don't miss a new stemdeck release

NewReleases is sending notifications on new releases.