{"repo":"onlyhooops/emby-posters-updater","free":true,"listed":false,"github":"https://github.com/onlyhooops/emby-posters-updater","clone":"git clone https://github.com/onlyhooops/emby-posters-updater.git","description":"Emby 封面更新工具（合集/流派/标签）- 纯API、支持交互与自动化、中文说明、MIT","language":"Python","stars":24,"topics":["api","automation","emby","media-server","posters","python"],"license":"MIT","category":"workflow-automation","readme_excerpt":"Emby 封面更新工具 v2.0 🎉 v2.0 重大更新 已适配 Emby v4.9+ 最新API！ 同时保持对旧版本的完全兼容。 更新内容 - ✅ 支持 Emby v4.9+ 新版图像API - ✅ 自动检测并回退到旧版API（兼容 v4.0+） - ✅ 无需用户干预，自动适配服务器版本 - ✅ 所有功能测试通过 API 变更说明 - 删除图像 : 新版使用 POST /Items/{Id}/Images/{Type}/Delete - 上传图像 : 新版使用 Type 参数（替代 ImageType ） - 脚本会自动尝试新版API，失败时回退到旧版 --- 一键运行（复制即用） 本说明对应脚本 emby-poster-updater.py 。 脚本已移除敏感配置，使用前请先填写必要参数。 功能说明 - 批量清空并更新以下类型的封面： - 合集（Collections/BoxSets） - 流派（Genres） - 标签（Tags） - 纯 Emby API 实现（不访问文件系统） - 通过 RemoteImages API 将首个带主封面的影片图像复制为目标封面 - 交互式命令行，支持非交互场景自动化 填写配置 打开脚本顶部并填写： 运行环境 - Python : 3.7+ - 依赖 : pip install requests - 网络 : 可访问 Emby Server - 权限 : API Key 需具备管理员权限（图像管理） - Emby版本 : 4.0+ (推荐 4.9+) 运行 交互模式： 会提示选择： - 1) 合集 Collections - 2) 流派 Genres - 3) 标签 Tags - 4) 全部 All 非交互模式（如 cron/CI）： - 默认执行选项 1（合集） 使用到的 API 端点 查询API（所有版本通用） - 获取合集： GET /Users/{userId}/Items?IncludeItemTypes=BoxSet - 获取流派： GET /Genres - 获取标签： GET /Tags - 获取合集成员： GET /Items?ParentId={collectionId} - 按流派名称过滤： GET /Items?Genres={genreName}&IncludeItemTypes=Movie - 按标签名称过滤： GET /Items?Tags={tagName}&IncludeItemTypes=Movie 图像操作API（v2.0支持新旧版本） 删除图像 - 新版 (Emby v4.9+) : POST /Items/{itemId}/Images/{imageType}/Delete - 旧版 (Emby v4.0-4.8) : DELETE /Items/{itemId}/Images/{imageType} - 脚本会自动选择合适的版本 复制图像 - 新版 (Emby v4.9+) : POST /Items/{itemId}/RemoteImages/Download?Type=Primary&ImageUrl=...&ProviderName=Manual (需要JSON body) - 旧版 (Emby v4.0-4.8) : POST /Items/{itemId}/RemoteImages/Download?ImageType=Primary&ImageUrl=...&ProviderName=Manual - 脚本会自动选择合适的版本 安全建议 - 执行前建","default_branch":null,"files":null,"tree":[],"storefront":"/r/onlyhooops","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/onlyhooops/emby-posters-updater/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}