Skip to content

README.md

Latest commit

 

History

History
88 lines (59 loc) · 2.21 KB

README.md

File metadata and controls

88 lines (59 loc) · 2.21 KB

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