Lyrion Music Server in your terminal.

A fast, keyboard & mouse driven terminal UI for Lyrion Music Server, written in Rust. Browse and search your music library, internet radio and streaming apps — with inline album art and an adaptive accent color.

Build Status Crates.io Version License Crates.io Downloads GitHub Downloads
lyrtui
lyrtui demo

Runs natively on

Linux
macOS
Windows

Everything, in the terminal

Control playback across multiple players with sync and global-volume support, and enjoy a now-playing panel with inline album art that adapts the UI's accent color to the current cover. Full mouse support throughout — while every action also has a keyboard shortcut.

🎵

Browse your library

Artists → Albums → Tracks, or jump straight to All Tracks. Recently Played Artists and New Music for quick access.

🖼️

Cover-art thumbnails

Real album covers in every list. Artists show a representative cover; folders show their first track's art, descending through subfolders.

🔍

Search & local filter

Search artists, albums, tracks and playlists. Hit / to instantly narrow whatever list you're already viewing.

📻

Radio & streaming apps

Browse and play internet radio (TuneIn) and installed Lyrion apps — Spotify, Deezer, Bandcamp — with full hierarchical navigation.

Multi-player & sync

Switch between players, toggle power, and open a sync modal to join or leave sync groups. Global volume adjusts every player at once.

🎨

Adaptive theme

The accent color is auto-generated from the current track's album art and applied to the progress bar, borders and scrollbars.

🖱️

Full mouse support

Click to navigate, play, seek the progress bar, adjust volume, manage queues, sync players and edit settings — all clickable.

📡

Auto-discovery

Finds your Lyrion server on the local network via UDP broadcast on startup, and reconnects gracefully when it goes away.

Fast on huge libraries

Only visible rows are built each frame and thumbnails are pre-encoded off the draw path — navigation stays fluid on thousands of tracks.

Screenshots

Click any image to open the gallery — use the arrows, swipe, or ← / → keys.

lyrtui screenshot 1 lyrtui screenshot 2 lyrtui screenshot 3 lyrtui screenshot 4 lyrtui screenshot 5 lyrtui screenshot 6 lyrtui screenshot 7 lyrtui screenshot 8

Install

A running Lyrion Music Server (default localhost:9000) is all you need. A Nerd Font and an image-capable terminal are optional bonuses.

cargo

cargo install lyrtui

Homebrew

brew install hjelev/tap/lyrtui

From source

git clone https://github.com/hjelev/lyrtui
cd lyrtui
cargo build --release

Releases

Grab a prebuilt binary or the installer from the releases page — it drops lyrtui into your PATH.

Then just run lyrtui. On first launch it broadcasts a UDP discovery packet to find your server; press c any time to configure host, port and more.

Keyboard shortcuts

jMove down
kMove up
EnterlSelect / open action menu
EschBack / focus sidebar
SpacePlay / pause
npNext / previous track
+-Volume up / down
sToggle shuffle
rCycle repeat mode
aAdd selected item to queue
dDelRemove from queue
xClear queue
/Filter the current list
mMute / unmute
tToggle player power
19Jump to sidebar section
cOpen server configuration
`Toggle Big Art Mode
qCtrl-cQuit