Skip to content

CADENCE v0.6.0

Choose a tag to compare

@askformeal askformeal released this 17 Aug 12:18
· 280 commits to master since this release

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 dice for 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 --dev uses 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 status

All 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.