非官方测试版翻译

本页面由 PageTurner AI 翻译（测试版）。未经项目官方认可。 发现错误？ 报告问题 →

电视剧

在 Jellyfin 中添加电视剧集时，请使用"剧集"类型的媒体库。

非官方测试版翻译

本页面由 PageTurner AI 翻译（测试版）。未经项目官方认可。 发现错误？ 报告问题 →

Jellyfin 支持大多数常见视频格式，例如 mp4 和 mkv。此外，还支持用于电影和音乐视频的 VIDEO_TS 和 BDMV 文件夹。但 VIDEO_TS 或 BDMV 文件夹不支持多个版本、多个部分或外挂字幕/音轨。

.iso 文件和其他光盘映像格式可能可以运行，但不受官方支持。建议将光盘映像格式重新封装为 mkv 容器，或提取为 VIDEO_TS 或 BDMV 文件夹。

文件名应尽可能与您的元数据提供程序列出的名称保持一致。但请注意，某些字符因被 Jellyfin 保留而无法使用。包含这些字符必定会导致问题，已知会引发问题的字符包括：<, >, :, ", /, \, |, ?, *

组织方式

剧集文件应按系列文件夹分类，每个系列文件夹下再创建季数子文件夹。

Shows
├── Series Name A (2010)
│   ├── Season 00
│   │   ├── Some Special.mkv
│   │   ├── Series Name A S00E01.mkv
│   │   └── Series Name A S00E02.mkv
│   ├── Season 01
│   │   ├── Series Name A S01E01-E02.mkv
│   │   ├── Series Name A S01E03.mkv
│   │   └── Series Name A S01E04.mkv
│   └── Season 02
│       ├── Series Name A S02E01.mkv
│       ├── Series Name A S02E02.mkv
│       ├── Series Name A S02E03 Part 1.mkv
│       └── Series Name A S02E03 Part 2.mkv
└── Series Name B (2018)
    ├── Season 01
    |   ├── Series Name B S01E01.mkv
    |   └── Series Name B S01E02.mkv
    └── Season 02
        ├── Series Name B S02E01-E02.mkv
        └── Series Name B S02E03.mkv

单个视频文件可能包含多集内容，但系统会将其显示为包含多集元数据的单一条目。建议使用 MKVToolNix 等工具将视频文件分割为独立剧集。

命名规范

系列文件夹建议采用以下格式命名：

Series Name (year) [metadata provider id]

year（年份）和 metadata provider id（元数据提供商标识）字段为可选字段，但添加这些信息将有助于更可靠地识别媒体文件。

• 仅含名称的示例：Jellyfin Documentary.mkv

• 含年份示例：Jellyfin Documentary (2030)

• 含元数据提供商ID的示例：Jellyfin Documentary [imdbid-tt00000000]

• 同时包含年份与元数据提供商ID的示例：Jellyfin Documentary (2030) [imdbid-tt00000000]

季文件夹应采用Season *格式命名（*代表任意数字）。请勿将Season缩写为S01或SE01。为获得最佳效果，建议在季数前补0s以确保所有条目位数统一，例如将Season 5命名为Season 05。同时，请勿在剧集文件夹中混合放置季文件夹和剧集文件。

非官方测试版翻译

本页面由 PageTurner AI 翻译（测试版）。未经项目官方认可。 发现错误？ 报告问题 →

元数据提供者

Jellyfin 会自动从外部元数据提供者为大多数类型的内容获取媒体信息。 电影和剧集可以通过使用元数据提供者 ID 来命名以提高匹配度。 电影和剧集可以通过使用元数据提供者 ID 来命名以提高匹配度。

Movie Name (year) [metadata provider id]
Series Name (year) [metadata provider id]

更多详情请参阅元数据提供者标识符章节。

非官方测试版翻译

本页面由 PageTurner AI 翻译（测试版）。未经项目官方认可。 发现错误？ 报告问题 →

外部字幕与音轨

