☰

embyToLocalPlayer

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

如何安装

您需要先安装一个扩展，例如 篡改猴、Greasemonkey 或 暴力猴，之后才能安装此脚本。

您需要先安装一个扩展，例如 篡改猴 或 暴力猴，之后才能安装此脚本。

您需要先安装一个扩展，例如 篡改猴 或 暴力猴，之后才能安装此脚本。

您需要先安装一个扩展，例如 篡改猴 或 Userscripts ，之后才能安装此脚本。

您需要先安装一款用户脚本管理器扩展，例如 Tampermonkey，才能安装此脚本。

您需要先安装用户脚本管理器扩展后才能安装此脚本。

（我已经安装了用户脚本管理器，让我安装！）

如何安装

您需要先安装一款用户样式管理器扩展，比如 Stylus，才能安装此样式。

您需要先安装一款用户样式管理器扩展，比如 Stylus，才能安装此样式。

您需要先安装一款用户样式管理器扩展，比如 Stylus，才能安装此样式。

您需要先安装一款用户样式管理器扩展后才能安装此样式。

您需要先安装一款用户样式管理器扩展后才能安装此样式。

您需要先安装一款用户样式管理器扩展后才能安装此样式。

（我已经安装了用户样式管理器，让我安装！）

作者
kjtsune
日安装量
10
总安装量
8,012
评分
50 2 0
版本
2025.11.04
创建于
2022-07-30
更新于
2025-11-04
大小
34.7 KB
许可证
MIT
适用于

etlp - embyToLocalPlayer

etlp - Emby/Jellyfin 调用 PotPlayer mpv IINA MPC VLC 播放，并回传播放进度（可关）。适配 Plex。

特性

  • 在首页也可以播放。点击原来的播放按钮就可以。可配置版本优先级（若视频多版本）。
  • 播放列表（连续播放）支持，下一集保持相同版本。
  • trakt.tv bangumi.tv bgm.tv 单向标记已观看支持。
  • 本地挂载用户：可跳转到路径对应文件夹。（按钮在网页显示文件路径的上面）
  • 未适配的播放器一般也能用，只是不会回传进度。
  • 可在 qBittorrent WebUI 里直接播放或者跳转到路径对应挂载文件夹。 配套脚本
  • 伪 • 聚合搜索。配套脚本

以下播放器支持回传进度

  • 没特殊要求的话，mpv 系的播放器综合体验较好。
  • mpv（纯快捷键）Windows 。 macOS 解压后拖到应用程序即可 macOS
  • mpv.net（可鼠标）发布页。 其他 mpv 内核的播放器一般也可以。
  • PotPlayer 发布页 若使用 http 播放，可能提示地址关闭， 解决方法在 FAQ。
  • MPC-HC 发布页
  • MPC-BE 发布页
  • VLC 发布页
  • IINA（macOS）发布页

使用说明

基础配置

  1. 油猴插件，装一个即可：
    Tampermonkey v3 并启用开发者模式。启用教程
    Tampermonkey v2 | Violentmonkey 已知问题：新版 chrome 可能无法安装。
  2. 安装油猴脚本并刷新 Emby 页面。发布页
  3. 方案三选一，下载并解压 .zip 到任意英文路径。 发布页
    • 推荐: etlp-mpv-py-embed-win32.zip (mpv 播放器 | Windows only | 快捷键见 FAQ)
      无需修改配置文件，查看下方 .bat 运行方法。
    • etlp-python-embed-win32.zip (Windows only)
      修改配置文件：embyToLocalPlayer_config.ini 中的播放器路径，以及播放器选择。
    • embyToLocalPlayer.zip (Windows / Linux / macOS)
      安装 Python (勾选 add to path) 官网
      修改配置文件：embyToLocalPlayer_config.ini 中的播放器路径，以及播放器选择。

前置说明

  • 网页闪一下是自动关闭兼容流提示。
  • 播放器要退出触发回传进度。
  • 日志出现 serving at 127.0.0.1:58000 为服务启动成功。
  • 碰到问题先参考下方相关 FAQ，没按要求反馈会忽略。

Windows

  1. 双击 embyToLocalPlayer_debug.bat
  2. 若无报错，按 1（不要关闭窗口），然后网页播放测试。（点击原来的播放按钮就可以）
  3. 按 2 则创建开机启动项并后台运行。（隐藏窗口运行）
  • 问题排查：
    • Pot 提示渲染 Pin 失败，无法播放。解决方法在 FAQ。
    • 含 mpv 的版本若要修改为其他播放器，需要删除 mpv_embed 文件夹。
    • 若双击 .bat 就提示找不到 Python，
      或者播放器无法播放，请使用包含 mpv 的便携版测试。
    • 若自启失败，检查启动项是否被禁用：任务管理器 > 启动。
      .bat 按 3 查看开机文件夹里面embyToLocalPlayer.vbs是否被杀毒软件删了。
      若被删，可以自己创建 vbs，然后双击测试是否正常后台运行。 .vbs 模板: CreateObject("Wscript.Shell").Run """<Python所在文件夹>\python.exe"" ""<脚本所在文件夹>\embyToLocalPlayer.py""" , 0, True
    • 若 bat 或者 vbs 有无法解决的问题，可尝试使用 AutoHotkey 自启动解决方案。
    • 反馈前看下方相关 FAQ，没按要求反馈会忽略

