Classfi - A Simple Classical Music Player

Listen to classical music in your terminal with (almost) no fuss. Heavily inspired by lowfi, but for classical music from Classical California streams.

Use

classfi

Yup, thats it.

You want more? Ok then.

CLI Options:

$ classfi --help
Classical music in your terminal.

Usage: classfi [OPTIONS]

Options:
  -s, --station <STATION>  Initial Station [possible values: classical-california, ultimate, great-escape, nuestra-musica-en, nuestra-musica-es, arcade, americana, christmas, glissando]
  -t, --theme <THEME>      Color Theme Name
  -v, --verbose...         Increase logging verbosity
  -q, --quiet...           Decrease logging verbosity
  -h, --help               Print help
  -V, --version            Print version

Player Commands:

(p)lay/pause
(+/-) volume adjust
(s)tation selector
(q)uit

Install / Prereqs

Ah, the fuss. In order to install, you need to first install libmpv. That probably looks something like:

sudo apt install libmpv   # Debian and friends
sudo dnf install mpv-libs # Fedora and friends
sudo pacman -S mpv        # Arch and friends
brew install mpv          # MacOS

Or from mpv.io

After that, you can download it from the release page or build it yourself with

# macOS only: set library paths so the build can find mpv
export C_INCLUDE_PATH="/opt/homebrew/include:$C_INCLUDE_PATH"
export LIBRARY_PATH="/opt/homebrew/lib:$LIBRARY_PATH"
export PKG_CONFIG_PATH="/opt/homebrew/lib/pkgconfig:$PKG_CONFIG_PATH"

cargo install classfi

Themes

classfi supports color themes, using Terminal Color Architecture. It has about a dozen themes built-in, and will use your TCA default if configured. To install a few hundred more themes:

cargo install tca-cli
tca init --all
tca list # See all the installed themes
tca set default "Tokyo Night Dark" # Or whichever you prefer

Full instructions for tca-cli on crates.io.

Roadmap

• more/better installer options
  • brew
  • cargo binstall
• cache station URLs to disk
• Stream info (file type, bitrate, etc)
• better player state reporting/tracking
• media key handling
• one line UI
• alternate versions with different sources

License

Copyright (c) Adam Milner carmiac@gmail.com

This project is licensed under the GPLv3 (LICENSE or https://www.gnu.org/licenses/gpl-3.0.html)