jellyfin/jellyfin-desktop

项目介绍

Jellyfin Desktop 是 Jellyfin 服务器的原生桌面客户端，使用 Qt WebEngine 和 libmpv 构建，可在 Windows、Linux 和 macOS 上播放媒体库中的音视频。它支持硬件解码、音频直通，并能在更多格式下直接播放、减少转码 (3)。适合希望用桌面应用而非浏览器播放 Jellyfin 内容，尤其是重视直接播放和音频直通的用户。

快速使用

Linux 用户可以从 Flathub 安装正式版 (7)。开发版跟随 master 最新提交，按平台提供压缩包：

• macOS：Apple Silicon 或 Intel
• Windows：x64 安装版 或 x64 便携版
• Linux：AppImage x86_64

下载并解压对应平台的压缩包，启动程序后登录自己的 Jellyfin 服务器即可。开发版不是带版本号的正式发布，而是由当前 master 分支构建 (8)。

从源码构建

各平台的构建说明放在 dev/ 目录 (18)。README 没有列出编译器或依赖版本，这些信息需要查看对应平台的构建文件。

配置与数据位置

设置按用户配置（profile）存放在 profiles/<profile-id>/ 下，主配置文件为 jellyfin-desktop.conf；也可以在配置目录中放置 mpv.conf 直接配置 MPV (19)。

• Windows： %LOCALAPPDATA%\Jellyfin Desktop\profiles\<profile-id>\
• Linux： ~/.local/share/jellyfin-desktop/profiles/<profile-id>/
• Linux（Flatpak）： ~/.var/app/org.jellyfin.JellyfinDesktop/data/jellyfin-desktop/profiles/<profile-id>/
• macOS： ~/Library/Application Support/Jellyfin Desktop/profiles/<profile-id>/

日志位于配置目录下的 logs/ 子目录，各平台的缓存路径也单独设置 (19)。

使用约束

使用前需要一个可访问的 Jellyfin 服务器及该服务器上的账号。硬件解码和音频直通取决于主机 GPU、音频输出链路和所播放的媒体，不能保证任意组合都可用。项目采用 GPL-2.0 许可证。

HotRepo 点评

HotRepo 记录到该项目的一条日榜数据：2026-11-02 在 C++ 日榜最高排第 11 名，仓库共 5,956 Star，当日新增 10 Star。这只是一张单日快照，说明它在 C++ 桌面客户端领域有可见度，但不足以判断持续趋势。项目真正的差异点在于基于 libmpv 的播放层，它提供硬件解码和直通能力，而不是只把 Jellyfin 网页包进桌面窗口 (3)。