ytdl-sub项目：TV Show Collection预设使用注意事项

概述

ytdl-sub是一个强大的视频下载和自动化处理工具，其中TV Show Collection预设功能允许用户将在线内容组织成电视剧集的形式。本文将详细介绍该功能的使用方法和常见问题。

功能特点

TV Show Collection预设的主要特点包括：

1. 将在线内容按季(Season)分类
2. 自动生成电视剧集元数据(NFO文件)
3. 支持Jellyfin媒体服务器兼容格式
4. 提供完整的剧集信息管理

正确配置方法

要正确使用TV Show Collection预设，必须为每个季(Season)指定以下两个关键参数：

• sXX_name：季的名称(如"s01_name: 第一季")
• sXX_url：该季对应的播放列表URL

示例配置：

Jellyfin TV Show Collection:
  = Education:
    "Ben Eater":
      s01_name: "计算机组成原理"
      s01_url: "https://www.example.com/playlist?list=PL..."
      s02_name: "数字电路设计"
      s02_url: "https://www.example.com/playlist?list=PL..."

常见问题解析

1. 无内容下载问题： 当未指定季参数时，工具会静默失败而不下载任何内容。这是因为预设会生成40个季的下载任务(从s01到s40)，但如果没有为这些季提供具体的URL和名称，所有下载任务都会被跳过。

2. 与TV Show by Date预设的区别：

• TV Show Collection：按用户定义的季分类
• TV Show by Date：自动按上传日期组织内容

3. 变量覆盖机制： 预设中使用了大量变量(s01_name, s01_url等)，用户必须覆盖这些变量才能正常工作。

最佳实践建议

1. 始终为每个季指定名称和URL
2. 使用--dry-run参数测试配置
3. 检查生成的完整YAML配置(通过日志输出)
4. 从少量季开始测试，确认无误后再扩展

技术实现原理

该预设内部会：

1. 为每个季创建独立的下载任务
2. 生成季海报和剧集缩略图
3. 创建符合Jellyfin标准的NFO元数据文件
4. 维护下载存档以避免重复下载

总结

TV Show Collection预设是ytdl-sub中强大的内容组织功能，但需要正确配置季参数才能发挥作用。理解其工作原理和配置要求，可以帮助用户更好地管理在线上的系列视频内容。