Jellyfin

Use cliamp to stream music from a Jellyfin server through Jellyfin's authenticated HTTP API. The provider pane shows music libraries as a flat album list, like the Plex provider.

Quick start: Run cliamp setup. Select API-token or username+password authentication. The TUI validates /Users/Me and writes the [jellyfin] block. Manual steps follow.

Prerequisites

Configuration

Add a [jellyfin] section to ~/.config/cliamp/config.toml:

[jellyfin]
url = "https://jellyfin.example.com"
user = "finamp"
password = "your_password_here"
# optional alternatives:
# token = "xxxxxxxxxxxxxxxxxxxx"
# user_id = "00000000000000000000000000000000"
Key Description
url Base URL of your Jellyfin server
user Jellyfin username for password-based login
password Jellyfin password for password login
token Optional Jellyfin API token. Use it instead of a username and password.
user_id Optional Jellyfin user id to skip discovery

Usage

After configuration, Jellyfin appears in the provider list.

To start cliamp with Jellyfin selected:

cliamp --provider jellyfin

Or set the provider in configuration:

provider = "jellyfin"

The provider shows a flat album list:

Artist - Album Title (Year)

Select an album to load its tracks.

How it works

cliamp authenticates with a configured token or the supplied username and password. It resolves the active Jellyfin user, lists music library views, gets albums from those views, then gets tracks for the selected album. Playback uses Jellyfin's authenticated audio endpoint and streams through the cliamp HTTP pipeline.

Known limitations