需自备可访问的 Jellyfin 服务器地址和账号;播放依赖 mpv 及其 gpu-next 输出,环境不匹配可能无法嵌入播放;各发行版安装源不同,AUR 包需先装 paru 等 AUR 助手。
flatpak install flathub moe.tsuna.tsukimiREADME 未说明具体硬件要求;作为 Linux 桌面应用,需运行 GTK4 桌面环境,播放依赖 mpv。
Linux 上的第三方 Jellyfin 客户端,用 GTK4 界面看自建媒体库
面向 Linux 桌面的轻量 Jellyfin 第三方客户端,用 GTK4 和 mpv 播放视频与音乐,方便在本地连自建媒体库看片听歌。
核心能力
- 连接 Jellyfin 服务器浏览和播放媒体库
- 基于 GTK4 与 libadwaita 构建原生界面
- 用 mpv 嵌入播放,支持 gpu-next 视频输出
- 提供 Flathub 与各发行版原生包安装
- 界面支持多语言翻译,可参与 Weblate
容易踩的坑
- v26.11.1最新正式版2026-10-31 · 2026-10-31 15:49 UTC
Rec. 2100 Support (HDR 10)
What's Changed
- HDR Support by @tsukinaha in https://github.com/tsukinaha/tsukimi/pull/809
- Toggle fullscreen on double click by @tsukinaha in https://github.com/tsukinaha/tsukimi/pull/804
Full Changelog: https://github.com/tsukinaha/tsukimi/compare/v26.10.1...v26.11.1
- v26.10.12026-10-25 · 2026-10-25 06:23 UTC
查看更新说明
What's Changed
- chore: bump rust-version to 1.92 by @Zakkaus in https://github.com/tsukinaha/tsukimi/pull/778
- Translations update from Hosted Weblate by @weblate in https://github.com/tsukinaha/tsukimi/pull/776
- let touch screen gesture in video perform overlay's reveal by @tsukinaha in https://github.com/tsukinaha/tsukimi/pull/801
- Toggle fullscreen on double click by @tsukinaha in https://github.com/tsukinaha/tsukimi/pull/804
New Contributors
- @Zakkaus made their first contribution in https://github.com/tsukinaha/tsukimi/pull/778
Full Changelog: https://github.com/tsukinaha/tsukimi/compare/v26.9.2...v26.10.1
- v26.9.22026-09-11 · 2026-09-11 10:53 UTC
查看更新说明
What's Changed
- chore: centralize workspace dependencies by @amtoaer in https://github.com/tsukinaha/tsukimi/pull/768
- fix: show 'Finishes at' transition on series pages by @jpds in https://github.com/tsukinaha/tsukimi/pull/769
- fix(build): stop generated resources from triggering rebuilds by @amtoaer in https://github.com/tsukinaha/tsukimi/pull/770
- Introduce yzlm by @tsukinaha in https://github.com/tsukinaha/tsukimi/pull/772
- Translations update from Hosted Weblate by @weblate in https://github.com/tsukinaha/tsukimi/pull/773
- chore: remove age and bump deps by @MutsukiC in https://github.com/tsukinaha/tsukimi/pull/775
Full Changelog: https://github.com/tsukinaha/tsukimi/compare/v26.9.1...v26.9.2
- v26.9.12026-09-05 · 2026-09-05 03:58 UTC
查看更新说明
What's Changed
- feat: show "Finishes at" time when hovering over the play button by @jpds in https://github.com/tsukinaha/tsukimi/pull/742
- fix: align latest card shapes with Jellyfin Web by @amtoaer in https://github.com/tsukinaha/tsukimi/pull/745
- feat: enable horizontal scrolling in HortuScrolled by @amtoaer in https://github.com/tsukinaha/tsukimi/pull/751
- feat: prefer direct playback and add LiveTV server fallback by @amtoaer in https://github.com/tsukinaha/tsukimi/pull/755
- style: format code by @amtoaer in https://github.com/tsukinaha/tsukimi/pull/756
- refactor: remove unnecessary async and fix Clippy warnings by @amtoaer in https://github.com/tsukinaha/tsukimi/pull/757
- fix: clear stale video frame before playback setup by @amtoaer in https://github.com/tsukinaha/tsukimi/pull/758
- fix: prevent cursor flicker when closing player popovers by @amtoaer in https://github.com/tsukinaha/tsukimi/pull/761
- Use commit hash as part of version by @tsukinaha in https://github.com/tsukinaha/tsukimi/pull/760
- docs: add archlinuxcn/tsukimi to README.md by @Integral-Tech in https://github.com/tsukinaha/tsukimi/pull/762
- fix: improve danmaku loading and popover behavior by @amtoaer in https://github.com/tsukinaha/tsukimi/pull/759
- docs: fix grammar mistakes in README.md by @Integral-Tech in https://github.com/tsukinaha/tsukimi/pull/763
- Bump version to 26.9.1 by @tsukinaha in https://github.com/tsukinaha/tsukimi/pull/764
- Translations update from Hosted Weblate by @weblate in https://github.com/tsukinaha/tsukimi/pull/743
- chore: replace epoxy-rs with direct libepoxy loading by @amtoaer in https://github.com/tsukinaha/tsukimi/pull/765
- Add a
LayoutManagerfor handling mpv subwindow size by @tsukinaha in https://github.com/tsukinaha/tsukimi/pull/766 - Update dependencies by @tsukinaha in https://github.com/tsukinaha/tsukimi/pull/767
New Contributors
- @jpds made their first contribution in https://github.com/tsukinaha/tsukimi/pull/742
- @Integral-Tech made their first contribution in https://github.com/tsukinaha/tsukimi/pull/762
Full Changelog: https://github.com/tsukinaha/tsukimi/compare/v26.8.4...v26.9.1
- v26.8.42026-08-20 · 2026-08-20 09:34 UTC
查看更新说明
New Music Player Style
wlshmvo SupportSome of platforms doesn't support zero copy dmabuf texture exports, like wsl-g, so we add shm vo support.
What's Changed
- feat: align core image fallback and sizing logic with Jellyfin Web by @amtoaer in https://github.com/tsukinaha/tsukimi/pull/717
- UI tweaks by @tsukinaha in https://github.com/tsukinaha/tsukimi/pull/718
- feat: further unify cover image handling and improve caching with image_tag by @amtoaer in https://github.com/tsukinaha/tsukimi/pull/719
- feat: parallelize detail page loading and add caching for
get_episodes_allby @amtoaer in https://github.com/tsukinaha/tsukimi/pull/726 - fix(i18n): localize missing episode overview placeholder by @amtoaer in https://github.com/tsukinaha/tsukimi/pull/730
- feat: add compatibility with Jellyfin 12.0 by @amtoaer in https://github.com/tsukinaha/tsukimi/pull/720
- Style fixes by @tsukinaha in https://github.com/tsukinaha/tsukimi/pull/732
- repo: reorg into workspace by @tsukinaha in https://github.com/tsukinaha/tsukimi/pull/735
- New style for music player by @tsukinaha in https://github.com/tsukinaha/tsukimi/pull/737
Full Changelog: https://github.com/tsukinaha/tsukimi/compare/v26.8.2...v26.8.4
用户点评
登录用户的真实使用记录,可按版本和硬件筛选还没有人点评。第一个说出真实体验的人最有价值。
tsukimi
A simple third-party Jellyfin client for Linux.
We use wl-proxy for mpv gpu-next vo embedding, you can find the embedder here. We also made a local player Fughetta using this embedder.
Screenshots
Installation
Native Packages
Fedora
sudo dnf copr enable walker874/tsukimi
sudo dnf install tsukimi
Arch Linux
# AUR release (https://aur.archlinux.org/packages/tsukimi-bin)
paru -S tsukimi-bin
# AUR latest commit (https://aur.archlinux.org/packages/tsukimi-git)
paru -S tsukimi-git
# archlinuxcn repo https://github.com/archlinuxcn/repo/blob/master/archlinuxcn/tsukimi/PKGBUILD
sudo pacman -Syu tsukimi
# archlinuxcn repo https://github.com/archlinuxcn/repo/blob/master/archlinuxcn/tsukimi-git/PKGBUILD
sudo pacman -Syu tsukimi-git
AOSC OS
sudo oma install tsukimi
Gentoo Linux
sudo eselect repository enable gentoo-zh
sudo emerge --sync gentoo-zh
sudo emerge --ask media-video/tsukimi
Nix
tsukimi is available in nixpkgs since 24.11.
MPV Config
Contributing
Please follow the contribution guide to learn how to start contributing to Tsukimi.
Disclaimer
The developers of this application do not have any affiliation with the content providers available.
License
tsukimi is licensed under the GPLv3 license.
Thanks to open-source projects like GNOME Music, Fractal, and Clapper—we referenced a lot from them during development, and everyone who contributed code or translations!