emby-direct-player

项目概述

embyToLocalPlayer 直连版是在上游油猴脚本基础上打的补丁，多出一个「直连模式」：用浏览器自己的网络请求把 Emby 或 Jellyfin 的直链交给本机播放器，并把播放进度回传。它不需要装 Python、不需要本地常驻服务、也不用填路径映射。支持的播放器有 JRiver Media Center、MPC-HC 与 MPV，条目详情页会多出三个与原生样式一致的播放入口。

让 Emby 网页把视频直接丢给你电脑上的播放器。

主要功能

• 直连播放：脚本接管 Emby 与 Jellyfin 的播放按钮，直接拉起本机播放器而非网页播放器
• 播放器支持：兼容 JRiver Media Center、MPC-HC 与 MPV 三种播放器
• 进度回传：JRiver 与 MPC-HC 支持把播放进度回传 Emby，续播位置随后生效
• 原生样式入口：详情页在「播放/继续观看/下载」之后插入三个播放入口，沿用原生按钮样式
• 图形化设置：中继程序双击即是设置窗口，可浏览或自动扫描播放器路径、注册协议并查看日志
• 开关可控：关闭直连开关后完全恢复原版行为，改回走 Python 服务

适用人群

• 用 Emby 或 Jellyfin 搭建媒体库的用户
• 习惯用 JRiver、MPC-HC 或 MPV 观看的用户
• 不想安装 Python 与本地服务的用户

快速上手

1. 在 Tampermonkey 中导入 embyToLocalPlayer.direct.user.js
2. 打开油猴菜单的「直连播放器: 设置」，选择模式并填写播放器地址或路径
3. 双击 etlp-relay.exe 打开设置窗口，用「找找看」或「浏览」选好播放器并注册协议
4. 用菜单中的「测试连接」确认能连通
5. 打开「直连播放器」开关后，在 Emby 网页中点击播放即可拉起本机播放器

核心优势

• 无需 Python：不装 Python、不跑本地服务，也不用配路径映射
• 不留后台：中继不是常驻服务，点播放时才被拉起一次，用完即退
• 播放器自由：JRiver、MPC-HC 与 MPV 都能接管，按习惯选择
• 可进可退：关掉开关就回到原版行为，不影响原有工作流

系统要求

项目	要求
操作系统	Windows（中继为 64 位单文件程序）
浏览器	支持 Tampermonkey 的浏览器
播放器	需本机安装 JRiver、MPC-HC 或 MPV 之一

注意事项

• 只适合直链播放，Emby 转码、字幕烧录与 HLS 分片这类流交给外部播放器并不合适
• 直连开关打开时会强制拦截网页播放，想在浏览器里看需先关闭开关
• 页面关闭后不再回传进度，这是直连模式没有后台服务的代价
• MPV 没有网页界面，因此不回传进度