解锁Emby/Jellyfin媒体播放新境界本地播放器深度集成与进度同步完全指南【免费下载链接】embyToLocalPlayeretlp - Emby/Jellyfin 调用外部本地播放器并回传播放记录。适配 Plex。项目地址: https://gitcode.com/gh_mirrors/em/embyToLocalPlayer你是否厌倦了Emby、Jellyfin或Plex内置播放器的限制想要使用自己熟悉的PotPlayer、mpv或VLC却又不想放弃媒体库的观看进度同步功能embyToLocalPlayer正是解决这一痛点的完美工具。这个开源项目让你能够在Emby/Jellyfin网页中直接调用本地播放器同时自动回传播放记录到媒体服务器实现播放器自由与进度同步的双重体验。 核心功能亮点不只是简单的播放器调用多播放器无缝切换支持embyToLocalPlayer支持市面上几乎所有主流播放器包括mpv系列、PotPlayer、MPC-HC/BE、VLC以及macOS上的IINA。通过简单的配置文件修改你可以轻松切换默认播放器。项目提供了embyToLocalPlayer_config.ini配置文件让你可以灵活配置各种播放器路径[exe] mpv C:\Green\mpv\mpv.exe pot C:\Program Files\DAUM\PotPlayer\PotPlayerMini64.exe vlc C:\Green\vlc\vlc.exe iina /Applications/IINA.app/Contents/MacOS/iina-cliembyToLocalPlayer与Emby完美集成在播放界面显示详细的媒体信息和豆瓣评分智能播放进度同步机制最令人印象深刻的是其播放进度同步功能。当你使用本地播放器观看影片时工具会实时记录播放位置并在播放器关闭时自动同步到媒体服务器。这意味着你可以在电脑上用PotPlayer观看电影关闭播放器后进度自动保存到Emby服务器在手机或电视上继续从上次停止的位置观看这种无缝的进度同步体验让本地播放器的强大功能与媒体服务器的便利性完美结合。高级播放列表管理embyToLocalPlayer支持连续播放功能能够自动加载下一集并保持相同版本。这对于追剧用户来说极为便利无需手动选择每一集。配置文件中的播放列表设置允许你精细控制[playlist] enable_host local, 127.0, 192.168, 192-168-, example.com:8096 version_filter 720|1080|2160|4k|remux|hevc|265|264 item_limit -1 安装配置三步完成部署第一步安装浏览器扩展首先需要安装用户脚本管理器推荐使用Tampermonkey或Violentmonkey。然后安装embyToLocalPlayer的用户脚本该脚本会在Emby/Jellyfin网页中添加调用本地播放器的功能。第二步下载并配置后端服务从项目仓库下载最新版本git clone https://gitcode.com/gh_mirrors/em/embyToLocalPlayer根据你的操作系统选择对应的版本Windows用户推荐使用etlp-mpv-py-embed-win32.zip包含mpv播放器跨平台用户使用embyToLocalPlayer.zip需要Python环境第三步编辑配置文件复制配置文件模板并编辑embyToLocalPlayer_config.ini[emby] player mpv # 选择你喜欢的播放器 update_progress yes # 启用进度回传 fullscreen yes # 自动全屏 [src] # 服务器端路径前缀 a /mnt/disk1/media [dst] # 本地路径前缀 a D:\Media集成Bangumi功能自动同步番剧观看进度到bgm.tv实现跨平台追番记录管理 高级功能探索路径转换与本地文件访问如果你的媒体文件同时存在于服务器和本地可以启用读取硬盘模式。这种模式下工具会将服务器路径转换为本地路径直接从本地硬盘播放避免网络传输延迟[src] a /mnt/nas/media/movies b /mnt/nas/media/tvshows [dst] a E:\Media\Movies b F:\Media\TVShows第三方服务集成embyToLocalPlayer支持与bangumi.tv和Trakt.tv同步观看记录。这意味着你的观看历史可以自动同步到这些第三方服务[bangumi] enable_host localhost, 127.0.0.1 username your_bgm_username access_token your_bgm_token [trakt] enable_host example.com:8096 user_name your_trakt_username client_id your_client_id client_secret your_client_secret下载完成自动播放与qbittorrent WebUI集成实现下载完成后的自动播放功能。通过安装qbittorrent_webui_open_file.js脚本可以在下载完成后直接调用本地播放器qBittorrent WebUI集成下载完成后显示打开播放按钮一键启动本地播放器⚙️ 技术实现深度解析HTTP服务器架构embyToLocalPlayer的核心是一个本地HTTP服务器默认运行在127.0.0.1:58000它作为浏览器脚本与本地播放器之间的桥梁。当你在Emby网页点击播放时用户脚本拦截播放请求向本地HTTP服务器发送媒体信息HTTP服务器启动本地播放器并传递播放参数播放器关闭时进度信息回传到HTTP服务器HTTP服务器更新Emby服务器的播放进度播放器接口统一化项目通过utils/players.py模块实现了对不同播放器的统一接口封装。每个播放器都有对应的启动函数和进度获取函数# 播放器启动函数示例 def mpv_player_start(cmd, start_secNone, sub_fileNone, media_titleNone, get_stop_secTrue, mount_disk_modeNone): # 启动mpv播放器 pass def pot_player_start(cmd: list, start_secNone, sub_fileNone, media_titleNone, get_stop_secTrue): # 启动PotPlayer pass配置管理系统utils/configs.py模块提供了强大的配置管理功能支持动态配置加载、路径转换、播放器选择等。配置文件采用INI格式支持复杂的条件匹配和路径映射。 故障排除与优化技巧常见问题解决方案播放器无法启动问题检查播放器路径是否正确Windows注意使用双反斜杠确保播放器支持命令行参数查看日志文件./log.txt获取详细错误信息进度同步失败处理确认Emby API密钥和用户ID配置正确检查网络连接是否正常增加同步频率[emby]部分设置update_progress yes播放列表相关问题确保播放器支持播放列表功能检查版本过滤规则是否过于严格查看播放器是否支持外挂字幕的连续播放性能优化建议启用路径转换缓存对于经常访问的媒体路径启用缓存可以显著提升启动速度调整同步间隔根据网络状况调整进度同步频率使用本地文件模式如果媒体文件在本地有副本优先使用本地路径播放合理配置播放器参数根据硬件性能调整播放器启动参数 实际应用场景家庭媒体中心部署在家庭NAS上部署Emby/Jellyfin服务器配合embyToLocalPlayer实现在客厅电视上使用Kodi观看在书房电脑上使用mpv观看在卧室平板上使用内置播放器观看 所有设备共享同一观看进度多版本媒体管理对于收藏了多种版本如1080p、4K、Remux的影视作品embyToLocalPlayer的版本过滤功能可以确保连续播放时保持相同画质版本[dev] version_prefer remux, 4k, 1080p, web-dl跨平台追番系统结合Bangumi同步功能实现在Emby中观看动漫自动标记bgm.tv上的观看进度在手机App上查看追番进度多设备间无缝切换观看️ 进阶配置与自定义自定义播放器参数你可以在配置文件中为不同播放器添加自定义参数[dev] # mpv额外参数 mpv_args --hwdecauto --vogpu-next # PotPlayer额外参数 pot_args /seek0 /fullscreen智能字幕处理embyToLocalPlayer支持智能字幕选择可以根据语言偏好自动选择字幕[dev] subtitle_priority 中英特效, 双语特效, 简中特效, 简体, 中, chi, eng网络优化配置对于网络环境复杂的用户可以配置代理和缓存策略[dev] use_system_proxy yes script_proxy http://127.0.0.1:7890 player_proxy http://127.0.0.1:7890 最佳实践建议系统兼容性优化Windows用户推荐使用便携版mpv避免系统环境问题macOS用户使用IINA播放器获得最佳体验Linux用户通过flatpak安装mpv确保版本兼容性播放器选择指南追求极致性能选择mpv轻量级且高度可定制需要图形界面选择mpv.net或PotPlayer跨平台需求VLC是最佳选择macOS用户IINA提供最佳原生体验维护与更新策略定期检查项目更新新版本可能修复重要问题备份配置文件避免更新时丢失自定义设置参与社区讨论分享使用经验和问题解决方案结语重新定义媒体播放体验embyToLocalPlayer不仅仅是一个简单的播放器调用工具它代表了媒体播放体验的进化方向。通过打破服务器内置播放器的限制它为用户提供了播放器选择的完全自由跨设备进度同步的无缝体验高级功能的自定义能力开源社区的持续支持无论你是追求最佳画质的影音爱好者还是需要多设备同步的家庭用户embyToLocalPlayer都能提供完美的解决方案。现在就开始配置享受真正自由的媒体播放体验吧项目还包含更多实用工具如utils/bangumi_sync.py用于Bangumi同步、utils/trakt_sync.py用于Trakt集成、utils/gui.py提供图形界面等等待你的深入探索。【免费下载链接】embyToLocalPlayeretlp - Emby/Jellyfin 调用外部本地播放器并回传播放记录。适配 Plex。项目地址: https://gitcode.com/gh_mirrors/em/embyToLocalPlayer创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考