Jellyfin 跨平台桌面播放器完整教程【免费下载链接】jellyfin-desktopJellyfin Desktop Client项目地址: https://gitcode.com/GitHub_Trending/je/jellyfin-desktopJellyfin Desktop 是一个用 Qt WebEngine 与 libmpv 构建的跨平台媒体播放器负责把 Jellyfin 服务器上的影片直接送进你的屏幕和音箱界面走 Web 客户端解码与渲染交给 libmpv更多格式可以直接播放而无需服务端转码。它同时覆盖 Windows、macOS 与 Linux配置项按资料库profile隔离存放。启动页在做什么先找到你的服务器你看到的第一屏不是加载页而是一张服务发现页客户端会先向局域网广播探测把能连上的 Jellyfin 服务器列出来探测不到就手动填地址。内网常用形式是192.168.x.x:8096远程则填完整的 HTTPS 域名。连接成功后进入的就是库浏览页之后的操作逻辑和你在浏览器里用 Web 客户端时一致。改参数之前配置、缓存和日志都在哪一切按资料库隔离在profiles/profile-id/子目录里主配置是jellyfin-desktop.conf想更细地调 mpv可以在同目录放一份mpv.conf。三个平台的位置Windows配置、缓存均在%LOCALAPPDATA%\Jellyfin Desktop\profiles\profile-id\日志在其下logs\Linux配置在~/.local/share/jellyfin-desktop/profiles/profile-id/缓存在~/.cache/对应目录日志在logs/macOS日志在~/Library/Logs/Jellyfin Desktop/profile-id/排查问题第一件事就是翻日志位置先记下来。 播放链路解码、刷新率与音频直通硬件解码与 AVX2 回退基本不用你管直觉先建立起来硬件解码就是让 GPU 负责解出视频帧而不是吃 CPU。本客户端把视频流直接交给 libmpv渲染管线默认就是走 GPU 的大多数机器无需任何操作。Windows 上有个细节值得知道主力 libmpv 构建需要 CPU 支持 AVX2程序启动时会自检不支持就自动换用随附的libmpv-fallback.dll。老 CPU 不会白屏也不用你手动找旧版本。真正需要你动手的是下面两件事。刷新率匹配电影帧率为什么要对齐显示23.976fps 的电影跑在 60Hz 屏幕上帧会不均匀地分配观感就是轻微抖动。客户端在视频区给了三个联动项refreshrate.auto_switch播放时跟随视频帧率切换显示器刷新率仅全屏时生效refreshrate.avoid_25hz_30hz避开 25/30Hz部分显示器在这两个刷新率上会闪refreshrate.delay切换后等待的秒数给显示器留出稳定时间如果日志里出现切换刷新率失败先确认显示器确实支持目标刷新率而不是怀疑播放器。音频直通与设备类型basic、spdif、hdmi 怎么选直觉basic 是软件混音后的立体声输出spdif 对应光纤同轴hdmi 对应电视的数字声道——后两者是开启直通的前提。音频区的关键项配置项取值与说明devicetypebasic/spdif/hdmi决定音频走哪条物理通路channelsautomacOS 默认/2.0/5.1/7.1passthrough.ac3、passthrough.dts需要 spdif 或 hdmi且关闭所有转码passthrough.eac3、passthrough.dts-hd仅 hdmi 可用normalize默认开启音量归一化exclusive独占音频设备macOS/Windows 可用听到声音发虚或动态被压平先核对devicetype是否和实际接线一致再看直通开关——这两者必须配套。 按症状反查卡顿、无声与证书报错播放卡顿先确认带宽再用--disable-gpu跑一次——它关闭 WebEngine 的 GPU 加速如果卡顿消失问题在渲染链路而不是网络。无声音频设备选择、系统音量、接收端是否支持该直通格式按这个顺序逐个排除。音画不同步多发生在切换刷新率或更换音频设备之后等refreshrate.delay稳定后重播同一段。证书报错可临时用--ignore-certificate-errors跳过但正路是修好服务器证书。多资料库与常用启动参数资料库让你把工作和个人的账号分开配置、缓存、日志彼此独立--list-profiles、--create-profile 名字、--delete-profile 名字、--set-default-profile 名字--profile 名字指定本次会话使用的资料库--tv/--desktop切换布局--fullscreen/--windowed控制窗口--log-level debug打开调试日志QML 里的 console.log 也会一并打印开发调试还能加--remote-debugging-port9222再用 Chrome 的 inspect 页面挂上 DevTools构建与依赖说明见 dev/。还是不对日志、配置兜底与求助入口配置被改坏时客户端会把旧文件改名为.broken并写入默认值不会因为一个坏配置直接起不来。所有配置项及其默认值都能对照 resources/settings/settings_description.json 逐项查构建流程与文件位置清单见 README.md。确认问题可复现后带上日志和复现步骤直接去项目 Issue 区开单那里是开发者第一时间查看的地方。【免费下载链接】jellyfin-desktopJellyfin Desktop Client项目地址: https://gitcode.com/GitHub_Trending/je/jellyfin-desktop创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考