☰

embyToLocalPlayer

需要 Python。Emby 调用外部本地播放器，并回传播放记录。适配 Jellyfin Plex。

目前為 2023-04-13 提交的版本，檢視 最新版本。

如何安裝

您需要先安裝使用者腳本管理器擴展，如 Tampermonkey、Greasemonkey 或 Violentmonkey 之後才能安裝該腳本。

You will need to install an extension such as Tampermonkey to install this script.

您需要先安裝使用者腳本管理器擴充功能，如 Tampermonkey或 Violentmonkey 後才能安裝該腳本。

您需要先安裝使用者腳本管理器擴充功能，如 Tampermonkey或 Userscripts 後才能安裝該腳本。

你需要先安裝一款使用者腳本管理器擴展，比如 Tampermonkey，才能安裝此腳本

您需要先安裝使用者腳本管理器擴充功能後才能安裝該腳本。

（我已經安裝了使用者腳本管理器，讓我安裝！）

如何安裝

你需要先安裝一款使用者樣式管理器擴展，比如 Stylus，才能安裝此樣式

你需要先安裝一款使用者樣式管理器擴展，比如 Stylus，才能安裝此樣式

你需要先安裝一款使用者樣式管理器擴展，比如 Stylus，才能安裝此樣式

你需要先安裝一款使用者樣式管理器擴展後才能安裝此樣式

你需要先安裝一款使用者樣式管理器擴展後才能安裝此樣式

你需要先安裝一款使用者樣式管理器擴展後才能安裝此樣式

（我已經安裝了使用者樣式管理器，讓我安裝！）

作者
kjtsune
評價
0 0 0
版本
1.1.6
建立日期
2022-07-30
更新日期
2023-04-13
尺寸
8.6 KB
授權條款
MIT
腳本執行於

embyToLocalPlayer-Python

  • Emby 调用 PotPlayer mpv IINA MPC VLC 播放，并回传播放进度（可关）。适配 Jellyfin Plex。
  • 支持：纯本地｜网络｜持久性缓存｜下载 多种模式。
  • 本地需要安装 Python

特性

  • 在首页也可以播放。点击原来的播放按钮就可以。播放无需二次确认。
  • 可持久性缓存文件到本地。（网盘用户及 Emby 是别人分享的可能用到）
  • 视频文件 可本地 可挂载 可远端。
  • mpv VLC MPC PotPlayer 通过网络播放时也支持外挂字幕。(播放前先选择字幕)
  • 其他播放器一般也能用，只是不会回传进度。

以下播放器支持回传进度

  • PotPlayer 发布页 若使用 http 播放，可能提示地址关闭， 解决方法在 FAQ。
  • mpv（纯快捷键）Windows 。 macOS 解压后拖到应用程序即可 macOS
  • mpv.net（可鼠标）发布页
  • VLC 发布页
  • MPC-HC 发布页
  • MPC-BE 发布页
  • IINA（macOS）发布页 若使用 http 播放不支持外挂字幕文件（mpv 支持）

使用说明

基础配置

  1. 下载 embyToLocalPlayer.zip 并解压到任意文件夹。 发布页 ｜ 加速链接 （感谢）
  2. 安装油猴脚本。 发布页
  3. 安装 Python (勾选 add to path) 官网
  4. 填写播放器路径与名称 embyToLocalPlayer_config.ini

前置说明

  • 网页闪一下是自动关闭兼容流提示。
  • 播放器要退出触发回传进度。
  • 报错就截图发群里。见 FAQ。

Windows

  • 双击 embyToLocalPlayer_debug.bat
  • 按 1（窗口运行），若无报错，可网页播放测试。
  • 按 2 则创建开机启动项并后台运行。
  • 以下可选：
    • 命令行输入 python -V 检查 Python 是否安装成功及版本。
      Windows 11 有可能需要用商店安装。
    • 若自启失败，检查启动项是否被禁用：任务管理器 > 启动。
    • 若需要源码运行：安装 AutoHotKey v2 或把 autohotkey_tool.ahk 编译为 exe。
    • 告诉我怎么可以取消 AutoHotKey 依赖，或 PR。即：通过 .vbs 自启后所有播放器都可以正常显示并捕获键盘快捷键。例如：mpv。

