配置说明

配置说明

TMDB API Key

Metarr 使用 TheMovieDB (TMDB) API 获取影视元数据。

获取步骤：

1. 访问 themoviedb.org 并注册账号

2. 登录后进入 Settings → API

3. 点击 申请 API Key，类型选择 Developer（开发者）

4. 填写应用信息（名称随意，用途填个人使用即可）

5. 复制生成的 API Key (v3 auth)

> TMDB API 完全免费，个人使用无请求限制。

---

命名方案

Metarr 支持多种媒体服务器的命名规范，在设置中选择对应方案：

方案

适用服务

目录示例

通用（推荐）	Jellyfin / Plex / Emby / Infuse	`剧名 (2024)/Season 01/剧名 S01E01.mkv`
Jellyfin	Jellyfin / Emby	`剧名 (2024) [tmdbid-1234]/Season 01/剧名 (2024) S01E01.mkv`
Plex	Plex	`剧名 (2024)/Season 01/剧名 - S01E01.mkv`
Kodi	Kodi	`剧名/Season 1/剧名 S01E01.mkv`
自定义	任意	自定义所有字段模板

自定义模板变量

变量

说明

示例

`{name}`	显示名称（当前语言）	`权力的游戏`
`{year}`	年份	`2011`
`{tmdbId}`	TMDB ID	`1399`
`{idTag}`	ID 标签（自动选优）	`[tmdbid-1399]`
`{season:02}`	季数（零填充）	`01`
`{episode:02}`	集数（零填充）	`03`
`{ext}`	文件扩展名	`.mkv`

---

封面与元数据

Metarr 可自动从 TMDB 下载封面并生成 NFO 元数据文件（需先完成媒体匹配）：

海报 (poster.jpg)：媒体主海报图

背景图 (fanart.jpg)：宽幅背景图

Season 海报：各季专属海报

集缩略图：每集预览图（-thumb.jpg）

NFO 文件：Kodi/Jellyfin/Emby 离线元数据，包含类型、评分、简介等

以上均为可选，在预览步骤中可逐个勾选。

---

字幕下载

Metarr 支持从 SubDL 和射手网自动下载字幕，详见字幕下载配置。

---

配置文件位置

配置自动保存至 ~/.metarr/config.json：

macOS / Linux: ~/.metarr/config.json

Windows: C:\Users\用户名\.metarr\config.json

完整配置项

配置项

说明

默认值

`tmdbKey`	TMDB API Key	无
`destPath`	默认输出目录	无
`displayLanguage`	显示语言（zh-CN / en-US）	zh-CN
`preferImdbId`	电影优先使用 IMDB ID	true
`namingPreset`	命名方案	universal
`subdlApiKey`	SubDL API Key	无
`assrtToken`	射手网 Token	无
`subtitleLanguages`	字幕语言列表	["zh","en"]