百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
J

jellyfin-tui

> 编程语言
开源

适用于终端的现代音乐流式传输客户端

567 stars0 点赞0 次浏览
访问官网GitHub

工具介绍

适用于终端的现代音乐流式传输客户端

jellyfin-tui

Jellyfin-tui is a music streaming client for the Jellyfin media server. Inspired by CMUS and others, its goal is to offer a self-hosted terminal music player with all the modern features you need.

Features

  • stream your music from Jellyfin
  • sixel cover image, courtesy of ratatui-image
  • lyrics with autoscroll (Jellyfin > 10.9)
  • custom themes, color extraction from album art + smooth interpolated transitions + tinted variants
  • Spotify-like double queue with order control, etc.
  • full offline mode with metadata caching, track downloads, background updates and slow network fallback
  • Last.fm scrobbling, you need jellyfin-plugin-lastfm
  • multi-library support
  • vim-style keybindings
  • MPRIS integration
  • playlists (play/create/edit/reorder), select mode for bulk add/remove
  • transcoding, shuffle, repeat modes, the works
  • remote control from the Jellyfin web UI or any other Jellyfin client
  • vertical layout for narrow terminals, resize panes with Ctrl+Up/Down
  • works over ssh (and tmux)
  • sleep timer
  • fast and just kind of nifty really

Also works with Navidrome's experimental Jellyfin API (setup).

If there is a feature you'd like to see, please open an issue :)

Screenshots

Installation

Pre-built binaries

Pre-built binaries for Linux and macOS are available on the releases page. Download the binary for your platform, make it executable, and place it somewhere on your PATH.

Arch Linux

jellyfin-tui is available as a package in the AUR. You can install it with your preferred AUR helper. Example:

bash
paru -S jellyfin-tui

Nix

jellyfin-tui is available as a package in Nixpkgs.

Alpine Linux

jellyfin-tui is available as a package in the Alpine Linux community repository.

Other Linux

Jellyfin-tui depends on libmpv2 (audio playback) and sqlite3 (offline caching), both of which should be available in your distribution's package manager. On Debian/Ubuntu based systems, you may need to install libmpv-dev and libssl-dev as well for building.

bash
# If you're new to rust:
# install rust from https://rustup.rs and make sure ~/.cargo/bin is in your PATH (add this to ~/.bashrc or ~/.zshrc etc.)
export PATH=$PATH:~/.cargo/bin/

# Arch
sudo pacman -S mpv sqlite
# Ubuntu/Debian
sudo apt install mpv libmpv-dev sqlite3 libssl-dev
bash
# clone this repository
git clone https://github.com/dhonus/jellyfin-tui
cd jellyfin-tui

# optional: use latest tag
git fetch --tags
git checkout $(git tag | sort -V | tail -1)

cargo install --path .

macOS

bash
brew install mpv
git clone https://github.com/dhonus/jellyfin-tui
cd jellyfin-tui
# add exports to your shell profile (~/.zshrc etc.)
export LIBRARY_PATH="$LIBRARY_PATH:$(brew --prefix)/lib"
export PATH=$PATH:~/.cargo/bin/
cargo install --path .

Configuration

When you run jellyfin-tui for the first time, it will guide you through creating a configuration file. You can authenticate using either username/password, password file, or Jellyfin Quick Connect. Each of these options then uses locally stored auth tokens for future logins.

The program prints the config location when run. On Linux, the configuration file is located at ~/.config/jellyfin-tui/config.yaml. Feel free to edit it manually if needed.

…

Navidrome

Since v0.64.0 Navidrome ships an experimental Jellyfin API. It's off by default; enable it with Jellyfin.Enabled = true in navidrome.toml (or ND_JELLYFIN_ENABLED=true), as described in Navidrome's docs. Then point jellyfin-tui at https:///jellyfin, like the example server above.

Everything works except "Run a Jellyfin task" (an admin API, not a music one). Untested beyond that, so open an issue if something misbehaves.

Theming

Click to reveal theming documentation

Jellyfin-tui comes with several built-in themes in both light and dark variants. You can switch between themes in the global popup.

You can also define your own custom themes in the config by selecting a base theme and overriding any colors you want. Custom themes are hot-reloaded when you save the config file.

