全面支持Emby/Jellyfin/Plex调用外部播放器，还能自动回传播放记录！

NAS除了作为家庭照片备份、文件资料存储之外，另一大玩法就是搭建媒体服务器，其中Emby、Jellyfin和Plex作为影音三剑客，几乎是圈内人士的标配了。今天介绍的这个工具可以作为三剑客的补充：调用外部播放器播放影音，并记录播放记录。

工具名称为embyToLocalPlayer，简称etlp，虽然名字带emby，实际也支持jf和plex，是Github上的一个开源项目，支持Windows、macOS和Linux三大平台。

🎭 功能特性

• 首页可以直接播放，只需点击原播放按钮即可，可配置版本优先级（若视频多版本）。

• 支持播放列表（连续播放）支持，下一集保持相同版本。

• 支持trakt.tv bangumi.tv bgm.tv 单向标记已观看支持。

• 本地挂载时，可跳转到路径对应文件夹，按钮在网页显示文件路径的上面。

• 未适配的播放器一般也能用，只是不会回传进度。

• 可在 qb的 WebUI 里直接播放或者跳转到路径对应挂载文件夹（需要使用油🐒安装qbittorrent_webui_open_file脚本）。

• 支持mpv系（体验最好）、PotPlayer、MPC-HC、MPC-BE、mpv.net、VLC和IINA等播放器。

🎨 使用方法

工具下载地址请见文末，笔者先介绍下配置和如何使用etlp。

一. 基础配置

1. Windows专属：etlp-python-embed-win32.zip（便携版）或 etlp-mpv-py-embed-win32.zip（含mpv播放器）

2. 通用版本：embyToLocalPlayer.zip (Windows / Linux / macOS)

3. 将以上下载的文件解压到任意文件夹。

4. 进入文件夹，修改配置文件embyToLocalPlayer_config.ini中的播放器路径，并选择想要使用的播放器（若使用含mpv便携版，则无需修改）。
   

5. 安装Python(若使用便携版，则无需安装，安装时勾选 add to path) 。Python 最低支持版本为 3.8。附上Python官网地址：https://www.python.org/downloads/。
   

6. 安装油🐒embyToLocalPlayer脚本，并刷新 Emby 页面。
   

二、Windows平台配置

1. 双击embyToLocalPlayer_debug.bat，主要不要右击以管理员身份运行。

2. 若无报错，按1（不要关闭窗口），然后网页播放测试（点击原来的播放按钮就可以）。

3. 按2则创建开机启动项并后台运行（隐藏窗口运行）。

以下是可能出现的一些问题及排查方法：

• Windows 最低支持版本为 8.1。

• 若双击 .bat 就提示找不到 Python，请使用便携版或先安装Python。

• 若碰到播放器无法播放，请使用包含 mpv 的便携版或先安装支持的播放器。

• 若自启失败，检查启动项是否被禁用，若被禁用，请启用。

• 运行embyToLocalPlayer_debug.bat，按3,查看开机文件夹里面embyToLocalPlayer.vbs是否被杀毒软件删了。

• 若被删，可以自己创建vbs，然后双击测试是否正常后台运行，vbs 模板为

CreateObject("Wscript.Shell").Run """<Python所在文件夹>python.exe"" ""<脚本所在文件夹>embyToLocalPlayer.py""" , 0, True

三、macOS平台配置

1. 在解压的文件夹上右击，选择新建位于文件夹的终端窗口，输入chmod +x *.command 回车。

2. 双击emby_script_run.command，若无报错，可播放测试。

3. 如果弹出无法打开“emby_script_run.command”，因为它来自身份不明的开发者。，请到设置->隐私与安全性->安全性中，点一下仍要打开即可。
   

开机自启（无窗口运行）方法：

1. 方法一：直接进入下一步，适用于 Monterey 12 及之前的老版本系统。方法二：在终端使用 Homebrew安装screen（ brew install screen）。

2. 启动台 -> 自动操作 -> 文件 -> 新建 -> 应用程序 -> 运行 Shell 脚本，然后把emby_script_run.command（方法一）或emby_script_run_via_screen.command（方法二）拖进去。

3. 继续点击运行后测试播放 -> 文件 -> 存储，取名并保存到应用程序。

4. 从启动台找到刚才保存的应用，双击后台运行后再次播放测试。

5. 系统偏好设置 -> 用户与群组 -> 登录项，并添加刚才的应用。

6. 如果Monterey 12.6.6状态栏有齿轮，把文件拖入的操作替换成写以下内容，注意更改目录为你保存的目录。

cd ~/App/embyToLocalPlayer && nohup ./emby_script_run.command > run.log 2&>1 &

四、Linux平台配置

Linux平台的配置比较简单：

1. apt install python3-tk（没报错不装也行）。

2. 添加emby_script_run.command 执行权限，并用终端打开。

3. 正常播放后，加入开机启动项（无窗口运行）， Debian_Xfce：设置 -> 会话和启动 -> 应用程序自启动。

注意：只能使用用图形界面的自启动功能。利用 systemd 自启弹不出播放器，应该是权限或者环境等问题。

🛫 起飞吧

以上各平台启动服务器后，观察终端日志，出现serving at 127.0.0.1:58000表示服务已经启动成功。

最后，打开你的Emby/Jellyfin/Plex，随便点击一个视频播放，就可以自动调用你设置的播放器进行播放啦。点击播放按钮后，网页闪一下是自动关闭兼容流提示，可以不用管他，

⏬ 获取embyToLocalPlayer

embyToLocalPlayer支持Windows、macOS、Linux平台，可以在笔者公众号私信【etlp】即可快速获取下载链接，打开后根据自己的平台下载即可。