Emby 中文文档 下载 App

Emby 元数据自动抓取 — 海报、评分、剧情、演员全靠联网匹配

Emby 扫完库后自动做什么

媒体库扫描完成后,Emby 会做一系列联网匹配:

  1. 从文件名里解析出「名字 + 年份/季集数」
  2. 把解析结果发给 TheMovieDB / TheTVDB / IMDB 等数据源搜索
  3. 匹配到正确条目后,下载:
  1. 把这些信息存进数据库 + 把图片下载到本地缩略图缓存目录

整个过程全自动、后台静默运行。扫完库 30 分钟后刷新一下浏览器,海报应该就已经出现了。

Emby 自动匹配的电视剧详情页
Emby 为每部剧自动抓取海报、分集信息、评分

元数据来源

Emby 默认使用以下公共数据源:

来源覆盖内容语言说明
TheMovieDB(tmdb.org)电影、电视剧多语言(含中文)Emby 默认首选,社区维护,国内访问稳定
TheTVDB(tvdb.com)电视剧多语言另一个大型电视剧数据库,Emby 也支持
IMDB电影、电视剧英文为主作为评分来源补充
烂番茄电影/电视剧评分英文新鲜度评分
OpenSubtitles字幕多语言需要 Open Subtitles 插件
Last.fm音乐元数据多语言艺人、专辑、歌词

这些都是公开的、免费使用的 API,Emby 内部做了缓存(不会每次都重新下载),图片也存在本地。

匹配失败或匹配错误怎么办

元数据匹配不是 100% 准的——重名电影、冷门小语种、非标准命名都可能匹配失败。有三种修复方式:

方式一:单条 Refresh + Identify(最常用)

  1. 在 Emby Web Client 里找到那个匹配错的条目
  2. 详情页右上角菜单(三个点)→ Identify
  3. Emby 会列出它搜到的候选结果(可能只搜到 1 个,也可能搜到好几个重名的)
  4. 手动点选正确的那条,或者在搜索框里输入更精准的名字(比如加上 IMDb ID:tt1375666)
  5. 点确定,Emby 重新拉取正确的元数据

方式二:指定 TheMovieDB/IMDB ID

如果 Identify 里也搜不到(极冷门的内容),可以直接填 TheMovieDB 的电影 ID:

IMDb ID 也类似:URL IMDb 对应页面 → ID 是 tt1375666。

方式三:强制重新扫描整个库

Dashboard → Library → 对应库 → Scan Library Files(全量重扫)。但这对已经正确匹配的条目是浪费时间,只适合改了一堆文件命名后做全量刷新。

元数据语言

Dashboard → Library → 对应库 → Edit Library → Advanced Settings → Metadata language。

这个选项决定了 Emby 用什么语言的剧情简介、类型名等文本。中文环境建议选 Chinese Simplified(简体中文)。注意海报图片不受这个影响(图片本身无语言)。

Cover Art 插件(Premiere)

买了 Premiere 之后,Cover Art 插件能给现有海报加各种装饰风格:

这些效果可以叠加,让你的媒体库海报墙看起来更专业。Cover Art 只改变 Emby 客户端里显示的效果,不修改原始文件。

本地元数据文件(NFO / Poster)

如果你希望 Emby 读取你自己准备的 .nfo(XML 格式元数据文件)和本地 poster.jpg,可以:

  1. 在 Dashboard → Library → 对应库 → Edit Library → Advanced Settings 里开启 Save local metadata to media folders
  2. Emby 扫描时会优先读取 .nfo 和本地图片,而不是联网抓取

这适合有强迫症自己维护元数据的用户,或者希望换 Server 后元数据能跟着媒体文件走的场景。

元数据抓取失败的常见原因

原因排查
文件名太乱(纯数字编号)用 FileBot 重命名,参见 文件命名与目录结构
防火墙拦截了出站连接确认 Emby Server 能访问外网(临时关防火墙测试)
代理没配置Emby Server 的 HTTP 代理需要在 Dashboard → Advanced → System 里单独配置
元数据源本身查不到换 TheMovieDB 手动搜索确认有没有这个条目;冷门内容可能需要在 TheMovieDB 上补录
IPv6-only 网络某些 NAS 在 IPv6-only 环境下 Emby 无法访问元数据服务器,需要开启 IPv4 出站