smyx

A lean, beautiful terminal Navidrome / OpenSubsonic player in Rust. Features album-art-reactive theming, a live audio visualizer, and synced lyrics.

Requires a Navidrome or OpenSubsonic compatible server. Works on Linux, macOS, and Windows. Album art is crispest on Kitty, WezTerm, or foot.

Install

Install via Cargo (all platforms — Linux, macOS, Windows):

cargo install smyx

Or build from source:

git clone https://github.com/ayanchavand/Smyx.git
cd Smyx
cargo install --path .

Get started

Run smyx in your terminal:

smyx

On first launch, an interactive login modal will prompt you for your Navidrome / OpenSubsonic server URL, username, and password.

Configurations are automatically saved to ~/.config/smyx/navidrome.toml (or %USERPROFILE%\.config\smyx\navidrome.toml on Windows).

Keys

⇥ / [ ]    switch section        ⇧⇥       switch view
↑↓ / j k   move                  ⏎        play / open
/          search                a        actions
space      play · pause          n / b    next · prev
← →        seek                  s        shuffle
+ / -      volume                R        repeat
o          sort                  r        reload
t          theme                 q        quit

Media keys (Play/Pause, Stop, Next, Prev, Volume) work when the terminal is focused. Mouse works too: click tabs, click a track, double-click to play.

Credits

smyx is a fork of Myx, which was originally a TUI for Spotify client.

Built on ratatui, rodio, and rustfft. Visual language inspired by noodle. See NOTICE.

License

MIT, see LICENSE.