FAQ 内容，以 GitHub 为准。
https://github.com/kjtsune/embyToLocalPlayer#faq

macOS / Linux

macOS / Linux > macOS * macOS 目前没有环境测试，无法提供支持。 1. 刚才保存的文件夹 > 右击 > 新建位于文件夹的终端窗口 `chmod +x *.command` 回车。 2. 双击 `etlp_run.command`, 若无报错，可播放测试。 3. 开机自启（无窗口运行）： 1. 方案一：直接进入下一步，但估计只适用于 Monterey 12 及之前的老版本系统。 方案二：在终端使用 Homebrew 安装 screen。 `brew install screen` 如果你没有安装 Homebrew，请先安装 Homebrew。 `/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"` 2. 启动台 > 自动操作 > 文件 > 新建 > 应用程序 > 运行 Shell 脚本 > 把 `etlp_run.command`（方案一）| `etlp_run_via_screen.command`（方案二） 文件拖入 > 点击运行后测试播放 > 文件 > 存储 > 取名并保存到应用程序。 3. 启动台 > 刚才的应用 > 双击后台运行后再次播放测试。 4. 系统偏好设置 > 用户与群组 > 登录项 > 添加刚才的应用。 5. 如果 Monterey 12.6.6 状态栏有齿轮，把文件拖入的操作替换成写以下内容，注意更改cd目录为你保存的目录。 `cd ~/App/embyToLocalPlayer && nohup ./etlp_run.command > run.log 2&>1 &` > Linux 1. `apt install python3-tk`（没报错不装也行） 2. 添加 `etlp_run.command` 执行权限，并用终端打开。 3. 正常播放后，加入开机启动项（无窗口运行）： * 图形界面: Debian_Xfce：设置 > 会话和启动 > 应用程序自启动。 * systemd 服务自启参考。若失败请用图形界面的自启动。
systemd service ``` [Unit] Description=embyToLocalPlayer After=graphical-session.target [Service] ExecStart=/root/etlp/etlp_run.command ExecStartPre=/bin/bash -c "until loginctl show-session $(loginctl | grep $USER | awk '{print $1}') -p Type | grep -q -e 'x11\|wayland'; do sleep 1; done; sleep 2" TimeoutStartSec=infinity [Install] WantedBy=graphical-session.target ```

FAQ

