Jellyfin 命名规范与刮削指南
Jellyfin 影视库整理指南:电影与剧集的目录结构、SxxExx 命名、字幕与本地图片的配套命名,以及用 VRenamer 批量生成符合 Jellyfin 规范的文件名。
最后更新:
Jellyfin 的元数据来源
Jellyfin 默认通过 TMDB、TVDB 以及本地 NFO 文件获取元数据。三种来源里,文件名与目录结构都是最先被读取的输入,命名不规范会让后续所有环节失准。
电影库结构
推荐
Movies/
└── 寄生虫 (2019)/
├── 寄生虫 (2019).mkv
├── 寄生虫 (2019).zh.srt
└── poster.jpg
剧集库结构
- 顶层是「剧集名 (年份)」目录
- 季目录 Season 01 / Season 02,特别篇用 Season 00
- 文件名带 SxxExx,多集用 S01E01-E02
- 需要固定元数据时可在剧集目录放 tvshow.nfo
推荐
Shows/
└── Chernobyl (2019)/
├── Season 01/
│ ├── Chernobyl.S01E01.mkv
│ ├── Chernobyl.S01E02.mkv
│ └── Chernobyl.S01E03.mkv
└── tvshow.nfo
字幕与附加文件的命名
- 字幕:与视频同名,加语言代码后缀,如 Show.S01E01.zh.srt
- 封面:poster.jpg(竖版),fanart.jpg / backdrop.jpg(横版)
- 季封面:Season01-poster.jpg 或放在季目录下的 poster.jpg
- 字幕与图片都与视频文件名挂钩,视频改名后必须同步改
刮削不生效的排查顺序
- 确认媒体库类型:电影库与剧集库要分开建,放错库永远不会正确刮削
- 确认目录层级与 SxxExx 命名符合上面的结构
- 确认 TMDB / TVDB 插件能正常访问(部分地区需要配置代理)
- 确认「媒体库 → 元数据」里语言设置与你想显示的海报语言一致
- 对单个剧集执行「刷新元数据」,观察是文件问题还是网络问题
批量规范化现有文件
VRenamer 通过 SMB / WebDAV 连接媒体库目录,扫描后按 TMDB 数据输出 Jellyfin 规范的命名,并把字幕文件与视频文件对齐。整理后回到 Jellyfin 执行一次库扫描即可。
FAQ
Jellyfin 和 Emby 的命名能共用一套目录吗?
能。两者的目录层级与 SxxExx 约定一致,同一套命名可以同时被 Jellyfin、Emby、Plex 与 Infuse 识别,这也是推荐使用标准命名的原因。
必须用 NFO 文件吗?
不必。NFO 用于固定元数据、避免在线源变动或断网,属于可选方案。只要命名规范,Jellyfin 能直接从 TMDB / TVDB 拉到正确信息。
改了文件名,Jellyfin 会自己发现吗?
计划任务触发后会发现,但想立刻生效就手动执行「扫描媒体库」。若元数据仍不对,对具体条目执行「刷新元数据」用新文件名重新匹配。