可通过文件后缀名添加外部字幕和音轨。

Movies
└── Film (1986)
    ├── Film.mkv
    ├── Film.default.srt
    ├── Film.default.en.forced.ass
    ├── Film.forced.en.dts
    ├── Film.en.sdh.srt
    └── Film.English Commentary.en.mp3

Shows
└── Series Name A (2021)
    └── Season 1
        ├── Series Name A (2021) S01E01 Title.avi
        ├── Series Name A (2021) S01E01 Title.ja.ass
        └── Series Name A (2021) S01E01 Title.commentary.ja.aac

每个标题/标志字段可以是普通字符串或特殊标志。文件可包含多个标志，使用 . 分隔。

Type	Flag
Default	default
Forced	forced, foreign
Hearing Impaired	sdh, cc, hi

hi 与印地语缩写冲突。单独使用 hi 会识别为印地语音轨，而当 hi 与其他语言标识符共同出现时（例如 title.en.hi.srt），将采用其他语言并标记为听障辅助音轨。

在包含多流内容的容器中，标志将被忽略。

任何无法解析为语言或标志的文本将组合作为音轨标题（当文件元数据中未内置标题时）。上例中的最后一个文件将被解析为英文 mp3 音轨，标题显示为 English Commentary。

非官方测试版翻译

本页面由 PageTurner AI 翻译（测试版）。未经项目官方认可。 发现错误？ 报告问题 →

附加内容

可以通过以下几种方式为电影、剧集、剧季和音乐视频添加附加内容：

附加内容文件夹

最清晰的附加内容添加方式是在媒体文件夹内创建专用子文件夹。

支持的文件夹类型包括：

• behind the scenes

• deleted scenes

• interviews

• scenes

• samples

• shorts

• featurettes

• clips

• other - 存放未知类型附加内容的通用目录

• extras - 存放未知类型附加内容的通用目录

• trailers

• theme-music

• backdrops

Best_Movie_Ever (2019)
├── Best_Movie_Ever (2019).mp4
├── behind the scenes
│   └── Finding the right score.mp4
└── extras
    └── Home recreation.mp4

Awesome TV Show (2024)
├── Season 1
│   ├── Awesome TV Show (2024) S01E01 episode name.mp4
│   ├── trailers
│   │   └── trailer1.mp4
│   ├── theme-music
│   │   ├── Season 01 OP.mp3
│   │   └── Season 01 ED.flac
│   └── backdrops
│        └── S1Intro.mkv
├── interviews
│   └── Interview with the Director.mp4
└── theme-music
    └── Series Opening.wav

文件名规范

当某类附加内容仅需添加单个文件时，可通过在相同文件夹中使用特定文件名实现：

支持的文件名格式：

• trailer

• sample

• theme - 主题曲音频文件

Best_Movie_Ever (2019)
├── Best_Movie_Ever (2019) - 1080P.mp4
└── theme.mp3

Awesome TV Show (2024)
├── Season 1
│   ├── Awesome TV Show (2024) S01E01 episode name.mp4
│   └── theme.flac
└── sample.mp4

文件后缀规范

若希望将所有文件保存在同一文件夹，可在文件名后添加特殊后缀供 Jellyfin 识别为附加内容。请注意：除明确标注的例外情况外，这些后缀不包含空格。

• -trailer

• .trailer

• _trailer

• trailer - 以空格开头后接 trailer

• -sample

• .sample

• _sample

• sample - 以空格开头后接 sample

• -scene

• -clip

• -interview

• -behindthescenes

• -deleted

• -deletedscene

• -featurette

• -short

• -other

• -extra

Best_Movie_Ever (2019)
├── Best_Movie_Ever (2019) - 1080P.mp4
├── Preview Trailer.trailer.mp4
└── Making of The Best Movie Ever-behindthescenes.mp4

Series Name A (2024)
├── Season 1
│   ├── Series Name A (2024) S01E01 episode name.mp4
│   └── Preview Trailer.trailer.mp4
└── making of Series Name A-behindthescenes.mp4

