Skip to content

Releases

CASCADE v0.58.0

Choose a tag to compare

@askformeal askformeal released this 13 Oct 13:06

CASCADE v0.58.0

The content of v0.57.0 is also included in this release, because I was too lazy to make a release for it.

What's new

GUI

  • A pop-up window was added and lets you start and reboot the backend from the GUI, with continue-last and development mode options available.

  • A reverse playback button

  • Prettified - with customizable fonts and more.

  • Artist is shown in the playlist section, and the playlist can be filtered by artist.

  • Double-click a lyric line to jump to that position.

Backend

  • Sortable playlist - you can now reorder songs in a playlist yourself.

  • lib lyric fetch runs in the background and reports its result through notifies - no more timeouts!

  • Request rate - check it out through GUI or CLI.

CLI

  • Short mode to display song information concisely.

  • List of songs are printed one by one - just like git! (actually not just like, but you got the idea)

  • Some color.

  • Command aliases.

  • Commands to manage the order of a playlist.

Fixed

  • The portable build silently missed dependencies requests, urllib3, six and pycparser.

CASCADE v0.56.1

Choose a tag to compare

@askformeal askformeal released this 04 Oct 13:31

CASCADE v0.56.1

Command-Line Audio Stream Capture And Decoding Engine

It's been a very long time since the last release, and I have lost track of what has changed. However, I'm 99.9% sure nobody is really using this thing, so whatever.

What's worth mentioning in this release

Name changed

The whole project was renamed from "CADENCE" to "CASCADE", as I found out the old one collides with another music player, even though their version of the name isn't nearly as cool as mine.

TODO: buy their company and get the name back.

Frontends

Four new control interfaces have been added, including:

  • A system tray icon
  • A floating lyric board
  • A TUI dashboard
  • A GUI made with tkinter (regardless of the "Command-line" in the software's name)

There's also a new GUI for modifying configurations.

Configuration

A TOML configure file is added, which you can modify with the CLI or a GUI.

Lyric

This is my personal favorite. Real-time lyrics are added and can be fetched from local or online lyric sources, which you don't even have to set up.

Pluggable audio engine

Now you can switch between two audio engines: VLC for more supported file formats or miniaudio for better portability.

Humanized documents

A human being (aka me) has taken over the writing of most of the documents. README has been rewritten. Some others have not.

Lots of other stuff

Like I said, I lost track of the updates I made and don't want to bother to dig the git history. So if you are interested please check the CHANGELOG, but be warned it was maintained by an AI until very recently.

Installation

Requires Python 3.12+.

pip install git+https://github.com/askformeal/CASCADE.git

cascade start    # start the backend
cascade gui      # the GUI frontend
cascade --help   # everything else

CADENCE v0.6.0

Choose a tag to compare

@askformeal askformeal released this 17 Aug 12:18

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.