macOS

  1. 刚才保存的文件夹 > 右击 > 新建位于文件夹的终端窗口 chmod +x *.command 回车。
  2. 双击 emby_script_run.command, 若无报错，可播放测试。
  3. 开机自启（无窗口运行）：
    1. 启动台 > 自动操作 > 文件 > 新建 > 应用程序 > 运行 Shell 脚本 >
      把 emby_script_run.command 文件拖入 > 点击运行后测试播放 > 文件 > 存储 > 取名并保存到应用程序。
    2. 启动台 > 刚才的应用 > 双击后台运行后再次播放测试。
    3. 系统偏好设置 > 用户与群组 > 登录项 > 添加刚才的应用。

Linux

  1. apt install python3-tk（没报错不装也行）
  2. 添加 emby_script_run.command 执行权限，并用终端打开。
  3. 正常播放后，加入开机启动项（无窗口运行）：
    Debian_Xfce：设置 > 会话和启动 > 应用程序自启动

FAQ

通用说明

  • Python 最低支持版本为 3.8。
  • 用鼠标手势软件关闭播放器体验更舒服一点。
  • 同服务器同时开启多个浏览器标签页，会造成回传进度失败假象。手动刷新一下页面，或者只开一个标签。
  • Plex 及部分域名有 dns 污染，若无法播放，修改系统 DNS 或使用代理。
  • 反馈群组在频道置顶，提问前先把 FAQ 看一遍，不含敏感数据不私聊。
    小更新会频道提醒，不过应该也没什么更新的了，反馈不需要关注频道。https://t.me/embyToLocalPlayer

如何切换模式

  • 点击浏览器油猴插件图标，会有菜单。
  • 网页播放模式：开启 > 禁用脚本。
  • 读取硬盘模式：关闭 > 调用本地播放器但使用服务器网络链接。（默认）
  • 读取硬盘模式：开启 > 调用本地播放器并转换服务器路径为本地文件地址。
    需要 .ini 里填好路径替换规则，服务端在本地则不用填。.bat 按 4 有辅助配置程序
  • 持久性缓存模式：只看配置文件，与油猴设置不冲突，不需要开启读取硬盘模式。

如何更新

  • 将 _config.ini 重命名为 .ini，其他全删除。再次 GitHub 下载解压当前文件夹。（.ini 优先于 _config.ini ）
  • 同时看看 embyToLocalPlayer_config.ini 有没有新内容。
  • 油猴脚本也记得要更新。

如何反馈

  1. 运行 debug.bat 选1。（ macOS 或 Linux 运行 .command)
    若闪退，命令行输入 python -V 检查 python 是否安装成功及版本。
    Python 低于 3.8.10 的先升级试试看。
  2. 换播放器及换视频文件测试是否复现。
  3. 截图或复制 .bat 窗口中的日志。
  4. 碰到什么问题及怎么复现。

字幕相关

  • Emby 里字幕选择无效。
    外挂字幕选择有效，内置字幕会被忽略，由播放器选择。
    视频文件的内置字幕当作外挂字幕处理会导致播放器语言设置失效。（外挂字幕最优先）
    正常播放器都可以设置语言优先顺序。

播放列表（多集回传）相关

  • 在配置文件里 [playlist] 中启用。（局域网用户已默认启用）

  • 播放列表添加完成前最好不退出

  • Windows:

    • mpv:
    • mpv.net:
    • vlc:
    • mpc: be: 播放列表条目超过10个可能会卡住，hc 没这问题。
    • pot: 若日志显示KeyError: 'stream.mkv'，升级或者降级 pot，直至 pot 能显示电影标题。
      pot: 下一集无法添加 http 外挂字幕。

  • macOS

    • mpv:
    • iina: 仅读盘模式支持并可回传
    • vlc: 下一集无法添加 http 外挂字幕。

  • Linux

    • mpv:
    • vlc: 下一集无法添加 http 外挂字幕。

播放器相关:

