termusic

termusic is a terminal music and podcast player written in Rust. It was started as a rewrite of the Go player GOMU to avoid data race problems. It has a TUI frontend that talks to a separate server over a protobuf-based protocol, and it includes a built-in tag editor and a podcast database.

Playback is handled by one of three backends. The default is rusty, which is based on Symphonia. MPV and GStreamer backends can be enabled with the mpv and gst features. The README gives a per-backend support matrix covering MP4/M4A, MP3, OGG, FLAC, ADTS, WAV/AIFF, CAF and MKV/WebM containers. It also covers the AAC, MP3, FLAC, Vorbis, Opus, ADPCM and PCM codecs. Opus in the rusty backend needs the rusty-libopus feature. The rusty-soundtouch feature enables SoundTouch as the speed modifier. MPRIS media control is supported through D-Bus on Linux.

Tracks can be downloaded from sources such as YouTube, NetEase, Migu and KuGou using yt-dlp, with ffmpeg for post-processing. Album covers can be shown inside the terminal with the cover feature, or through an Ueberzug implementation with cover-ueberzug. Configuration lives in server.toml and tui.toml, plus a themes/ directory, under ~/.config/termusic/ on Linux, ~/Library/Application Support/termusic/ on macOS and %APPDATA%\termusic\ on Windows. It is aimed at users who want a local, terminal-based music and podcast library on Linux, macOS or Windows.