Original Poster

Emby Plugin

自动获取TMDB的 电影 / 剧集 / 合集 / LOGO 原语言海报

---

功能

功能	说明
🎬 原语言海报	自动获取原语言的电影，剧集，播出季，合集的海报
🖼️ 原语言Logo	自动获取原语言的Logo，提升媒体库视觉统一性
⚙️ 用户自定义	可开启/关闭插件、Logo、测试模式

大陆&港澳台 电影统一请求 zh 语言海报。因为港澳台很多电影海报在TMDB并未被区分为zh-HK，zh-TW，故妥协。

安装

1. 下载 OriginalPoster.dll。
2. OriginalPoster.dll 放到插件目录，Emby Server的plugins下。
3. 重启 Emby 服务器。
4. 设置 -> 插件 -> OriginalPoster, 启用插件和配置插件。
5. 媒体库中去选中OriginalPoster，并置顶。根据Emby规则，那个刮削插件置顶，那个插件返回的海报优先。
6. 媒体库中中的 首选图像下载语言 留空，留空，留空

进入 “插件设置” → “Original Poster”：

配置项	建议值	说明
启用插件	开启	启用整个插件功能
启用原语言 Logo	开启	同时获取原语言 Logo（推荐）
TMDB API KEY	您的API密钥	必填，从 TMDB 获取
海报选择策略	优先原语言	推荐选项，优先显示原语言海报
测试模式	关闭	仅调试时开启，会返回固定测试图

测试示例

海报排序

海报保留原有评分算法，只增加分辨率作为最后的同分排序依据：

排序分 = TMDB 原始评分 + 语言策略加分
排序顺序（从高到低）：排序分 → 票数 → 像素数（宽 × 高）

票数和分辨率不参与加权，也不改变显示的评分。只有排序分相同时才比较票数，票数也相同时才优先选择像素数更多的图片。三项都相同则保持接口返回顺序。

例如《300》两张同语言海报，10 分、4 票、500×750 仍排在 3.7 分、15 票、1000×1500 前面。《千与千寻》的 8.8 分、8 票黑底海报仍排在 6.8 分、15 票纸人海报前面。

「优先原语言」「优先无文字」仍分别给首选语言类型加 20 分、次选加 10 分；「优先高评分」不加语言分。Emby 显示的分数包含语言加分，是排序分，并非 TMDB 原始评分。Logo 使用相同的排序规则。

开发验证：dotnet run --project Tests/OriginalPoster.RegressionTests.csproj --configuration Release。

语言选择示例

电影	制片国	插件行为
《拯救大兵瑞恩》	US	→ en-US 海报
《千与千寻》	JP	→ ja-JP 海报
《魔女》	KR	→ ko-KR 海报
《鹿鼎记》	HK	→ zh 海报（港产片）
《英雄》	CN	→ zh 海报（国产片）
《大话西游》	HK	→ zh 海报（港产片）

⚠️ 常见问题与解答

❓ 为什么我看到的还是英文海报？

• 检查 TMDB API Key 是否填写正确
• 检查 是否开启插件
• 尝试 刷新元数据（勾选“替换所有图像”）

❓ 《鹿鼎记》是香港电影，为什么显示的海报语言是 zh 而不是 zh-HK？

• 这是 妥协的设计：很多港澳台海报在TMDB都被归类为了zh-CN,而不是详细区分为zh-HK/zh-TW/zh-SG。
• 需要严格区分，还请自行fork，切换注释代码。

❓ 插件支持剧集吗？

• 支持！
• 插件自动识别剧集（Series）和播出季（Season），并从剧集获取原语言。

❓ 插件会频繁调用 TMDB API 吗？

• 不会
• 首次刷新时调用一次
• 后续刷新使用缓存（Emby 内部机制）
• 每个媒体项最多调用 2 次 API（详情 + 图像）

许可证

本项目采用 GPL-3.0 许可证。任何基于本项目代码的分发（包括商业用途）必须以相同许可证开源全部源代码。
欢迎使用、改进和分享，但请勿闭源售卖！

联系作者

如有问题、建议或贡献，请提交 Issue 或联系：

如果喜欢，请给项目一个 Star！