Skip to content

dalposenrico/backstage

Repository files navigation

Backstage

A fast, minimal macOS app for browsing and playing your music demo exports.

Built for producers who keep their Ableton/Logic/DAW exports in a folder tree and want to quickly listen back, compare versions, and stay organised — without leaving the desktop.


Install

  1. Download the latest Backstage.zip from Releases
  2. Unzip → drag Backstage.app to /Applications
  3. First launch: right-click → Open to clear the macOS security prompt (ad-hoc signed)

Requires macOS 14 Sonoma or later.


Features

  • Folder tree browser — mirrors your music folder exactly; expand/collapse with one click
  • Instant search — filters all projects as you type
  • Smart sorting — by recently edited, date added, or alphabetically (persisted between sessions)
  • Playback controls — play/pause, next/prev track, keyboard shortcuts
  • Finder colour tags — automatically shows the tags you've already set in Finder
  • Reveal in Finder — hover any project to open it straight from the app
  • Full state persistence — reopens with the same project selected, same folders open, same sort order
  • Automatic update notifications — a small banner appears in the sidebar when a new release is available
  • Click [Backstage] to open Settings

Building from source

Requires Xcode command-line tools and Swift 5.9+.

git clone https://github.com/dalposenrico/backstage.git
cd backstage
swift build

To produce a distributable .app:

./build-app.sh

This builds a release binary, assembles Backstage.app, and ad-hoc signs it.


Keyboard shortcuts

Action Shortcut
Play / Pause Space
Next track ⌘ →
Previous track ⌘ ←
Open music folder ⌘ O
Refresh library ⌘ R
Settings ⌘ , or click [Backstage]

Releasing a new version

# 1. Bump version in Sources/demos/Info.plist
# 2. Commit and tag
git add -A && git commit -m "v1.1"
git tag v1.1
git push && git push --tags

GitHub Actions builds the app and publishes it to Releases automatically.


Roadmap

See ROADMAP.md for planned features.


License

MIT

About

Minimal macOS music demo player for producers

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors