深度解析embyToLocalPlayer实现Emby媒体服务器与本地播放器的无缝对接【免费下载链接】embyToLocalPlayeretlp - Emby/Jellyfin 调用外部本地播放器并回传播放记录。适配 Plex。项目地址: https://gitcode.com/gh_mirrors/em/embyToLocalPlayerembyToLocalPlayer是一款强大的开源工具能够将Emby/Jellyfin媒体服务器与本地播放器无缝对接并自动回传播放记录同时支持Plex媒体服务器。通过调用PotPlayer、mpv、IINA、MPC、VLC等主流播放器实现跨平台媒体播放体验让用户享受本地播放器的强大功能与媒体服务器的便捷管理。架构设计三层分离的模块化实现embyToLocalPlayer采用三层架构设计确保各功能模块独立且高效协作1. 媒体服务器交互层核心模块utils/emby_api.py负责与Emby/Jellyfin服务器通信通过API密钥认证获取媒体信息。系统支持多种媒体类型识别包括电影、剧集、音乐视频等并能获取详细的元数据如播放地址、字幕信息、章节标记等。2. 本地播放器管理层utils/player_manager.py实现了播放器调度机制通过start_player_func_dict字典支持多种播放器start_player_func_dict { mpv: start_mpv, potplayer: start_potplayer, vlc: start_vlc, # 其他播放器... }播放器管理模块负责构建播放命令参数、启动播放器进程、监控播放状态并处理播放完成事件。智能路径转换功能可将服务器路径映射到本地挂载点实现真正的本地文件播放。3. 播放记录同步层播放进度监控通过realtime_playing_feedback_loop方法实现定期获取播放器进度并同步到服务器。当播放完成度超过90%时自动标记为已观看确保观看记录准确无误。Emby媒体库界面整合了豆瓣评分系统显示《奇巧出租车》的详细信息和播放控制选项关键技术实现细节跨平台播放器适配策略系统通过统一的播放器接口抽象屏蔽了不同播放器的命令行参数差异。对于每个支持的播放器都有专门的启动函数处理其特定参数MPV系列通过JSON IPC接口实现精确进度监控PotPlayer支持命令行参数和COM接口两种控制方式VLC/MPC通过HTTP接口或命令行参数控制IINA专为macOS优化的AppleScript控制智能播放列表管理播放列表功能支持连续播放体验下一集保持相同版本选择。系统通过playlist_add方法处理多集连续播放并实现智能跳过机制if stop_sec / ep[total_sec] 0.9: logger.info(fskip play {next_media_title}, because watch progress 0.9) break多平台记录同步机制除了Emby/Jellyfin本身系统还支持将播放记录同步到第三方平台Trakt.tv同步utils/trakt_sync.py实现与Trakt.tv的同步Bangumi同步utils/bangumi_sync.py实现与Bangumi的同步Plex适配utils/plex_api.py支持Plex媒体服务器Bangumi播放记录同步界面展示观看进度管理和社区评分功能配置文件与部署指南核心配置文件解析系统使用INI格式配置文件embyToLocalPlayer_config.ini管理所有设置[emby] host http://localhost:8096 api_key your_api_key_here user_id your_user_id_here [player] player mpv player_path C:\Program Files\mpv\mpv.exe [playlist] enable yes prefetch_percent 50快速部署步骤安装浏览器扩展安装Tampermonkey或Violentmonkey插件配置用户脚本安装embyToLocalPlayer用户脚本并刷新Emby页面下载并解压工具从发布页下载对应平台的压缩包修改配置文件根据实际情况调整服务器连接和播放器设置启动服务运行embyToLocalPlayer_debug.batWindows或etlp_run.commandmacOS/Linux跨平台部署注意事项Windows支持开机自启动可通过.bat文件创建启动项macOS通过Automator创建应用程序并添加到登录项Linux支持systemd服务或图形界面自启动配置高级功能与定制扩展智能预加载机制系统实现了媒体内容的智能预加载功能通过prefetch_next_ep_loop方法在当前剧集播放到一定进度时自动开始预加载下一集内容def prefetch_next_ep_loop(self): if position * 100 prefetch_percent: continue # 预加载逻辑...持久性缓存系统对于网络播放场景系统提供边下边播功能支持顺序下载和首尾优先下载两种模式。缓存管理包括自动清理机制和磁盘空间限制确保系统稳定运行。qBittorrent WebUI集成界面支持下载完成后直接调用本地播放器播放字幕与音轨处理系统支持外挂字幕和音轨选择内置字幕由播放器自动处理。通过配置语言偏好可以自动选择最合适的字幕轨道[dev] sub_extract_priority 中英特效, 双语特效, 简中特效, 简体特效, 特效, 中上, 中英, 双语, 简, simp, 中, chi故障排除与性能优化常见问题解决方案播放器启动失败检查播放器路径配置确保路径无特殊字符进度回传失败确认播放器正常退出检查网络连接状态字幕加载问题验证字幕文件编码调整播放器字幕设置播放列表异常检查媒体文件命名规范确保版本一致性性能优化建议启用读盘模式本地有文件时直接播放减少网络延迟配置路径映射正确设置服务器路径到本地路径的转换规则调整预加载阈值根据网络状况调整prefetch_percent参数启用缓存清理定期清理临时文件释放磁盘空间总结与未来展望embyToLocalPlayer通过精心设计的架构和模块化实现解决了Emby/Jellyfin用户对本地播放器功能的需求痛点。其核心价值在于无缝集成在不改变现有使用习惯的前提下增强媒体服务器功能跨平台支持全面覆盖Windows、macOS、Linux三大操作系统扩展性强支持多种播放器和第三方平台同步配置灵活丰富的配置选项满足不同用户需求未来发展方向包括增强对更多播放器的支持、优化移动端体验、增加更多第三方平台同步选项等。项目采用开源模式开发欢迎开发者参与贡献共同完善这一优秀的媒体播放解决方案。【免费下载链接】embyToLocalPlayeretlp - Emby/Jellyfin 调用外部本地播放器并回传播放记录。适配 Plex。项目地址: https://gitcode.com/gh_mirrors/em/embyToLocalPlayer创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考