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.12.1
Bugfix release. Fixes the lead/backing vocal split failing at runtime on shipped builds. No other changes since 0.12.0.
StemDeck is still alpha. A leading 0. means no stability promise.
Lead/backing vocal split: fixed on shipped builds
- The vocal split action introduced in 0.12.0 could fail with "No module named 'audioread'".
librosa 1.0.0dropped itsaudioreaddependency, but the library driving the vocal split still imports it directly. Development and CI never hit this because the lockfile still resolved the olderlibrosa, but the packaging scripts for Docker and the desktop builds install from the project file directly, so they picked up the newlibrosarelease and silently lostaudioread. Only the vocal split was affected; base separation, analysis, and the beat grid were never impacted. librosais now pinned below 1.0, andaudioreadis declared explicitly, matching what the vocal-split library expects. The packaging scripts also now verify the vocal-split dependencies are importable as part of the build, so a broken chain like this fails the build instead of shipping (reported in #407, thank you for the detailed writeup).
Notes on the beat detection model
Unchanged, repeated here for anyone upgrading from an older release:
- 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.