README.md

May 7, 2026 · View on GitHub

基于Webhook自动同步Bangumi打格子

用户文档 | 快速开始 | Docker部署 | 参与开发

Web 管理界面 - 仪表板

📖 简介

Bangumi-syncer 是一款把常见媒体库与 Bangumi（番组计划）连接在一起的轻量级小工具。

你可以在 Plex、Emby、Jellyfin、Infuse(通过Trakt桥接)、飞牛等任意媒体库客户端里照常看番，看完一集后会自动调用 Bangumi API 打格子，免去频繁打开网站的烦恼，省时省力。

🌐 现代化 Web 管理界面：仪表板统计、趋势与最近同步记录等可视化。
⚙️ 全流程在线配置：所有配置项均可在 Web 中配置并热重载，支持配置备份与恢复。
✅ 看完即同步：在媒体库标记看完后，由程序调用Bangumi 官方 API自动打格子。
🧠 智能推理条目：采用启发式推理，自动匹配媒体库标题与 Bangumi 条目（尤其是多季度和分割放送）。
🔌 常见媒体栈都能接：已内置适配 Plex、Emby、Jellyfin、Trakt、飞牛，也支持其他软件通过自行构建Webhook进行同步触发，覆盖了绝大多数场景。
👥 多用户同步：支持多用户模式，按媒体服务器用户名路由到不同 Bangumi 账号，数据不混杂。
🔔 通知能力：同步过程支持 Webhook 和邮件通知，模板与类型可高度自定义，便于接入Telegram、钉钉等软件通知或扩展更多状态同步能力。

媒体库 / 播放端	接入方式	番剧单集看过	剧场版在看	剧场版看过
Plex	Tautulli(免费)	✅	✅	✅
Plex	官方Webhooks(需Plex Pass)	✅	✅	✅
Emby	服务器自带通知	✅	✅	✅
Jellyfin	Webhook 插件	✅	✅	✅
Infuse	借助Trakt同步	✅	❌	✅
Trakt	定时任务拉取账户播放历史	✅	❌	✅
飞牛	定时只读数据库	✅	❌	✅
任意支持Webhook的播放器	自定义 Webhook	✅	✅	✅