特别篇管理

特别篇应放置在Season 00文件夹。若元数据提供商支持特别篇匹配，系统会自动识别。若提供商未提供特别篇信息，建议使用描述性文件名（而非Series Name S00Exy.mkv格式），以避免元数据错误并确保正常显示。

不同元数据提供商对特别篇的剧集编号规则可能不同。

特别篇也可嵌入正片中播放，这在特别篇与当季剧情连贯时尤为实用。此功能需满足两项设置：

1. 需在Dashboard -> Library -> Display中启用Display specials within their series they aired in选项

2. 必须在元数据中设置特别篇的播出位置：

   • 可通过元数据编辑器或NFO文件中的airsbefore_season、airsafter_season和airsbefore_episode标签配置
   • 当设置Airs before season但未设Airs before episode时，特别篇将在指定季的首集前播放
   • 组合使用Airs before season和Airs before episode可将特别篇插入季中，例如：当Airs before season设置为2且Airs before episode设置为7时，特别篇将在S02E06与S02E07之间播放
   • 设置Airs after series时，特别篇将在指定季的末尾播放（优先级高于Airs before season/episode字段）
   • 多部特别篇位置相同时，按它们在特别篇季中的存储顺序播放。例如：S00E01和S00E03均将Airs before season设置为3且将Airs before episode设置为7时，播放顺序为：S03E06 → S00E01 → S00E03 → S03E07

注意：启用此功能后，特别篇会同时在 Specials 季和指定季中显示。

非官方测试版翻译

本页面由 PageTurner AI 翻译（测试版）。未经项目官方认可。 发现错误？ 报告问题 →

3D 视频

3D 视频通过文件名中的标识符进行识别。要通过文件名识别 3D 内容，首个标签必须是 3D，该标签需与以下标签之一组合使用以指定具体的 3D 格式：

Format	Flag
half side by side	hsbs
full side by side	fsbs
half top and bottom	htab
full top and bottom	ftab
Multiview Video Coding	mvc
Anaglyph	Not Supported

这些标签不区分大小写，且必须由空格、连字符 -、点号 . 或下划线 _ 包裹。

Awesome 3D Movie (2022).3D.FTAB.mp4
Awesome 3D Movie (2022)_3D_htab.mp4
Awesome 3D Movie (2022)-3d-hsbs.mp4

Series Name A (2022) S01E01 Some Episode.3d.ftab.mp4
Series Name A (2022) S01E02 Some Other Episode.3d.ftab.mp4
Series Name A (2022) S01E03 Yet another episode.3d.hsbs.mp4

此外，3D 文件名标签可与电影和音乐视频库中的分组功能结合使用。连字符前的所有文本必须与文件夹名称完全一致。

Movies
└── Awesome 3D Movie (2022)
    ├── Awesome 3D Movie (2022) - 3D_FTAB.mp4
    ├── Awesome 3D Movie (2022) - 3D.hsbs.mp4
    └── Awesome 3D Movie (2022) - 1080p.mp4

非官方测试版翻译

本页面由 PageTurner AI 翻译（测试版）。未经项目官方认可。 发现错误？ 报告问题 →

多文件分段处理

如果正确命名，被分割成多个文件的内容可以自动合并。文件命名应遵循以下格式：

Movie Name (2010)
├── Movie Name-cd1.mkv
├── Movie Name-cd2.mkv
└── Movie Name-cd3.mkv

Series Name A (2025)
└──Season 1
    ├── Series Name A (2025) S01E01-part-1.mkv
    └── Series Name A (2025) S01E01-part-2.mkv

<parttype> 和 <partnumber> 之间的分隔符是可选的。<partnumber> 可以是任意数字或字母 a-d。

支持的分段类型包括：

• cd

• dvd

• part

• pt

• disc

• disk

支持的分隔符包括：

• (空格)

• . (句点)

• - (短横线)

• _ (下划线)

此功能不支持多版本合并或文件融合操作。

非官方测试版翻译

本页面由 PageTurner AI 翻译（测试版）。未经项目官方认可。 发现错误？ 报告问题 →

元数据图片

图片可以作为外部文件放置在媒体文件夹中，也可以直接嵌入在媒体文件内部。当使用外部图片时，应将其与媒体文件放置在同一目录下。一旦提供了外部图片，它们将优先于其他来源的图片。

与媒体文件夹类似，艺术家图片可以放置在艺术家文件夹的根目录下。该图片将在浏览艺术家列表和艺术家详情页面中同时显示。

Music

Artist
├── Album
│   ├── cover.jpg
│   ├── backdrop.webp
│   ├── logo.png
│   ├── Track 1.m4a
│   └── Track 2.m4a
└── folder.jpg

When no images are provided for music, Jellyfin will take the cover image from the first track that has an embedded cover image.

Movies

Movie (2035)
├── cover.jpg
├── backdrop.webp
├── logo.png
└── Movie (2035).mp4

Shows

Series Name B (2018)
├── cover.jpg
├── thumbnail.jpg
└── Season 01
    ├── backdrop.webp
    ├── cover.jpg
    ├── logo.png
    ├── Series Name B S01E01.mkv
    ├── Series Name B S01E01-thumb.jpg
    ├── Series Name B S01E02.mkv
    └── Series Name B S01E02-thumb.jpg

图片类型：

Type	Description
Primary	The primary cover/artist image
Backdrop	Background image in media page 1
Banner	Displayed when browsing library in banner mode. Video only. 2
Logo	Logo displayed on the top of a media item.
Thumb	Thumbnail for homepage and for browsing library in thumb mode. Video only. 2

¹Multiple backdrop images can be used to cycle through several over time. Simply append a number to the end of the filename directly after or after a hyphen, e.g. backdrop-1.jpg, backdrop2.jpg.

²These can be added to both video and audio content, but are not used by any client for audio content.

Filenames, their respective types and supported media types

Unless otherwise noted, all filenames can be used either standalone (e.g. logo.png) or as a suffix (e.g. movie-logo.png)

Filename	Type	Movies	Series	Season	Episode	Music	Artist
poster	Primary	✅ 2	✅	✅		✅
folder	Primary	✅ 2	✅	✅		✅	✅
cover	Primary	✅ 2	✅	✅		✅
default	Primary	✅ 2	✅	✅		✅
movie	Primary	✅ 2
show	Primary		✅
jacket	Primary					✅
thumb (suffix) 1	Primary				✅
backdrop	Backdrop	✅ 2	✅	✅		✅
fanart	Backdrop	✅ 2	✅	✅		✅
background	Backdrop	✅ 2	✅	✅		✅
art	Backdrop	✅ 2	✅	✅		✅
extrafanart (folder)	Backdrop	✅ 2	✅	✅		✅
banner	Banner	✅	✅	✅		✅
logo	Logo	✅ 2	✅	✅		✅
clearlogo	Logo	✅ 2	✅	✅		✅
landscape	Thumb	✅	✅	✅		✅
thumb	Thumb	✅	✅	✅		✅

¹ For example: S01E01 Some Episode-thumb.jpg
² These file names can also be embedded in supported media containers (e.g. mkv) and will be used when the Embedded Image Extractor source is enabled for movies.

下方截图展示了 Jellyfin 中的三种主要图片类型

Unused types are listed below. While they are unused by official clients, they may be used by 3rd party clients.

Type	Description
Art	Unused
Disc	Unused
Box	Unused
Menu	Unused
Chapter	Unused
BoxRear	Unused
Profile	Unused
Screenshot	Unused, Deprecated

Filename	Type	Movies	Series	Season	Episode	Music
disc	Disc	✅				✅
cdart	Disc	✅				✅
discart	Disc	✅
clearart	Art	✅	✅	✅		✅