Jellyfin MPV Shim安装使用指南(MacOS)

Jellyfin MPV Shim是什么?

Jellyfin MPV Shim 是跨平台的 Jellyfin 投屏客户端。它通过调用 MPV 可播放大部分的视频格式,并内建大量进阶功能。

虽然该客户端是为 Jellyfin 设计,但大部分功能可在 Emby 上正常使用,且播放体验比 Emby 官方客户端要好。如果你受不了Emby的播放器,可以尝试本客户端。

(但由于是投屏客户端,你仍然需要打开普通客户端去选择需要播放的视频。)

安装

注:本安装过程在 Macbook Pro (2020 Intel) 的 MacOS Catalina (10.15.7) 和 python 3.9 环境下测试成功。

Jellyfin MPV Shim 在 MacOS 上安装需要使用 brew 。安装过程可以参考官方网站

Jellyfin MPV Shim 可在命令行和图形界面两种不同模式下运行。

安装命令行部分:

  1. 安装 python3 和 mpv:brew install python mpv
  2. 安装 jellyfin-mpv-shim:pip3 install --upgrade jellyfin-mpv-shim

如要安装图形界面部分,需另外执行以下部分:

  1. 安装 Tkinter:brew install python-tk
  2. 安装 jellyfin-mpv-shim 和 pystray:pip3 install --upgrade 'jellyfin-mpv-shim[gui]'

注:在编写本教程时,执行第4步时会把 Jellyfin MPV Shim 的版本降到1.8。重新执行第2步的话又会把版本升回2.0。目前不清楚升回2.0会否产生问题。

以下主要介绍图形界面模式。

启动 Jellyfin MPV Shim 客户端

在终端执行命令:jellyfin-mpv-shim

如需关闭,点击顶部菜单栏的图标,选择Quit

添加服务器

在右侧输入服务器、帐号和密码,然后点击"Add Server"

注:服务器一栏请完整输入协议(http, https), 服务器名称 和 端口。详细信息请通过 厂妹 @EmbyPublicBot 获取。

如果成功添加,会在左侧显示OK。如失败(显示Fail),请再次添加并确认输入的信息无误。

注:由于片头的原因,部分服务器可能无法正常添加。请添加没有片头的服务器。

Jellyfin MPV Shim 可同时添加多个服务器。如需继续添加,可重复以上步骤。

移除服务器

如需移除已添加的服务器,在左侧选择需要移除的服务器,并点击右侧的"Remove Server"

打开管理界面

首次成功添加服务器后,之后再次运行 Jellyfin MPV Shim 默认不会打开服务器管理界面。此时如需要添加/移除服务器,则要手动开启管理界面。

点击顶部菜单栏的图标,选择Configure Servers

若手动关闭了管理界面(点击Close),可通过同样的方法来重新打开。

播放

打开Emby客户端(例如官方客户端)登录其中一个已添加的服务器。

点击右上角投屏按钮,选择名字结尾为 Jellyfin MPV Shim 的设备。

选择需要播放的视频,点击播放。

略等数秒,电脑会自动调用MPV播放该视频。

注:建议不要重复点击,否则会重复从头播放。

音轨和字幕可以在图示处点击切换。

播放器菜单

在播放器中按c,或者点击顶部菜单栏图标然后选择 Application Menu,即可打开播放器菜单更改部分设置和启用进阶功能。

常用的设置有:

Change Audio: 切换音轨

Change Subtitles: 切换字幕

Video Preferences: 可调整字幕部分参数。

Player Preferences: 可调整播放器部分参数。

注1:终点站没开启转码功能,所有转码参数不起作用。

注2:其它进阶功能请自行探索。

常用快捷键

  • < >跳过剧集

  • q关闭播放器

  • w标记为已播放并跳过

  • u标记为未播放并关闭播放器

  • c打开菜单

  • k 禁用 shader packs

  • 空格 暂停/继续

  • 左/右 后退/前进5秒

  • 上/下 后退/前进1分钟

  • s 截图

  • S 截图(无字幕)

  • f 全屏

  • ,/. 按帧后退/前进

  • [/] 调整播放速度10%

  • {\}调整播放速度50%

  • 后退 重置播放速度

  • m 静音

  • d 启用/禁用 deinterlace

  • Ctrl+Shift+左/右调整字幕延迟

已知问题

  • 在播放Emby时,无法直接从上次结束的时间继续观看。该问题是单向的。例如你若播放某剧集到5:00时关闭播放器,Emby会正确记录你观看到5:00。但是即使你在客户端中点击按钮从5:00继续播放,播放器仍然会从剧集的开头开始播放。由于该问题在Jellyfin服务器上没有出现,估计是两者并不完全相容所致。

    临时解决办法是播放前记住时间,然后开始播放后手动调整到相应的时间继续观看。

配置文件

相关配置文件会出现在~/Library/Application Support/jellyfin-mpv-shim/目录下。可以通过点击顶部菜单按钮打开目录。

其中conf.json文件记录了Jellyfin MPV Shim 的各种设置和快捷键,而cred.json文件记录了已添加的服务器信息。

具体设置请参考官方页面

进阶功能

除了上述基本功能外,Jellyfin MPV Shim 还支持各种进阶功能,包括:

  • Shader Packs:通过选择不同的预设参数来获得不同的显示效果。请选择合适的选项,否则观看感受有可能会变差。
  • SyncPlay:与其他人同步观看同一视频。
  • SVP Integration:实时将任何视频转换为 60+ fps。
  • Display Mirroring:投屏之前可先预览。

注:上述功能笔者全部没有用过,请自行探索。所以上面部分我是瞎写的。

官方Github页面

若需要更详细的资料,请参考官方页面

命令行模式

既然你选择了这条充满荆棘的道路,应该不需要我提供教程吧?不需要吧?不需要吧?

这里仅提供简单介绍:

  1. 在终端执行命令:jellyfin-mpv-shim 启动Shim

  2. 首次启动会提示你添加服务器信息(请完整填写协议、域名和端口)

  3. 添加成功后会问你是否继续添加。如果选否,之后不会再提示添加服务器,即使重新开启。所以建议一次性的把需要的服务器全部添加完毕。进一步的操作可通过修改cred.json来管理。

  4. 关闭:Ctrl+C

results matching ""

    No results matching ""