MetaTube插件在Synology NAS上Name Template配置失效问题解析

MetaTube插件在Synology NAS上Name Template配置失效问题解析

jellyfin-plugin-metatube MetaTube Plugin for Jellyfin/Emby 项目地址: https://gitcode.com/gh_mirrors/je/jellyfin-plugin-metatube

问题现象

用户在使用Synology NAS上的Emby媒体服务器时，安装了MetaTube插件（版本2024.205.435）并尝试修改Name Template模板格式。用户期望将文件名格式修改为包含编号、演员和年份的组合（如{number} {actors} {year}），但实际生效的仍然是默认的{number} {title}格式。

技术背景

MetaTube是一款用于Jellyfin/Emby媒体服务器的元数据插件，主要用于自动获取和整理成人内容元数据。其Name Template功能允许用户自定义文件命名规则，通过占位符变量（如{number}、{actors}等）实现动态文件名生成。

问题原因分析

根据技术交流记录，该问题最可能的原因是：

1. 用户未启用模板功能开关。MetaTube需要显式启用模板功能后，自定义的Name Template才会生效。
2. 模板语法可能存在格式错误，虽然示例中显示的模板格式看起来正确。

解决方案

要解决此问题，建议采取以下步骤：

1. 确认启用模板功能：

   • 在MetaTube插件设置中找到"Enable Template"选项
   • 确保该选项已切换为开启状态

2. 验证模板语法：

   • 检查模板中使用的占位符是否与MetaTube支持的变量一致
   • 确保没有使用未定义的变量或拼写错误

3. 典型可用变量参考：

   • {number}：作品编号
   • {title}：作品标题
   • {actors}：演员列表
   • {year}：发行年份
   • {studio}：制作商

4. 应用设置后操作：

   • 保存设置后建议重启Emby服务
   • 对已有内容执行元数据刷新操作

注意事项

1. 某些变量可能在某些情况下为空值（如缺少年份信息），这可能导致最终文件名中出现空段
2. 在Synology NAS环境下，需要注意文件系统的命名限制，避免使用特殊字符
3. 建议先在少量文件上测试模板效果，确认无误后再批量应用

总结

MetaTube插件的Name Template功能需要正确启用和配置才能生效。用户在Synology NAS上遇到模板不生效的问题时，首先应检查是否已开启模板功能开关，其次确认模板语法是否正确。通过系统性的排查和测试，可以确保自定义的文件命名规则按预期工作。

jellyfin-plugin-metatube MetaTube Plugin for Jellyfin/Emby 项目地址: https://gitcode.com/gh_mirrors/je/jellyfin-plugin-metatube