🚀 面向 Emby 影音库的全自动合集管理与追新补片流水线。
一键同步 IMDb/豆瓣 Top 250/Letterboxd/TSPDT 等权威主榜、全球 9 大权威电影节大奖、豆瓣电影 28 大分类多维度榜单（近期热门、Top 20、高分经典、冷门佳作）及豆瓣电视剧地区与类型榜单，智能排查本地缺失，并支持自定义排除列表联动 MoviePilot 实现自动化补片。系统支持自动聚合华语影视，并原生支持原语言海报直入与灵活的智能抓取策略，结合底层异步队列引擎，彻底解决 Emby 生成默认四宫格封面导致的卡死痛点。实现从全自动化整理到观影的完整闭环。
以下 TMDB 列表完全由自动化爬虫与 ETL 流水线自动维护。系统会在每天早上 7:30 (UTC+8) 定时执行数据抓取、比对与同步更新，确保榜单排名与官方时刻保持一致。
- 🍿 IMDb Top 250 Movies: 查看网格墙视图
- 📺 IMDb Top 250 TV Shows: 查看网格墙视图
- 🎞️ 豆瓣电影 Top 250: 查看网格墙视图
- 🏛️ S&S Directors - Greatest Films: 查看网格墙视图
- 🏛️ S&S Critics - Greatest Films: 查看网格墙视图
- ⭐ AFI Top 100 (2007): 查看网格墙视图
- 📰 NYT - 100 Best Movies of the 21st Century (2025): 查看网格墙视图
- 📡 NYT - 100 Best TV Shows of the 21st Century (2026): 查看网格墙视图
- 🏆 奥斯卡历届最佳影片: 查看网格墙视图
- 🌿 戛纳电影节金棕榈奖: 查看网格墙视图
- 🎭 英国电影学院奖最佳影片: 查看网格墙视图
- 🌐 金球奖最佳剧情片: 查看网格墙视图
- 🥂 金球奖最佳音乐/喜剧片: 查看网格墙视图
- 🕊️ 独立精神奖最佳长片: 查看网格墙视图
- 🐻 柏林电影节金熊奖: 查看网格墙视图
- 🦁 威尼斯电影节金狮奖: 查看网格墙视图
- 🍁 多伦多电影节人民选择奖: 查看网格墙视图
- 🎬 LB Top 500 Films: 查看网格墙视图
- 🔥 LB Top 250 Films with the Most Fans: 查看网格墙视图
- 🎨 LB Top 250 Animated Films: 查看网格墙视图
- 📽️ LB Top 250 Documentary Films: 查看网格墙视图
- 📝 Roger Ebert's Great Movies: 查看网格墙视图
- 🎥 TSPDT - 1000 Greatest Films: 查看网格墙视图
- 📖 1001 Movies You Must See Before You Die: 查看网格墙视图
- 💽 Criterion Collection: 查看网格墙视图
- 📈 豆瓣 - 一周口碑电影榜: 查看网格墙视图
- 📺 豆瓣 - 华语口碑剧集榜: 查看网格墙视图
- 🌍 豆瓣 - 全球口碑剧集榜: 查看网格墙视图
- 🔥 豆瓣 - 实时热门电影榜: 查看网格墙视图
- 🔥 豆瓣 - 实时热门电视榜: 查看网格墙视图
- 📈 TMDB - 热门电影榜: 查看网格墙视图
- 📺 TMDB - 热门剧集榜: 查看网格墙视图
- 🔥 TMDB - 本周趋势电影榜: 查看网格墙视图
- 🔥 TMDB - 本周趋势剧集榜: 查看网格墙视图
- 🎭 剧情: Top 20 | 高分经典
- 😂 喜剧: 近期热门 | Top 20 | 高分经典 | 冷门佳作
- 💥 动作: 近期热门 | Top 20 | 高分经典 | 冷门佳作
- ❤️ 爱情: 近期热门 | Top 20 | 高分经典 | 冷门佳作
- 🚀 科幻: 近期热门 | Top 20 | 高分经典 | 冷门佳作
- 🎨 动画: 近期热门 | Top 20 | 高分经典 | 冷门佳作
- 🔍 悬疑: 近期热门 | Top 20 | 高分经典 | 冷门佳作
- 😱 惊悚: 近期热门 | Top 20 | 高分经典 | 冷门佳作
- 👻 恐怖: 近期热门 | Top 20 | 高分经典 | 冷门佳作
- 📽️ 纪录片: Top 20
- ⏱️ 短片: Top 20
- 🔞 情色: Top 20 | 高分经典 | 冷门佳作
- 🎵 音乐: Top 20 | 高分经典 | 冷门佳作
- 💃 歌舞: Top 20 | 高分经典 | 冷门佳作
- 🏠 家庭: Top 20 | 高分经典
- 👶 儿童: Top 20 | 高分经典
- 📖 传记: 近期热门 | Top 20 | 高分经典 | 冷门佳作
- 📜 历史: Top 20 | 高分经典 | 冷门佳作
- ⚔️ 战争: 近期热门 | Top 20 | 高分经典 | 冷门佳作
- 🚔 犯罪: 近期热门 | Top 20 | 高分经典 | 冷门佳作
- 🤠 西部: Top 20 | 高分经典
- 🧙 奇幻: Top 20 | 高分经典 | 冷门佳作
- 🗺️ 冒险: 近期热门 | Top 20 | 高分经典 | 冷门佳作
- 🌋 灾难: Top 20 | 高分经典 | 冷门佳作
- 🗡️ 武侠: Top 20 | 高分经典 | 冷门佳作
- 🏮 古装: Top 20 | 高分经典
- 🏃 运动: Top 20 | 高分经典
- 🌑 黑色电影: Top 20
- 🇨🇳 大陆剧: 近期热门 | 高分经典 | 冷门佳作
- 🇺🇸 美剧: 近期热门 | 高分经典 | 冷门佳作
- 🇬🇧 英剧: 高分经典 | 冷门佳作
- 🇯🇵 日剧: 近期热门 | 高分经典 | 冷门佳作
- 🇰🇷 韩剧: 近期热门 | 高分经典 | 冷门佳作
- 🇭🇰 港剧: 高分经典 | 冷门佳作
- 🇨🇳 台剧: 高分经典 | 冷门佳作
- 🇹🇭 泰剧: 冷门佳作
- 🇪🇺 欧洲剧: 近期热门 | 高分经典
- 🎨 动画剧集: 高分经典
- 🏆 顶级榜单全自动维护
- 支持 IMDb/豆瓣 Top 250/Letterboxd/TSPDT 主榜单、全球 9 大权威电影节大奖、豆瓣电影 28 大分类多维度榜单（近期热门、Top 20、高分经典、冷门佳作）及豆瓣电视剧地区与类型榜单。
- 自动简介同步：抓取 TMDb 列表描述并写入 Emby 合集
Overview字段。 - 全员收藏：自动将生成的合集加入所有 Emby 用户的“我的收藏”，提升常用榜单的曝光度。
- 🖼️ 海报直入与异步性能引擎
- 告别四宫格假死：彻底终结 Emby 默认生成拼图时导致的服务器卡死或刮削阻塞问题。
- 异步队列注入：引入全局任务队列与动态延时结算机制，将海报注入与合集创建解耦，大幅缩短运行时间并完美规避 SQLite 数据库锁死覆盖问题。
- 智能抓取策略：支持高度自定义的海报提取逻辑（榜单绝对第一 vs 库内拥有最高排名；最新上映 vs 最新入库），打造个性化封面墙。
- 合集封面修复：扫描库内无封面的合集，提取合集内最早上映影视的海报进行修复。
- 电影与剧集封面修复：为缺少主封面的电影和剧集补充 TMDb 原语言海报。已有主封面自动跳过；缺少 TMDb ID 或未获取到原语言海报时记录原因，不使用其他语言图片替代。
- 🍿 MoviePilot 联动自动补片
- 精准订阅策略：比对缺失后自动调用 MoviePilot API。支持按榜单独立配置订阅模式：全量订阅 (True)、完全关闭 (False) 或设置排名阈值（如传入整数 3，则仅自动订阅榜单前 3 名的缺失项），精细化管理资源获取。
- 防误杀排除列表：支持配置独立的电影/剧集 TMDb ID 排除列表 (
MP_EXCLUDE_MOVIE_IDS/MP_EXCLUDE_SERIES_IDS)，智能跳过无需订阅的特定条目，并在推送报告中体现拦截统计。 - 防重机制：推送前自动比对 MP 已有订阅，避免重复下发任务。
- 📁 智能查漏补缺与报告
- 详细的推送通知报告：精确列出缺失影片、排名及对应的
{tmdb-id}，并动态展示 MP 订阅成功、已有及排除的数量。 - 封面修复报告：分别统计合集、电影和剧集的修复数量，并统一展示成功修复清单及失败原因。
- 自适应通知排版：针对分类榜单采用精简概览模式，防止消息过长被通讯软件截断。
- 详细的推送通知报告：精确列出缺失影片、排名及对应的
- 🇨🇳 国产/华语特色聚合
- 通过目录关键词与 TMDb 产地代码（
CN/HK/TW）自动聚合国产影视资源。
- 通过目录关键词与 TMDb 产地代码（
- 🛡️ 工业级容错机制
- 针对部分 Emby 版本优化了 API 请求路径，规避 JSON 解析异常，确保脚本在复杂网络环境下稳定运行。
(图：全自动生成的 Emby 专属海报墙与合集分类)
- 放置脚本：将
emby_collection_sync.py放入青龙面板的scripts文件夹。 - 安装依赖：在青龙的“依赖管理”中安装 Python3 依赖：
requests和urllib3。 - 填写配置：打开脚本，在配置区域填入你的 Emby、TMDb 和 MoviePilot 地址及对应密钥。
- 订阅策略定制：在脚本
CUSTOM_LISTS中调整mp_subscribe参数：True: 只要缺失即订阅。False: 仅在通知中报告缺失，不执行订阅。整数 (如 3): 仅当该条目在榜单前 3 名且库内缺失时，才发给 MP 执行下载。
- 定时任务：新增任务，命令为
task emby_collection_sync.py（建议定时规则：0 30 8 * * *）。
本项目基于 GPL-3.0 license 协议开源 - 详情请查看 LICENSE 文件。