解放你的媒体播放：用embyToLocalPlayer打造个性化影音生态

解放你的媒体播放：用embyToLocalPlayer打造个性化影音生态

【免费下载链接】embyToLocalPlayeretlp - Emby/Jellyfin 调用外部本地播放器，并回传播放记录。适配 Plex。项目地址: https://gitcode.com/gh_mirrors/em/embyToLocalPlayer

想象一下，当你沉浸在Emby或Plex的丰富媒体库中，却受限于内置播放器的功能限制——无法使用你最爱的播放器，无法享受硬件加速，无法自定义快捷键。现在，这一切都将改变。embyToLocalPlayer作为一款开源工具，彻底打破了媒体服务器与本地播放器之间的壁垒，让你在享受服务器管理便利的同时，获得完全自由的播放体验。

场景化体验：三种典型使用场景

场景一：完美追剧体验

作为一名动漫爱好者，你每周都在追更最新的番剧。通过embyToLocalPlayer，你可以直接在Emby界面点击播放，系统自动调用本地MPV播放器，享受流畅的硬件解码和丰富的插件生态。更棒的是，播放进度会自动同步回Emby服务器，无论你在哪个设备上继续观看，都能从上次停止的地方开始。

embyToLocalPlayer与豆瓣评分系统深度集成，让你在播放时同步查看社区评价

场景二：多平台观影记录同步

你使用Bangumi追踪动画观看进度，同时在Trakt.tv记录电影观看历史。embyToLocalPlayer支持单向同步到这两个平台，当你关闭播放器时，观看记录会自动标记到Bangumi和Trakt账户。这意味着你的观影历史不再分散，所有平台的记录保持同步。

场景三：本地文件直接播放

你的媒体文件存储在NAS上，通过SMB挂载到本地。传统方式需要通过Emby服务器转码播放，消耗服务器资源。embyToLocalPlayer的路径转换功能让你直接播放本地文件，减少网络延迟，享受原画质体验。

核心能力矩阵：六大革新功能

1. 播放器自由选择

不再受限于Emby或Plex的内置播放器，你可以配置任意本地播放器：MPV、PotPlayer、VLC、IINA等。每个播放器都有其独特优势：

• MPV：开源、轻量、高度可定制
• PotPlayer：Windows平台功能全面
• VLC：跨平台兼容性最佳
• IINA：macOS原生体验

2. 智能路径转换

当服务器路径与本地路径不一致时，embyToLocalPlayer自动完成转换：

# 服务器路径到本地路径的智能映射 [src] nas_media = /mnt/nas/media cloud_drive = /mnt/cloud/movies [dst] nas_media = Z:\Media\ cloud_drive = D:\CloudMovies\

3. 播放列表连续播放

追剧时最讨厌每集结束后都要手动点下一集。embyToLocalPlayer支持播放列表功能，自动加载下一集并保持相同视频版本，实现真正的连续观看体验。

4. 跨平台进度同步

观看记录不仅同步回Emby/Plex服务器，还可以单向同步到Bangumi和Trakt.tv，满足不同平台用户的需求。

5. qBittorrent集成

在qBittorrent WebUI中直接播放下载完成的媒体文件，无需先导入媒体库再播放，大大简化了工作流程。

在qBittorrent界面中直接播放下载完成的视频文件

6. 多版本智能匹配

当视频有多个版本（如1080p和4K）时，embyToLocalPlayer可以根据配置的优先级自动选择合适版本，并智能匹配字幕轨道。

实战工作流：三步配置，解锁新体验

第一步：基础环境搭建

1. 安装Tampermonkey或Violentmonkey浏览器扩展
2. 安装embyToLocalPlayer用户脚本
3. 下载并解压embyToLocalPlayer核心程序

第二步：核心配置简化

只需修改几个关键配置项即可开始使用：

# 播放器路径配置（示例） [exe] mpv = C:\Programs\mpv\mpv.exe pot = C:\Program Files\PotPlayer\PotPlayer.exe # 播放器选择 [emby] player = mpv # 选择默认播放器 update_progress = yes # 启用进度回传 fullscreen = yes # 自动全屏

第三步：路径转换设置（可选）

如果你的媒体文件存储在本地或网络挂载：

[src] nas_movies = /mnt/nas/Movies [dst] nas_movies = M:\Movies\

性能优势对比：传统方案 vs embyToLocalPlayer

进阶应用：个性化定制方案

弹幕播放器集成

对于动漫爱好者，可以配置弹弹播放器支持，在观看时同步显示弹幕：

[dandan] enable = yes exe = C:\Green\dandanplay-x64\dandanplay.exe port = 80

自动跳过片头片尾

通过智能章节检测，自动跳过片头片尾章节：

[dev] skip_intro = 90, 91, 5, 30, 70, opening, ending

Telegram追更通知

设置Telegram机器人，在新剧集上线时自动通知：

[tg_notify] bot_token = YOUR_BOT_TOKEN chat_id = YOUR_CHAT_ID

跨设备协同生态

embyToLocalPlayer不仅是一个播放工具，更是一个完整的跨设备协同生态：

Bangumi社区界面与播放进度管理的完美结合

Windows用户：享受PotPlayer或MPV的专业播放体验，硬件解码流畅无卡顿。macOS用户：使用IINA获得原生macOS体验，或通过MPV获得统一的操作界面。Linux用户：通过Flatpak安装MPV，享受开源生态的完整支持。

常见问题快速解决

播放器无法启动？

检查配置文件中的播放器路径是否正确，确保路径中没有中文字符或特殊符号。

进度无法回传？

确认配置中update_progress = yes已启用，播放器需要正常关闭才能触发进度回传。

路径转换失败？

检查[src]和[dst]的路径映射是否正确，确保本地磁盘已正确挂载。

行动号召：立即开始你的个性化播放之旅

不要再忍受有限的播放器选择，不要再为进度同步问题烦恼。embyToLocalPlayer为你提供了完整的解决方案：

1. 立即体验：从GitCode克隆项目，五分钟完成基础配置
2. 个性化定制：根据你的使用习惯调整播放器和路径设置
3. 加入社区：分享你的使用经验，获取更多高级技巧

你的媒体播放体验不应该被限制。今天就开始使用embyToLocalPlayer，重新定义你的观影方式，享受真正自由、高效、个性化的媒体播放体验。

扩展阅读：

• 查看utils/目录下的API模块，了解如何扩展功能
• 参考user_script/中的用户脚本，学习浏览器集成方法
• 探索embyBangumi/和embyDouban/模块，了解社区集成方案

记住：最好的工具是那个能够完美适应你工作流的工具。embyToLocalPlayer正是这样的工具——它不改变你的使用习惯，只是让你的体验变得更好。

【免费下载链接】embyToLocalPlayeretlp - Emby/Jellyfin 调用外部本地播放器，并回传播放记录。适配 Plex。项目地址: https://gitcode.com/gh_mirrors/em/embyToLocalPlayer