Jellyfin中NFO文件与3D视频文件的命名匹配问题解析

问题背景

在使用Jellyfin媒体服务器管理3D视频内容时，用户发现当视频文件名包含"3D HSBS"标识时，系统无法正确识别并导入同名的NFO元数据文件。这是一个典型的媒体文件与元数据文件匹配问题，在Jellyfin的媒体库管理中较为常见。

问题现象

用户报告的具体情况是：当视频文件命名为"TITLE-123.3D.HSBS.mp4"时，即使存在正确格式的"TITLE-123.nfo"文件，Jellyfin也无法从中导入元数据信息。这导致3D视频内容缺少应有的标题、年份、演员等元数据。

技术原理分析

Jellyfin对NFO文件的识别遵循特定的命名匹配规则：

1. 精确匹配原则：Jellyfin默认要求NFO文件的主文件名必须与媒体文件完全一致。对于"TITLE-123.3D.HSBS.mp4"这样的文件名，系统会寻找"TITLE-123.3D.HSBS.nfo"而非"TITLE-123.nfo"。

2. 特殊命名例外：Jellyfin也支持使用"movie.nfo"作为通用元数据文件名，这种命名方式适用于文件夹内只有一个主要媒体文件的情况。

3. 3D标识处理：当文件名中包含"3D"、"HSBS"、"HOU"等3D视频格式标识时，这些标识被视为文件名的一部分，系统不会自动忽略它们进行模糊匹配。

解决方案

针对这一问题，有以下几种可行的解决方案：

1. 重命名NFO文件：将NFO文件命名为与媒体文件完全一致，如"TITLE-123.3D.HSBS.nfo"。

2. 使用通用命名：在媒体文件所在文件夹中创建"movie.nfo"文件。

3. 修改Jellyfin匹配逻辑：对于高级用户，可以通过修改Jellyfin源代码中的文件匹配规则，但这需要一定的开发能力。

最佳实践建议

1. 对于3D视频内容，建议采用一致的命名规则，如：

   /Movies/Title (Year)/
     ├── Title (Year).3D.HSBS.mp4
     └── Title (Year).3D.HSBS.nfo
   

2. 批量处理现有媒体库时，可以使用脚本工具自动生成匹配的NFO文件名。

3. 在NFO文件中明确指定3D相关属性，虽然这不是必须的，但有助于媒体库管理：

   <format>3D HSBS</format>
   

总结

Jellyfin对NFO文件的识别采用严格的文件名匹配机制，这一设计确保了元数据管理的准确性，但也要求用户在命名文件时保持一致性。理解这一机制后，用户可以通过简单的文件重命名解决大多数元数据导入问题。对于3D等特殊格式的视频内容，采用系统认可的命名规范是保证元数据正常工作的关键。