accent_color file

The accent color gets written to a file each time it changes. It lives in the data directory (for example ~/.local/share/jellyfin-tui/accent_color on Linux) and contains the hex RGB color. Use it with pywal or similar tools.

Color formats

  • "#rrggbb" (hex)
  • "red","white","gray" (named)
  • "auto" → uses the extracted accent from album art
  • "tinted" → keeps the inherited base color but blends it slightly towards the album accent (strength controlled by tint_strength)
  • "tinted #rrggbb" / "tinted:#rrggbb" → same as above but with an explicit base color
  • "none" → disables optional backgrounds (background,album_header_background only)

Overridable keys

Full list of keys

Key Description
background Main background color. Optional — none uses terminal bg.
foreground Primary text color.
foreground_secondary Secondary text (artists in player, ...).
foreground_dim Dimmed text for less important UI elements.
foreground_disabled Disabled or unavailable UI elements, disliked tracks.
section_title Titles of sections like Albums, Artists, etc.
accent Fallback color for "auto", applied when album art isn't available or if auto_color is disabled.
border Normal border color.
border_focused Border color when a widget is focused. "auto" uses primary (album) color.
selected_active_background Background of the currently selected row in the active section.
selected_active_foreground Text color of the selected row in the active section.
selected_inactive_background Background of selected rows in inactive sections.
selected_inactive_foreground Foreground of selected rows in inactive sections.
scrollbar_thumb Scrollbar handle color.
scrollbar_track Scrollbar track color.
progress_fill Played/filled portion of progress bars.
progress_track Unfilled portion of progress bars.
tab_active_foreground Text color of the active tab.
tab_inactive_foreground Text color of inactive tabs.
album_header_background Background for album/artist header rows (optional).
album_header_foreground Foreground for album/artist header rows.
tint_strength 0.0–1.0 float. Controls how much "tinted" colors shift towards the album accent. Stock 0.0, default tinted themes use 0.06.

Example themes

…

Built-in tinted themes — Tinted Dark and Tinted Light are available out of the box and apply the same treatment to the standard dark/light palettes. Switch to them from the theme picker.

The "auto" accent color is derived from album art by default. You can disable this by setting

yaml
auto_color: false

in the config file. This will use the accent color defined in the theme for all "auto" usages instead.


Keymap / Custom key bindings

jellyfin-tui supports fully customizable key bindings via the config file.

You can:

  • add new bindings
  • override existing bindings
  • or disable defaults entirely

Press ? inside jellyfin-tui to see all the available actions and your current bindings. Use the action names exactly as shown there when defining your keymap.

The Help page is the authoritative reference for all actions and bindings.

How to customize

Basic example

yaml
keymap:
  ctrl-c: Quit
  j: Down
  k: Up
  space: PlayPause

Each entry maps a key combination to an action.

Adding new bindings

Adding a new key does not remove existing bindings. For example, if you want to add ctrl + s as an additional key for shuffling the queue, you can do:

yaml
keymap:
  ctrl-s: Shuffle

Both ctrl + s and the default s will now trigger the Shuffle action.

Overriding existing bindings

If you bind a key that already exists, it replaces the previous action.

yaml
keymap:
  ctrl-c: Reset

Now ctrl + c will trigger the Reset action instead of quitting.

Disabling bindings

To unbind a particular keybinding, you can set its value to null.

yaml
keymap:
  # the `Reset` action will now show (unbound) in the help page
  ctrl-x: null

To start with a completely empty keymap:

yaml
keymap_inherit: false
# only `Quit`, `Down` and `Up` will be bound
keymap:
  ctrl-q: Quit
  j: Down
  k: Up

Actions with parameters

Some actions accept parameters. It is important to use the correct syntax for these, which is !ActionName "parameters":

yaml
keymap:
  # seek 10 seconds forward or backward
  ctrl-h: !Seek -10
  ctrl-l: !Seek 10
  # adjust volume by a delta (positive or negative)
  ctrl-up: !Volume 5
  ctrl-down: !Volume -5

Issues· 0 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

Rustjellyfinmpvmusicoffline

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月17日
分类编程语言
定价开源

> 相关工具

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言