Metube项目配置：解决YTDL_OPTIONS_FILE文件格式错误问题

在使用Metube下载工具时，配置选项文件是实现高级功能的重要方式。许多用户在配置YTDL_OPTIONS_FILE时容易遇到"contents is invalid"的错误提示，这通常是由于JSON格式不规范导致的。

常见配置错误分析

在JSON配置文件中，布尔值的书写有严格规范：

• 必须全部使用小写字母
• true和false是唯一有效的布尔值写法
• 大小写混合（如True/False）会导致解析失败

错误示例：

{
  "postprocessors": [{
    "already_have_thumbnail": False  // 这里使用了首字母大写的False
  }]
}

正确写法应该是：

{
  "postprocessors": [{
    "already_have_thumbnail": false  // 全部小写才是有效的JSON布尔值
  }]
}

完整配置建议

一个典型的Metube选项文件应包含以下关键配置项：

1. 输出模板配置：控制下载文件的命名规则
2. 后处理器设置：包括元数据嵌入、缩略图处理等
3. 缩略图相关：控制是否下载和嵌入缩略图

推荐配置示例：

{
  "outtmpl": {
    "pl_thumbnail": ""
  },
  "postprocessors": [
    {
      "add_chapters": true,
      "add_infojson": "if_exists",
      "add_metadata": true,
      "key": "FFmpegMetadata"
    },
    {
      "already_have_thumbnail": false,
      "key": "EmbedThumbnail"
    }
  ],
  "writethumbnail": true
}

配置验证技巧

1. 使用在线JSON验证工具检查语法
2. 在Docker容器中手动测试配置：

   docker exec -it metube_container cat /options.json
   

3. 逐步添加配置项，避免一次性写入过多内容

高级配置建议

对于需要更复杂处理的用户，可以考虑：

1. 分片下载配置
2. 格式选择参数
3. 下载限速设置
4. 网络连接设置

记住，所有配置值都必须符合JSON规范，特别是字符串必须使用双引号，布尔值必须小写。配置完成后，建议先在本地验证JSON有效性，再部署到容器中使用。

通过遵循这些规范，可以避免大多数配置错误，充分发挥Metube的下载功能。