Skip to content

stemdeckapp/stemdeck

v0.5.0-alpha.3 Breaking

This release includes 2 breaking changes for platform teams planning a safe upgrade.

✓ No known CVEs patched
Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Summary

AI summary

Library data now lives at ~/Documents/StemDeck, automatically migrating from the hidden Application Support folder.

Changes in this release

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

Track stemdeckapp/stemdeck

Get notified when new releases ship.

Sign up free

About stemdeckapp/stemdeck

All releases →

Related context

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]