Spruce

Browse albums and playlists, build a queue, and control playback without leaving the terminal.

Spruce gives a self-hosted Jellyfin music library a keyboard-first interface and uses mpv for playback.

terminal

$ go install github.com/Thelost77/spruce@latest

# connect to Jellyfin
$ spruce

What works now

Your music, close to the keyboard

Spruce covers browsing, queue building, playback, and the controls needed for everyday listening.

Move through albums, tracks, libraries, and playlists without giving up your terminal workflow.

Filter and fuzzy-search the collection, then manage the queue with shuffle and repeat modes.

Play through mpv, report progress to Jellyfin, set a sleep timer, and use desktop MPRIS controls.

Edit metadata and configure keys, colors, playback speed, and the seek interval.

Install

Spruce connects to an existing Jellyfin server and relies on mpv for audio playback.

go install github.com/Thelost77/spruce@latest

Linux is the primary platform. macOS is cross-compiled but not fully runtime-tested. Windows is not supported.