自托管媒体追踪服务，聚合多服务器观看记录并同步到 Trakt 等平台

方案简介

Scrob 是一个开源、自托管的媒体追踪服务，定位为「个人版 Letterboxd + Trakt」。它从 Jellyfin、Plex、Emby、Nuvio、ARVIO 和 Stremio 同步媒体库，追踪观看历史、评分和个人片单，并可把观看活动推送回已连接的外部服务，全部通过一个类似应用的 Web 界面完成，可当作 PWA 安装到任意设备。

这套方案解决的核心问题是：当你使用多个媒体服务器和多个追踪平台时，观看状态、进度和评分分散在各处、互不相通。Scrob 作为中心枢纽把它们聚合起来，并保持双向同步。适合自建媒体库、希望拥有统一观影记录与社交功能（关注、评论、公开片单）的自托管用户。

亮点与能力

• 多源同步：从 Jellyfin、Plex、Emby、Nuvio、Stremio 导入库、观看状态和播放进度。
• 保持各端同步：在媒体服务器、Nuvio 和 Stremio 之间同步合集成员、观看状态和播放进度，支持多个服务器实例和 Nuvio 配置。
• 实时 scrobble：来自 Jellyfin、Plex、Emby 和 Kodi 的 webhook 在播放时即时更新观看状态。
• 手动 scrobble：从任意电影或剧集页直接开始观看会话，可暂停、继续、停止或标记已看。
• Trakt/Simkl/MDBList/Bingebase 集成：同步观看历史、评分与片单，并可自动推送回去。
• 观看历史与评分：记录每次观看（含多次观看及各自时间戳）、10 分制评分及可选评论。
• 重看追踪：对剧集开启重看周期，单独追踪进度，不影响原始观看历史。
• 社交与片单：个人片单可公开分享，支持用户关注、评论与动态。

组成与分工

• Jellyfin / Plex / Emby：媒体服务器，提供库、观看状态和播放进度（多实例支持），并通过 webhook 实时上报播放事件。
• Nuvio / ARVIO / Stremio：客户端源，与媒体服务器双向同步观看状态和进度。
• Trakt：外部追踪平台，导入/导出观看历史、评分和片单。
• Simkl / MDBList / Bingebase：其他追踪平台，支持拉取历史评分及可选回推。
• TMDB：为所有影片提供丰富元数据——海报、剧照、演职员、预告片、合集等。
• RPDB (RatingPosterDB)：可选，提供带评分的海报。
• Scrob 本体：自托管 Web 应用，聚合以上数据，提供界面、社交、统计与 PWA。

使用与配置要点

跑通后的关键配置：

• 连接媒体服务器后，通过 webhook 实现播放时实时更新观看状态，无需手动同步。
• Trakt 连接：实时连接需要 Trakt VIP（Trakt 侧近期限制）；无 VIP 用户仍可通过 Trakt 数据导出导入。
• MDBList 回推需配置 MDBList API key；RPDB 海报需配置自己的 key。
• 每个资料可设置首选元数据显示语言，标题、简介和剧集名按可用翻译独立显示。
• TheTVDB 来源的剧集排序需要 TheTVDB key，TMDB 剧集组则不需要。

注意事项与常见问题

• Trakt 实时连接因 Trakt 侧近期限制需要 VIP 订阅，非 VIP 用户仅能用数据导出方式导入。
• 默认情况下公开资料和片单需要登录账号才能查看；管理员可在管理面板开启「Allow browsing without an account」允许访客匿名浏览。
• TheTVDB 剧集排序需要 key，TMDB 剧集组不需要。

优缺点

• ✓ 多服务器实时 webhook 同步
• ✓ 支持 PWA 全端安装
• ✕ Trakt 实时连接需 VIP 订阅

出处

本方案挖掘自开源项目 ellite/scrob，方案内容与实施命令均来自其 README 原文。