通用 FAQ > 通用说明 * Python 最低支持版本为 3.8。Windows 最低支持版本为 10。 * 有时浏览器与 Emby 之间的 ws 链接会断开，造成回传进度失败假象。等待看看或手动刷新一下页面。 * 部分域名及 Plex 域名有 dns 污染，若无法播放，修改系统 DNS 或使用代理。 * 反馈群组在频道置顶，提问前先把 FAQ 看一遍，并**按要求反馈**。不含敏感数据不私聊。 小更新会频道提醒，不过应该也没什么更新的了，反馈不需要关注频道。[https://t.me/embyToLocalPlayer](https://t.me/embyToLocalPlayer) > 如何切换模式 * 在 Emby 页面点击浏览器油猴插件图标，会有菜单可供点击切换。 * 脚本在当前服务器：启用（默认）；禁用：当前域名不使用脚本。 * 读取硬盘模式：关闭 > 调用本地播放器但使用服务器网络链接。（默认） * 读取硬盘模式：开启 > 调用本地播放器并转换服务器路径为本地文件地址。前提是本地有文件或挂载。 在 `.ini` 里填好路径替换规则，服务端在本地则不用填。`.bat` 按 4 有辅助配置程序。 出错可尝试设置：`dev` > `path_check = yes` 会检查文件是否存在，转换 NFC/NFD。兼容性更高，日志更清楚。（但会慢一点） 如果还不行，反馈时，提供日志、配置文件、以及服务端媒体文件和客户端对应文件的完整路径。 * 持久性缓存模式：只看配置文件，与油猴设置不冲突，不需要开启读取硬盘模式。 > 如何更新 1. Windows: `.bat` 按 6 Linux / macOS：在 `.ini` 所在的文件夹打开终端，运行 `python3 utils/update.py` 2. 查看新旧配置的差异字段。`embyToLocalPlayer_diff.ini` * 油猴脚本有时也要更新。 > 如何反馈 * **没按要求反馈会忽略。** 1. 参考 `如何更新` ，更新到最新版后测试。 `Windows 用户换含 mpv 的便携版测试，并告知是否正常。` 2. 运行 `debug.bat` 选 1。 `macOS 或 Linux 运行 etlp_run.command 来代替。` 3. 至少测试两个不同电影/节目的视频。 4. 截图或复制 `.bat`/`.command` 窗口中的日志。 `选中后回车即复制，日志需要包含启动后到出现问题的部分。或者直接提供文件夹下的 log.txt` 5. 说明碰到什么问题及怎么复现。 6. [可选] 关闭模糊日志。 `.ini` > `[dev]` > `mix_log = no` 7. 若调用失败（仍在浏览器里播放，或点击播放后 `.bat` 没有新增日志），反馈时提供在 Emby 页面点击浏览器油猴插件图标后的截图。 8. 其他油猴脚本的问题，提供浏览器刷新页面后的截图、浏览器控制台完整日志，相关配置信息（如果有）。 > 字幕/音轨相关 * Emby 里字幕/音轨选择无效。 外挂字幕/音轨选择有效，内置字幕会被忽略，由播放器选择。 视频文件的内置字幕当作外挂字幕处理会导致播放器语言设置失效。（外挂字幕最优先） 正常播放器都可以设置语言优先顺序。 > 剧集播放列表（连续播放|多集回传）相关 * 默认已启用，可在配置文件里 `[playlist]` 中修改。 * 建议不要禁用，大部分功能与播放列表绑定，禁用会缺失一些功能。 * 播放列表添加完成前最好不退出（大部分没事） * 特别说明：若是 Emby/Jellyfin 网页上的 全部播放/随机播放/播放列表 ，仅支持电影和音乐视频类型。 * Windows: * mpv: * mpv.net: * vlc: * mpc: be: 播放列表条目超过10个可能会卡住，hc 没这问题。 * pot: 若日志显示`KeyError: 'stream.mkv'`，看下方 FAQ。 pot: 下一集无法添加 http 外挂字幕时，会禁用播放列表。 pot: 读盘模式可能和美化标题和混合S0的功能冲突，不过不影响使用。 * macOS * mpv: * iina: 仅读盘模式支持并可回传 * vlc: 下一集无法添加 http 外挂字幕时，会禁用播放列表。 * Linux * mpv: * vlc: 下一集无法添加 http 外挂字幕时，会禁用播放列表。
播放器相关 > mpv
mpv * 若碰到问题，换含 mpv 的便携版测试。 * 还不行就换视频或者软解（`mpv.conf`只保留`log-file` 选项）并检查 mpv 日志。 `mpv_embed` > `portable_config` > `mpv_log.txt` `mpv.conf` > `log-file = ` * 弹幕插件推荐： https://github.com/Tony15246/uosc_danmaku https://github.com/Kosette/danmaku > mpv_embed * `mpv.conf` 是我个人使用的简易配置。 * 相较原版 mpv，只修改了少部分快捷键和配置。 * 想更新版本可点击 `mpv_embed` > `updater.bat` > mpv_embed 快捷键
mpv_embed 快捷键 * 中文文档 [https://hooke007.github.io/official_man/mpv.html#id4](https://hooke007.github.io/official_man/mpv.html#id4) * 英文文档 [https://mpv.io/manual/master/#keyboard-control](https://mpv.io/manual/master/#keyboard-control) * 文件位置：`mpv_embed` > `portable_config` > `input.conf` ``` ## 中文文档 https://hooke007.github.io/official_man/mpv.html#id4 ## 中文文档 https://hooke007.github.io/official_man/mpv.html#input-conf ## 英文文档 https://mpv.io/manual/master/#keyboard-control ## 默认按键 https://github.com/mpv-player/mpv/blob/master/etc/input.conf ## 鼠标中键可以点击界面 OSD 按钮，会显示播放列表，字幕列表，音轨列表等的。 MBTN_LEFT ignore # <无操作> [左键-单击] MBTN_LEFT_DBL cycle fullscreen # 切换 全屏状态 [左键-双击] MBTN_RIGHT cycle pause # 切换 暂停状态 [右键-单击] MBTN_RIGHT_DBL quit # 关闭MPV程序 [右键-双击] WHEEL_UP add volume 10 # 音量 + 10 [滚轮-向上] WHEEL_DOWN add volume -10 # 音量 - 10 [滚轮-向下] MBTN_MID cycle fullscreen # 切换 全屏状态 [中键（按压滚轮）] f cycle fullscreen # 切换 全屏状态 ENTER cycle fullscreen # 切换 全屏状态 [回车键] LEFT seek -5 # 后退05秒 [方向左键] RIGHT seek 5 # 前进05秒 [方向右键] UP seek 40 # 后退40秒 [方向上键] DOWN seek -40 # 前进40秒 [方向下键] . frame-step # 下一帧 , frame-back-step # 上一帧 [ add speed -0.1 # 播放速度 -（最小0.01） ] add speed 0.1 # 播放速度 +（最大100） { multiply speed 0.5 # 播放速度 半减 } multiply speed 2.0 # 播放速度 倍增 ; add chapter -1 # 章节 - (Page Down 也可以) ' add chapter 1 # 章节 + (Page Up 也可以) q quit-watch-later # 关闭MPV程序 稍后观看（保存当前文件状态） Q quit # 关闭MPV程序 z add sub-delay -0.1 # 字幕同步 预载100ms Z add sub-delay -1 # 字幕同步 预载1000ms x add sub-delay +0.1 # 字幕同步 延迟100ms X add sub-delay +1 # 字幕同步 延迟1000ms i script-binding stats/display-stats # 临时显示统计信息（此时12340翻页，2/4/0页可方向上下键滚动查看） I script-binding stats/display-stats-toggle # 开/关 常驻显示统计信息 TAB script-binding stats/display-stats-toggle # 开/关 常驻显示统计信息 ` script-binding console/enable # 进入控制台（此时Esc退出） DEL script-binding osc/visibility # 切换 内置OSC的可见性 r cycle_values video-rotate 90 180 270 0 # 旋转屏幕方向 ```

mpv.net

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

PotPlayer

PotPlayer * 提示 `渲染 Pin 失败` 无法播放。或者日志提示 `KeyError: 'stream.mkv'` 或者 `pot stop, stop_sec=None` 或者 `请求的操作需要提升` 解决方案： 按以下依次修改，每次修改后尝试播放，还不行就无解，欢迎 PR。 1. 初始化 PotPlayer 设置。 2. 换 Pot 为 20240618 版本。 3. 换 Pot 为 最新版本 版本。 4. 本地用户查看`通用 FAQ` > `如何切换模式` 使用读盘模式。 5. 换 mpv 测试此否正常播放。 240618 版本下载链接。 [potplayer-1-7-22286.exe (v240618)](https://potplayer.en.uptodown.com/windows/download/1018490678) | [Scoop](https://github.com/ScoopInstaller/Extras/blob/108f0c0d42347a1cb9a16d8effdad09a7059c22b/bucket/potplayer.json#L11-L12) | [winget](https://github.com/microsoft/winget-pkgs/blob/d7aa02cfe97624c51a005b3c7ac42f05f205aff5/manifests/d/Daum/PotPlayer/240618/Daum.PotPlayer.installer.yaml#L84-L85) sha256sum `66d03fc13f4949948890675cf62b839b704b542a34a13a180466f93be20d5bc6` * 本地用户可考虑：[MPC-HC](https://github.com/clsid2/mpc-hc/releases) 自带 LAV，同样支持 madVR MPCVR BFRC 等。 网络用户或没有特殊需求的话，mpv 系的播放器综合体验较好。 * [可选] 选项 > 播放 > 播放窗口尺寸：全屏 * 配置/语言/其他 > 收尾处理 > 播放完当前后退出（触发回传进度） * 若使用 http 播放，可能提示地址关闭。Win8 32bit 碰到。 解决方案：本地用户使用读盘模式，或者换 pot 便携版。 安全性未知：[PotPlayerPortable-220914.zip](https://www.videohelp.com/download/PotPlayerPortable-220914.zip) 先打开 `PotPlayerPortable.exe` 一次，但播放用 `C:\\PotPlayerPortable\App\PotPlayer\PotPlayer.exe` 不然会要求管理员权限运行。 * 读盘模式可能和美化标题和混合S0的功能冲突，不过不影响使用。（FAQ > 隐藏功能 有解决方案）

其他播放器

其他播放器 > MPC： * 会自动开启 WebUI，系统防火墙提示的时候可以拒绝（不影响使用）。 * 会自动开启 WebUI，建议仅允许从 localhost 访问： 查看 > 选项 > Web 界面： 打勾 仅允许从 localhost 访问 * MPC 播放 http 具有加载和拖动慢，视频总时长可能有误的缺点。 以及点击关闭播放器后，进程可能残留在后台。 * MPC 播放 http 无外挂字幕： MPC-HC 设置 > 回放 > 输出 > 字幕渲染器 > 内部字幕渲染器 MPC-BE 设置 > 字幕 > 字幕渲染器 > 内部字幕渲染器 > IINA * 播放完不完全退出会影响进度回传和静态管道名称配置。 解决方法：`设置` > `通用` 启用 `没有打开的窗口时退出` 禁用 `播放完成后保存窗口打开` * 非读盘模式不支持播放列表。

bgm.tv / trakt.tv 存储记录 ### bgm.tv / trakt.tv 存储记录 > 通用 FAQ * Clash for Windows 用户： * 日志报错：`SSLEOFError(8, 'EOF occurred in violation of protocol (_ssl.c:1129)'))` * 解决方案：Clash > Settings > System Proxy > Specify Protocol > 启用。 * 使用含 Python 的便携版用户无需安装依赖。其他用户需要安装：命令行终端运行，安装失败尝试在启用或禁用代理的环境来安装： `python -m pip install requests` 或者： `python -m pip install requests -i https://mirrors.aliyun.com/pypi/simple/ --trusted-host=mirrors.aliyun.com` > bangumi.tv（bgm.tv） 单向同步（点格子） * 缺点： 1. 只能往 Bangumi 单向同步。 2. 只在播放器正常关闭后，同步播放器已播放的（网页点击已播放不触发）。 3. 只支持常规剧集，不支持剧场版等。 * 使用说明： 1. 访问并创建令牌 [https://next.bgm.tv/demo/access-token](https://next.bgm.tv/demo/access-token)： 复制令牌到 ini 配置文件 `[bangumi]` 部分，` access_token = ` 里 2. ini 配置文件 `[bangumi]` 填写 `enable_host` `user_name` 这两项。 3. 启动脚本，播放一集动漫，拖到最后，关闭播放器。看日志是否同步成功。 * 常见问题： 1. 5季或者90集以上的条目暂不支持。 2. 日志提示 `Unauthorized` 一般是令牌过期或者没填对，Windows 会自动弹出令牌生成页面。 3. 集上映日期匹配方案：在常规搜索失败后采用，此时无视季和集数对应，只要 Emby bgm 集上映日期相差两天(含)内就匹配成功。 4. 由于 `bgm.tv` 的 `续集` 不一定是下一季，导致第几季可能关联错误（经下面处理后概率低）。 目前把 `续集` 里：集数大于3，同时第一集的序号小于2的 `续集` 当作下一季的开始。 且只保留类型为 TV 的续集（`类型在标题右侧灰字`），跳过类型为 OVA 剧场版 WEB 等的。 例外：如果第一季是 WEB，则续集不会跳过 WEB。 如果同步的集序号小于12（不会是分批次放送），还会核查 Emby 里的季上映时间（一般是 TMDb 的时间）与 bgm.tv 的上映时间相差是否超过15天，来保证准确性。 Plex 是核查集上映时间与 bgm.tv 的季上映时间相差是否超过180天，来保证准确性。 如果还有其他特殊情况，可以反馈。 > trakt.tv 单向同步 * 缺点： 1. 媒体服务器一般本身就有 Trakt 插件。 2. 只能往 Trakt 单向同步。 3. 只在播放器正常关闭后，同步播放器已播放的（网页点击已播放不触发）。 4. 配置和使用都麻烦。 * 使用说明： 1. [点击访问：Trakt app 管理页面](https://trakt.tv/oauth/applications)： 创建 app，名字任意，Redirect uri 填写: `http://localhost:58000/trakt_auth` ，然后保存。 2. ini 配置文件`[trakt]` 填写 `enable_host` `user_name` `client_id` `client_secret` 这四项。 3. 启动脚本，会自动跳验证页面。或者自行点击 app 详情页面的 `Authorize` 按钮，二次同意后，网页会显示 `etlp: trakt auth success`。etlp 目录下会自动生成 `trakt_token.json` 4. 播放一个视频，拖到最后，关闭播放器。看日志是否同步成功。 * 常见问题： 1. 若同步失败。电影看是否缺失IMDb，剧集看单集下方是否有 IMDb 或 TheTVDB。
其他 ### 其他: > Jellyfin 相关 * 首页播放结束后，10秒内重复播放**同文件**，本地播放器收到的播放时间会有误。 解决方法： 1. 进详情后再播放没这问题；~~说明不是我的锅~~ 2. 等待10秒后再继续播放； 3. 手动刷新页面后播放； 4. ~~告诉我要发送什么请求可以解决这个问题~~ * 未适配主题曲功能，会有无法二次播放的问题。 > Plex 相关 * 可能 dns 污染，若无法播放。修改系统 DNS 或使用代理。 > 感谢 * [iwalton3/python-mpv-jsonipc](https://github.com/iwalton3/python-mpv-jsonipc)
隐藏功能（一般用不到 / 配置麻烦 / 无支持） ### 隐藏功能（无支持）:
替换媒体标题字符（高版本 Pot 渲染 Pin 失败） * 问题：标题含空格或者个别半角符号，会导致 pot 无法从命令行启动，无法播放。 * 解决方案：把半角单双引号替换为全角，空格替换为连字符。是以下配置的默认行为。 * 填写位置：`.ini` > `[dev]` ``` # 此功能可能产生其他问题，建议仅在 pot 中使用。 # 谨慎配置，只接受单个字符，全角逗号隔开，成对填写。 # 不要有多余的空格引号，注意分隔符是全角的逗号。 media_title_translate = '，＇，"，＂， ，- ```
本地 重定向/替换 播放地址 > 本地 重定向/替换 播放网址 * 本地替换播放网址，减少网络重定向，加速访问。 * alist strm 用户替换 alist 服务地址：解决网盘不支持302时，在外播放受 nas 上传速度限制。 此时需要填写 `strm_direct_host` 及本机运行 alist。注意要带端口，不然会变成替换 emby 的服务器地址。 * 使用预读取下一集的用户：nginx 可以只反代视频流。浏览器访问源站，重定向视频流交给本机。降低 nginx 配置难度。减少 bug。 * 填写位置：`.ini` > `[dev]` ``` # 网址之间逗号隔开，成对填写。原始网址, 新网址。 stream_redirect = http://src.src.com, http://reverse.proxy.com, http://192.168.1.1:5244, http://127.0.0.1:5244 ```
strm 局域网同步播放进度 * 问题：strm 文件因为缺少时长信息，emby 不存储播放进度，导致无法继续播放。 * 内置方案：单机运行 etlp 时，会临时储存在内存。关闭脚本进度丢失。（默认已启用，无需配置本功能） * 局域网方案：同时在 nas 或者其他服务器运行 etlp，播放时会向服务器的 etlp 查询和存储播放时间。需要确保服务器长期运行。 * 服务器 eltp 填写位置：`.ini` > `[dev]` ``` # 是否仅监听本机地址，会更安全，但无法与让其他 etlp 通讯。在服务器运行时需要改为 no。 listen_on_localhost = no ``` * 客户端 eltp 填写位置：`.ini` > `[dev]` ``` # 在服务器运行的 eltp 通讯监听地址，例如：http://192.168.1.23:58000 # 限客户机填，服务器取消监听本机地址即可，服务器的日志会有提示。 server_side_href = ```
mpv 传递数据给 lua 脚本 * 通过 `script-message` 传递部分数据给 mpv，以便其他脚本使用。 * `'script-message', 'etlp-cmd-pipe', cmd_pipe` : 命令行 ipc 管道名称。 * `'script-message', 'etlp-playlist-data', playlist_data` : emby 的播放列表数据。 * `'script-message', 'etlp-playlist-done'` : 表明 mpv 播放列表已添加完成。 * 填写位置：`.ini` > `[dev]` ``` # 播放列表数据较大，默认不传递。若需要启用，则填写此项。 mpv_ipc_playlist_data = yes ```
mpv 自动跳过片头片尾 * 播放时检查视频章节时长与标题，符合条件时自动跳过该章节或仅提示。 * 前提： * Emby 成功扫描片头。（测试：禁用脚本，用网页播放时有跳过片头按钮） * 或者视频文件自带片头片尾章节。（若章节的标题标准会更准确，例如 "Opening"） * 原理：视频文件本身无章节时，脚本会自动给 mpv 加片头章节。并在播放时候检测。 * 填写位置：`.ini` > `[dev]` ``` # 片头有90秒，片尾有91秒，允许5秒钟的误差，片头在前30%里，片尾在70%以后，片头片尾可能的章节名称（逗号隔开，辅助判断，不分大小写） # 若要禁用就删除掉，或者在前面加 # 号注释掉。mpv 章节跳转快捷键是 ; ' Page Up Page Down # 若含有特殊值 hint_only（可删除），为启用仅提示模式，不自动跳过。需要跳过就按章节跳转快捷键。 skip_intro = 90, 91, 5, 30, 70, opening, ending, op, ed, hint_only ```
mpv bangumi trakt 独立同步脚本 > mpv bangumi trakt 独立同步脚本 * 使用情景：不想用本工具网页调用播放，但也想标记 bangumi trakt 中对应条目为已观看。 * 条件：mpv 播放器，播放网络视频流，播放进度超过 90% 时同步。 * 使用方法： 1. 下载 `etlp-python-embed-win32.zip` 并解压到任意文件夹。 （之前就在用本脚本的，更换为便携版，不要运行两份。或者参考 `FAQ > 观看记录存储服务相关` 自行安装 Python 和依赖。） 2. 将 lua： `刚才解压的文件夹\utils\others\etlp_sync_bgm_trakt.lua` 移动至 mpv 的脚本文件夹。 例如：`mpv.exe 所在目录 > portable_config > scripts > etlp_sync_bgm_trakt.lua` 3. 修改 `etlp_sync_bgm_trakt.lua` 内 etlp 的保存目录（刚才解压的文件夹路径） 4. 参考上方 `FAQ > 观看记录存储服务相关` 修改配置文件：`embyToLocalPlayer_config.ini` 5. 参考 `隐藏功能 > 预读取继续观看` 设置 `[dev] > server_data_group`。用于获取`user_id` 6. 播放一个视频，进度拖到 90% 以上，查看 etlp 日志：`刚才解压的文件夹 > log.txt`。或者查看 mpv 日志。 * 排错方法：使用本项目浏览器调用播放测试。
预读取下一集 > 预读取下一集 * 预读取并丢弃下一集首尾文件数据，加速集数切换播放。 * 需要配合 nginx 反代管理缓存，比较麻烦。(在本机或者 nas 运行一个 nginx，缓存并切片视频流) 读取并丢弃 首8% 尾2% 的数据。按理 rclone 配置缓存也可以，但实测效果不佳。 * 浏览器访问局域网的反代站，或配合 本地 重定向/替换 播放网址。才能起到缓存效果。 * 填写位置：`.ini` > `[playlist]` ``` # 播放进度超过 50% 时触发预读取，预读取下一集。 prefetch_percent = 50 # 服务端路径包含以下前缀才预读取，逗号隔开，全部启用就留空或删除。 prefetch_path = /disk/od/TV, /disk/gd # 启用本功能的域名的关键词，逗号隔开。全部启用就留空或删除。 prefetch_host = ``` * 网盘和本地硬盘混合使用的话。[可选] 配置本地文件用读盘模式：`.ini` > dev > force_disk_mode_path * 用自签证书反代 https 的站，可以仅反代视频流，并配置跳过证书验证。`.ini` > dev > skip_certificate_verify 不过部分播放器也会校检证书，这个需要自行解决。
预读取继续观看 > 预读取继续观看 * 类似预读取下一集。仅处理最近上映的集（7天内），适合追更。 * 尝试获取 strm 文件的媒体信息，加速起播。 * [可选] 在不关机的机器里配置并运行更合适一点。 * 填写位置：`.ini` > `[dev]` ``` # 服务器信息，各项之间逗号隔开，最后分号结尾。复数服务器需要配置就分号后面继续写。 # api_key：设置 > API 密钥。user_id：设置 > 用户 > [用户名] > 看浏览器网址。 server_data_group = myself, http://localhost:8096, api_key, user_id; others, https://www.abc.org, api_key, user_id; # 配置格式：上方配置的服务器名，一个或者多个服务端媒体路径前缀，复数服务器同样分号隔开。 # 服务端路径包含路径前缀才预读取，全部就写 / # strm 是特殊值，只用来刮出媒体时长信息。此时无视上映时间和路径限制。 prefetch_conf = myself, strm, /, /od/另一个路径前缀; ``` * 若需要 nginx 缓存：网址填反代站。如果填源站，需要配置上方的重定向视频流到反代站。 注意播放链接与预读取链接不一致。 `proxy_cache_key "$arg_MediaSourceId$slice_range";`
追更 TG 通知 > 追更 TG 通知 * 继续观看更新时，通过 Telegram 机器人发送通知。（每10分钟检测一次） * 前置依赖：启用 预读取继续观看。 * 填写位置：`.ini` 顶部或底部（单独的配置区域即可，不要填到别的配置里） ``` ################################################################## ### v v # # # # # # # # 追更 TG 通知 # # # # # # # # # # # v v ### [tg_notify] # 找 @BotFather 创建一个机器人。复制并填写 token。 bot_token = # 点击你创建的机器人，然后点击开始或随便发送信息给你的机器人，最后启动本脚本。机器人会告诉你 chat_id。 chat_id = # chat_id 填写后，重启脚本，会自动测试，提示测试成功的话，本项可以关闭。 get_chat_id = yes # 如果不需要预读取服务，仅通知。就启用本项。 disable_prefetch = no # 静音通知时间段，范围间逗号隔开。例如：0-9 0点后9点前。类似针式时钟的时间范围。 silence_time = 0-9, 12-14 # [可选] 可指定 api, 自行搜索 "TG Bot API 反代", 解决网络连接问题。 base_url = https://api.telegram.org ```
持久性缓存 > 配置方法 * 填写位置：`.ini` 顶部或底部（单独的配置区域即可，不要填到别的配置里） ``` ################################################################## ### v v # # # # # # # 持久性缓存（边下边播） # # # # # # # # v v ### [gui] # 未适配播放列表，不接受播放列表相关问题反馈，建议禁用播放列表使用。 # 是否需要缓存文件到本地硬盘，播放时会弹菜单。油猴不用开读取硬盘模式。 enable = no # 缓存路径：NTFS 支持不很理想，解决方法详见下方 FAQ cache_path = D:\cache # [可选] 在服务端文件路径包含指定关键词时才弹菜单，否则直接播放。关键词间逗号隔开。 enable_path = # 当播放进度超过 98% ，此时若关闭播放器，则删除缓存。禁用填 100 delete_at = 98 # 缓存超过 100GB 时删除旧缓存。 cache_size_limit = 100 # 重启后是否自动开始下载未完成任务 auto_resume = no # 下载时的代理，用不到就留空。 http://127.0.0.1:7890 http_proxy = # 需要禁用 gui 的域名：所包含的字符串列表，逗号隔开，将根据油猴设置直接播放。 except_host = localhost, 127.0.0.1, 192.168. , 192-168-, example.com:8096 ``` > 持久性缓存（边下边播）FAQ * 如果播放进度超过下载进度，建议关闭播放器触发回传以保存播放进度。（以下为 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. 下载管理器
弹弹播放器 > 配置方法 * 填写位置：`.ini` 顶部或底部（单独的配置区域即可，不要填到别的配置里） ``` ################################################################## ### v v # # # # # # # # # 弹弹播放器 # # # # # # # # # # # # v v ### [dandan] # 弹弹play 动漫弹幕播放器支持。 # 播放器需开启远程访问和自动加入媒体库。以及 设置 > 文件关联 > 修复弹弹play专用链。 # 总开关： no 禁用，yes 启用。 enable = no # 播放器路径 exe = C:\Green\dandanplay-x64\dandanplay.exe # 远程访问端口。远程访问里 ip 改为 127.0.0.1 会比较安全。 port = 80 # 若远程访问曾经启用过 Web验证，请在这里填写 api密钥，没设置则留空。（注意不是密码） api_key = # 仅当服务端路径包含以下路径时使用弹弹播放，逗号隔开。全部文件都用弹弹播放就留空或删除。 enable_path = /disk/od/TV, /disk/e/anime, 路径的部分字符也可以, anime # 通过 http 播放时，是否控制开始时间。需等待播放15秒。 http_seek = yes ``` > 弹弹play FAQ * 弹弹 api 服务需要10秒左右启动，播放时间太短可能会回传失败。 * 播放器需开启远程访问和自动加入媒体库。以及 设置 > 文件关联 > 修复弹弹play专用链。 * 若通过 http 播放，有以下缺点： 1. 每次播放需要选择弹幕。（已把文件名发送给播放器匹配） 2. 启动时无法及时跳转到 Emby 开始时间，需要播放开始后等待15秒。（每次看完一集则不影响） 3. 无法加载外挂字幕。 * 读盘模式：解决切换设备播放时，进度不一致（读盘模式进度由弹弹存储），同步策略： 当 Emby 上的进度大于120秒，但弹弹播放器进度小于30秒时（且 api 启动后未曾超过120秒）， 会调整弹弹播放器进度，使其与 Emby 上的一致，需等待 api 启动。
Pot 读盘模式时：播放列表以 Emby 为准 / 美化播放列表标题 * 修复情景： 1. Pot 读盘模式：播放动漫第一季，会漏播 Emby 穿插的 S0 集数。 2. Pot 读盘模式：Emby 上创建的播放列表无法传递给 Pot。 3. Pot 读盘模式：剧集播放列表标题错位/缺少。 * 前提条件二选一： 1. Pot 选项 > 配置 > 用当前方案创建 > 改配置文件名称为 `emby`（用脚本播放时会自动切换为该配置）: Pot 选项 > 左上角切换配置为 emby > 基本 > 相似文件打开策略 > 仅打开选定的文件 > 确定 > 关闭。（仅 emby 播放时由脚本添加播列表） 2. Pot 选项 > 基本 > 相似文件打开策略 > 仅打开选定的文件。（缺点：用文件管理器播放无播放列表） * 填写位置：`.ini` > `[dev]` ``` # 启动 Pot 的时候指定配置文件的名称，不需要就清空。 # 若指定的配置名称不存在，Pot 会回退使用重置后的初始配置。 pot_conf = emby ``` * 填写位置：`.ini` > `[playlist]` ``` # 解决 Pot 读盘模式漏播第零季选集及播放列表标题错位/缺少，播放列表加载会变慢，每秒1集。 mix_s0 = yes ``` * 播放的第一个文件是 S0 的话，会连续播 S0。（通用 Bug，换 mpv 也会这样）
使用其他版本视频的字幕 * 效果示例：把 1080p 版本的内封字幕提取出来给 2160p 的无字幕视频使用。 * 触发条件：视频含多版本，当前版本的视频无外挂字幕，且内封字幕标题无下方配置所包含字符时。 * 解决方案：播放时，提取其他版本视频内，符合下方语言偏好的字幕，给当前版本视频使用。 * 填写位置：`.ini` > `[dev]` ``` # 视频含多版本且字幕标题不包含下方字符时，提取其他版本视频的字幕供当前视频使用。下方配置字母需小写。选项逗号隔开，前面优先。 sub_extract_priority = 中英特效, 双语特效, 简中特效, 简体特效, 特效, 中上, 中英, 双语, 简, simp, 中, chi ```