Jellyfin音乐目录结构规范总结
Jellyfin音乐目录结构规范总结
Jellyfin作为一款优秀的媒体服务器，对音乐文件的组织有着特定的规范和建议，以确保最佳的识别和播放体验。本文将详细总结Jellyfin音乐目录的结构规范，包括专辑组织、多碟片处理、歌词文件管理、图片资源使用以及文件格式兼容性等方面。
专辑组织基本原则
Jellyfin的音乐库管理遵循"一个文件夹一个专辑"的基本原则。每个专辑必须被包含在单独的文件夹中，这是Jellyfin识别专辑的基础。值得注意的是，Jellyfin并不严格要求您如何组织这些专辑文件夹，只要确保每个专辑都有其独立的文件夹即可。例如，您可以按艺术家创建上层文件夹，然后在其中放置该艺术家的各个专辑文件夹；也可以直接在音乐根目录下放置各个专辑文件夹。
文件命名方面，Jellyfin主要依赖音频文件中嵌入的元数据进行识别，而非文件名本身。这意味着即使文件名不规范，只要音频文件中包含正确的元数据信息（如曲目标题、艺术家、专辑名等），Jellyfin仍能正确识别。只有在找不到其他元数据的情况下，Jellyfin才会使用文件名作为曲目标题。
尽管如此，文件命名时仍应避免使用特殊字符，因为它们可能导致问题。已知会引起问题的字符包括：<、>、:、"、/、\、|、?、*。这些字符在文件系统中有特殊含义，可能导致文件访问或识别错误。
多碟片专辑处理
对于包含多张碟片的专辑，Jellyfin主要通过音频文件元数据中的"碟片编号"和"总碟片数"字段进行识别。处理多碟片专辑时，有两种组织方式：
第一种方式是将所有碟片的曲目放在同一个专辑文件夹中，通过元数据区分不同碟片的曲目。这种方式简单直接，完全依赖元数据进行组织。
第二种方式是在专辑文件夹内为每张碟片创建单独的子文件夹（如"Disc 1"、"Disc 2"等），然后将相应碟片的曲目放入对应子文件夹。这种方式在视觉上更加清晰，但需要注意的是，嵌入的元数据优先级仍高于文件夹结构，因此确保元数据正确尤为重要。
无论采用哪种组织方式，确保音频文件中包含正确的碟片信息元数据是关键，这样Jellyfin才能准确识别和组织多碟片专辑的内容。
歌词文件管理
Jellyfin支持为音乐文件添加歌词，实现边听歌边看歌词的功能。歌词文件必须与对应的音频文件位于同一文件夹中，且文件名（不含扩展名）必须完全匹配。例如，音频文件"01 Death Eternal.mp3"对应的歌词文件应为"01 Death Eternal.lrc"、"01 Death Eternal.elrc"或"01 Death Eternal.txt"。
Jellyfin支持两种类型的歌词文件：同步歌词和非同步歌词。同步歌词是交互式的，允许用户点击任意行跳转到歌曲中对应的时间点。同步歌词文件通常包含时间戳信息，格式如下：
[ar: 艺术家名称]
[ti: 歌曲标题]
[al: 专辑名称]
[by: 作者]
[length: 2:57]
[00:10.89]第一行歌词
[00:14.58]第二行歌词
...创建同步歌词可以手动完成，但这可能耗时且不够精确，建议使用如MiniLyrics等歌词同步软件辅助完成。
非同步歌词则更容易实现，但用户跟唱时可能不够方便。非同步歌词文件格式简单，仅包含按顺序排列的歌词文本，没有时间戳信息：
第一行歌词
第二行歌词
...图片资源管理
Jellyfin音乐库中的图片资源主要有三种类型：封面图（Primary）、背景图（Backdrop）和标志图（Logo）。这些图片可以来自不同来源，但外部图片文件优先级最高。
外部图片文件应放置在媒体文件旁边，即与音频文件位于同一文件夹中。如果没有提供封面图，Jellyfin会回退使用第一个带有嵌入专辑图片的音轨。如果没有可用的背景图或标志图，Jellyfin会回退使用专辑艺术家的相应图片。
不同类型的图片文件可以使用以下命名：
- 封面图（Primary）：folder、poster、cover、default
- 背景图（Backdrop）：backdrop、fanart、background、art、extrafanart
- 标志图（Logo）：logo
对于背景图，可以提供多张图片实现循环切换效果。只需在文件名后直接或在连字符后添加数字即可，如"backdrop1.jpg"、"backdrop-2.jpg"等。
文件格式兼容性
Jellyfin支持大多数常见的音乐格式，但有一些例外情况需要注意：
- 仅包含音频的MP4文件：".mp4"文件不会被识别为音乐，应将其重命名为".m4a"。
- 仅包含音频的MKV/WebM文件：".mkv"和".webm"文件不会被识别为音乐，应将其重命名为".mka"。
- WebA文件：".weba"文件不受支持，应将其重命名为".mka"。
- 带有嵌入WebP图片或ID3标签的".flac"文件可能在基于Chromium的浏览器（Chrome、Edge、Opera、Brave等）或Firefox中无法播放。如遇此问题，请在客户端设置中启用"始终重新封装FLAC音频文件"选项。
- 使用ID3v1标签的文件大多数字段长度限制为30字节，超出部分将被截断。建议升级到ID3v2.4。
对于有问题的文件，可以使用ffmpeg将其重新封装为".mka"容器，命令如下：
ffmpeg -i <输入文件> -c:a copy <输出文件>.mka需要注意的是，重新封装过程可能会导致元数据混乱，嵌入的图片可能无法保留，因此可能需要手动或使用其他程序恢复元数据。
总结
Jellyfin的音乐目录结构规范主要围绕"一个文件夹一个专辑"的核心原则展开，同时提供了灵活的组织方式。正确的元数据是Jellyfin识别音乐内容的关键，而外部资源如歌词和图片则需要遵循特定的命名和放置规则。了解并遵循这些规范，可以帮助用户构建一个组织良好、功能完善的Jellyfin音乐库，获得最佳的音乐欣赏体验。