v0.6.1 — latest release

ferrosonic-ng

A terminal-based Subsonic music client written in Rust. Bit-perfect audio. Gapless playback. Full desktop integration.

View on GitHub Download
$ curl -sSf https://raw.githubusercontent.com/Jamie098/ferrosonic-ng/master/install.sh | sh click to copy
ferrosonic-ng terminal interface showing album browser and audio playback
Features

Everything you need from a terminal music client

🎵

Bit-Perfect Audio

Automatic PipeWire sample rate switching to match source material — 44.1kHz, 48kHz, 96kHz, 192kHz. Original rate restored on exit.

🔗

Gapless Playback

Next track is pre-loaded into mpv's internal playlist for seamless transitions between songs.

🖥️

MPRIS2 Integration

Full desktop media control support — play, pause, stop, next, previous, and seek from your DE's media controls.

🎨

13+ Themes

Monokai, Dracula, Nord, Catppuccin, Tokyo Night, Gruvbox, and more. Create custom themes as TOML files.

📊

Audio Visualizer

Integrated cava visualizer with theme-matched gradient colors. See your music come alive in the terminal.

⌨️

Keyboard & Mouse

Vim-style navigation alongside arrow keys. Clickable tabs, buttons, list items, and progress bar seeking.

Compatibility

Works with any Subsonic-compatible server

Navidrome Airsonic Airsonic-Advanced Gonic Supysonic

Ready to try ferrosonic-ng?

Install in seconds on Arch, Fedora, or Debian/Ubuntu.

Get Started