Jellyfin MPV Shim 跨平台投屏客户端完全指南
项目地址: https://gitcode.com/gh_mirrors/je/jellyfin-mpv-shim Jellyfin MPV Shim 是一个强大的跨平台 Jellyfin 投屏客户端，使用 MPV 作为播放引擎，支持直接播放大多数媒体文件而无需转码。它提供了许多独特的功能，使其在多媒体客户端中脱颖而出。
项目概述
Jellyfin MPV Shim 是一个专门为 Jellyfin 媒体服务器设计的投屏客户端，具有以下核心优势：
- 直接播放高级媒体文件，无需转码
- 支持 SyncPlay 与朋友同步观看视频
- 提供后台运行的 shim 模式
- Jellyfin 移动应用可以完全控制客户端
- 一次性重新配置整个季度的字幕
- 支持所有 MPV 键盘快捷键
- 增强视频效果的 Shader Packs 和 SVP 集成
- 通过 Discord Rich Presence 分享媒体活动
安装与配置
Windows 安装
在 Windows 系统上，您可以直接下载预编译的二进制文件并运行。
Linux 安装
在 Linux 系统上，您可以通过多种方式安装：
通过 pip 安装：
pip3 install --upgrade jellyfin-mpv-shim
安装 GUI 和系统托盘功能：
pip3 install pystray
sudo apt install python3-tk
安装显示镜像功能：
pip3 install jellyfin-mpv-shim[mirror]
macOS 安装
在 macOS 系统上，建议使用以下安装方式：
brew install python mpv
pipx install jellyfin-mpv-shim
核心功能详解
菜单系统
通过按 c 键或使用移动应用中的导航控件来打开菜单。菜单提供以下功能：
- 调整视频转码质量
- 更改默认转码器设置
- 查看轨道名称并更改字幕或音频
- 为整个系列一次性更改字幕或音频
- 将媒体标记为未观看并退出
- 启用和禁用 SyncPlay
- 配置着色器包和 SVP 配置文件
- 截图功能
着色器包功能
着色器包是一个高级功能，允许您轻松使用高级视频着色器和视频质量设置。默认着色器包已预配置 FSRCNNX 和 Anime4K 等效果。
配置选项：
shader_pack_enable- 启用着色器包（默认：true）shader_pack_custom- 使用自定义着色器包（默认：false）shader_pack_remember- 自动记住最后使用的着色器配置文件（默认：true）
SVP 集成
SVP 集成允许您轻松配置 SVP 支持、更改配置文件以及在不退出播放器的情况下启用/禁用 SVP。
显示镜像
此功能允许在投射媒体之前在显示器上显示媒体预览，类似于 Chromecast 的体验。
启用方法：
- 使用系统托盘图标，点击"应用菜单"
- 进入首选项并启用显示镜像
或者，在配置文件中将 display_mirroring 设置为 true，然后重新启动应用程序。
配置详解
转码设置
您可以通过菜单调整基本的转码器设置：
always_transcode- 告诉客户端始终转码（默认：false）transcode_hdr- 强制将 HDR 视频转码为 SDR（默认：false）transcode_dolby_vision- 强制将杜比视界视频转码为 SDR（默认：true）remote_kbps- 远程流媒体允许的带宽（默认：10000）local_kbps- 本地流媒体允许的带宽（默认：2147483）
功能配置
使用配置文件启用和禁用功能：
fullscreen- 开始播放时全屏播放器（默认：true）enable_gui- 启用系统托盘图标和 GUI 功能（默认：true）display_mirroring- 启用基于 webview 的显示镜像（默认：false）discord_presence- 启用 Discord 丰富状态支持（默认：false）
键盘快捷键
程序支持大多数 MPV 键盘快捷键。自定义键盘快捷键包括：
< >- 跳过剧集q- 关闭播放器w- 标记为已观看并跳过u- 标记为未观看并退出c- 打开菜单k- 禁用着色器包
外部 MPV 支持
客户端现在支持使用外部 MPV 副本，包括在启动客户端之前运行的副本。
使用技巧与最佳实践
家庭影院设置
Jellyfin MPV Shim 非常适合家庭影院系统，支持直接播放高清视频文件，无需转码，节省系统资源。
媒体服务器集成
如果您有媒体服务器，Jellyfin MPV Shim 可以作为一个强大的客户端，支持所有高级媒体文件格式。
视频编辑应用
对于视频编辑人员，Jellyfin MPV Shim 提供了一个强大的播放器，支持各种视频格式和字幕配置。
故障排除
内存使用问题
如果遇到 MPV 在媒体播放后使用大量 RAM 的问题，可以尝试启用外部 MPV：
{
"mpv_ext": true,
"mpv_ext_path": "C:\\path\\to\\mpv.exe"
}
播放器大小调整
要启用窗口自由调整大小，请在 mpv.conf 中添加：
no-keepaspect-window
开发与贡献
如果您想在不安装的情况下运行应用程序，请运行 ./run.py。该项目完全使用 Python 3 编写，没有任何闭源组件。
本地开发安装
-
安装依赖：
pip3 install --upgrade python-mpv jellyfin-apiclient-python pystray Jinja2 pywebview python-mpv-jsonipc pypresence -
克隆仓库：
git clone https://gitcode.com/gh_mirrors/je/jellyfin-mpv-shim -
运行准备脚本：
./gen_pkg.sh
翻译贡献
项目使用 gettext 进行翻译。要重新生成 base.pot 并使用新字符串更新现有翻译：
./regen_pot.sh
要编译所有 *.po 文件到 *.mo：
./gen_pkg.sh --skip-build
典型应用场景
同步观看体验
通过 SyncPlay 功能，您可以与家人或朋友一起观看视频，享受同步播放的乐趣。
远程控制功能
Jellyfin 移动应用可以完全控制客户端，提供便捷的远程操作体验。
Jellyfin MPV Shim 作为 Jellyfin 生态系统中的重要组成部分，提供了强大的播放功能，是构建家庭媒体中心的理想选择。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
