Repository navigation
CADENCE v0.6.0
CADENCE v0.6.0
Command-line Audio Decoding Engine with Navigation and Continuous Execution
A CLI music player that lives in the terminal. Powered by VLC, controlled over a local socket, with your library persisted in SQLite.
Features
- Play anything — a single song, a playlist, or your entire library, straight from the command line
- Library management — metadata (name/artist/album) auto-extracted from file tags, aliases, playlists, directory scanning
- Pick up where you left off — playback position is memorized and resumed when you come back to a song
- Navigation — prev/next with wraparound, switch by number, jump by percentage, restart, and
dicefor a random song - Playback modes — shuffle, loop mode (replay the current song), play-all
- Volume & mute — no reaching for the system volume
- Hotkey frontend — control playback from anywhere via media keys
- Dev mode (new in 0.6.0) —
cadence start --devuses a separate development database, so you can experiment freely without touching your real library
Installation
Requires Python 3.12+ and VLC.
pip install .Then:
cadence start
cadence open "Some Song"
cadence statusAll communication between the CLI and the backend happens over a length-prefixed JSON socket protocol — see docs/protocol.md.
License
MIT License, because using it is your loss.