mpv.net

  • 设置播放完自动关闭。不加载下个文件。（触发回传进度）
    右击 > Settings > Playback > idle:no, auto-load-folder:no （大概是这样

PotPlayer

  • 选项 > 播放 > 播放窗口尺寸：全屏
  • 配置/语言/其他 > 收尾处理 > 播放完当前后退出（触发回传进度）
  • Pot 自身问题：.bat 日志可能提示KeyError: 'stream.mkv'。
    解决方案：三选一。1. 本地用户使用读盘模式；2. 换 pot 版本；3. 把 .ini 文件里多集回传 部分删除。
    PotPlayerSetup64-230208.exe 可以换这个版本，文件与官网一致。
    sha1sum fcd6404e32e6d28769365d9493627f15a0a302d5
  • Pot 自身问题：若使用 http 播放，可能提示地址关闭。Win8 32bit 碰到。
    解决方案：本地用户使用读盘模式，或者换 pot 便携版。
    安全性未知：PotPlayerPortable-220914.zip
    先打开 PotPlayerPortable.exe 一次，但播放用 C:\<path_to>\PotPlayerPortable\App\PotPlayer\PotPlayer.exe
    不然会要求管理员权限运行。

MPC：

  • 会自动开启 WebUI 建议仅允许从 localhost 访问： 查看 > 选项 > Web 界面：
    打勾 仅允许从 localhost 访问

IINA

  • 退出播放器才会回传进度。
  • 非读盘模式不支持外挂字幕文件（mpv 支持）

其他:

Jellyfin 相关

  • 首页播放结束后，10秒内重复播放同文件，本地播放器收到的播放时间会有误。
    解决方法：
    1. 进详情后再播放没这问题；说明不是我的锅
    2. 等待10秒后再继续播放；
    3. 手动刷新页面后播放；
    4. 告诉我要发送什么请求可以解决这个问题

Plex 相关

  • 可能 dns 污染，若无法播放。修改系统 DNS 或使用代理。
  • PotPlayer
    播放 http 时无法读取外挂字幕，读取硬盘模式却可以。（字幕手动上传的，本地硬盘没有，比较玄学）
  • 会提示回放错误，随便点一下就会消失。

弹弹play 相关

  • 若通过 http 播放，有以下缺点：
    1. 每次播放需要选择弹幕。（已把文件名发送给播放器匹配）
    2. 启动时无法及时跳转到 Emby 开始时间，需要播放开始后等待15秒。（每次看完一集则不影响）
    3. 无法加载外挂字幕。

持久性缓存（边下边播）相关

  • 在配置文件里 [gui] 中启用
  • 如果播放进度超过下载进度，建议关闭播放器触发回传以保存播放进度。（以下为 Windows 平台测试）：
    mpv mpv.net 会停止播放十几秒。
    Pot 会停止播放或跳到尾部。(记得拖回来再关闭）
    MPC 会退出播放器。
    VLC 会停止播放。
  • Windows：（ Linux ext4, macOS APFS 没问题。）
    问题：默认的硬盘文件系统 NTFS 会造成额外磁盘开销和初始化时间久，ReFS 正常。
    解决方案：
    1. 使用 顺序下载（需要下载完毕才会用缓存播放，点播放会回退到网络播放模式）
    2. Win10 工作站版和企业版 支持 ReFS，把缓存盘或分区格式化为 ReFS（数据会清空）。
    3. 未核实：用密匙升级为工作站版，或数字权利工具转换。
    4. 开虚拟机或别的电脑有工作站版，然后直通硬盘并格式化成 ReFS 给 Win10 用（专业版测试可行）。
      Win8.1 有人改注册表支持。
  • 网页点击播放时弹出菜单：
    1. 播放：当缓存进度大于播放开始时间时用缓存播放。其他情况回退网络模式。
    2. 下载 1% 后播放：等待下载首尾各 1% 后启动播放器。其他等同于播放。
    3. 下载（首尾优先）：优先下载首尾各 1% ，可边下边播。
    4. 下载（顺序下载）：不能边下边播。
    5. 删除当前下载
    6. 下载管理器

感谢