This release includes 2 breaking changes for platform teams planning a safe upgrade.
✓ No known CVEs patched in this version
Summary
AI summaryLibrary data now lives at ~/Documents/StemDeck, automatically migrating from the hidden Application Support folder.
Changes in this release
| Type | Severity | Summary | CVE |
|---|---|---|---|
| Feature | Medium |
Library and stems now saved to ~/Documents/StemDeck. Library and stems now saved to ~/Documents/StemDeck. Source: granite4.1:8b-q6_K@2026-05-20 Confidence: high |
— |
| Feature | Medium |
Ubuntu 26.04 / Python 3.14 compatibility ensured. Ubuntu 26.04 / Python 3.14 compatibility ensured. Source: granite4.1:8b-q6_K@2026-05-20 Confidence: high |
— |
| Performance | Medium |
WebKit stale-data eliminated automatically on macOS. WebKit stale-data eliminated automatically on macOS. Source: granite4.1:8b-q6_K@2026-05-20 Confidence: low |
— |
| Bugfix | Medium |
Docker pip timeout extended for slow connections. Docker pip timeout extended for slow connections. Source: granite4.1:8b-q6_K@2026-05-20 Confidence: low |
— |
Full changelog
## What's new in 0.5.0 Alpha 3
Library and stems now saved to ~/Documents/StemDeck
Your entire library ÔÇö metadata, folders, mix state, stem preferences, and extracted audio files ÔÇö now lives in ~/Documents/StemDeck/. This makes it visible in Finder, eligible for iCloud Drive backup, and means it survives any app reinstall or upgrade without any action on your part.
Previous versions stored everything inside ~/Library/Application Support/ which is hidden from Finder and wiped on reinstall.
WebKit stale-data eliminated automatically on macOS
Every upgrade used to leave stale cached state in ~/Library/WebKit/app.stemdeck.desktop, causing inconsistent behavior that required manually deleting three system folders. That folder is now cleared automatically on version change ÔÇö no user action needed, ever.
A two-phase bootstrap ensures no data is lost during the transition: the first launch after upgrading migrates your existing library into the new location, then marks it safe. Subsequent upgrades clear WebKit freely.
Ubuntu 26.04 / Python 3.14 compatibility
Ubuntu 26.04 ships Python 3.14 by default, but PyTorch 2.6.0 doesn't have wheels for it yet. run.sh now explicitly targets Python 3.12, and pyproject.toml enforces <3.14 so the installer never selects an incompatible interpreter.
Docker: pip timeout extended for slow connections
The Docker build was timing out mid-download of the 766 MB torch wheel on slower connections. pip install now runs with --timeout 300 to handle this gracefully.
Installing
Drop the new .app into your Applications folder and launch. Your library will be migrated automatically on first launch ÔÇö no manual steps required.
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.
Breaking Changes
- Moved entire library (metadata, folders, mix state, stem preferences, audio files) from `~/Library/Application Support/` to `~/Documents/StemDeck/`
- Previous storage location is now obsolete and will be cleared on upgrade
Weekly OSS security release digest.
The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.
No spam, unsubscribe anytime.
Share this release
About stemdeckapp/stemdeck
All releases →Related context
Related tools
Earlier breaking changes
- v0.6.0-alpha.1 Moves library and stems storage from `~/Library/Application Support/` to `~/Documents/StemDeck/`.
Beta — feedback welcome: [email protected]