使用ytdl-sub解析YouTube剧集视频的系列与集数信息

在YouTube上，许多节目仍然采用传统的季/集格式命名视频，例如《Taskmaster》和《Last Week Tonight》等节目。本文将介绍如何利用ytdl-sub工具来正确解析这些视频的季数和集数信息，并自动整理成适合媒体服务器(如Jellyfin)的格式。

问题背景

许多YouTube视频的标题包含季(Series/Season)和集(Episode)编号信息，例如"Series 1, Episode 6 - 'The last supper' | Full Episode | Taskmaster"。传统的ytdl-sub配置通常会将上传年份作为季数，这并不符合这类节目的实际季集结构。

解决方案

我们可以通过创建自定义预设(preset)来正确解析这些信息。以下是完整的实现方案：

1. 创建预设配置

在config.yml文件中添加以下预设配置：

presets:
  TaskmasterPlaylist:
    preset:
      - "Jellyfin TV Show by Date"  # 使用Jellyfin兼容的预设
      - "best_video_quality"        # 获取最佳视频质量

      # 解析季数
      season_number: >-
        {
          %array_at(
            %regex_capture_many(
              title,
              [
                "(?:Series|Season) ([0-9]+)"
              ],
              ["0"]
            ),
            1
          )
        }
      
      # 格式化季数为两位数
      season_number_padded: >-
        { %pad(season_number, 2, "0") }
      
      # 解析集数
      episode_number: >-
        {
          %array_at(
            %regex_capture_many(
              title,
              [
                "Episode ([0-9]+)"
              ],
              ["0"]
            ),
            1
          )
        }
      
      # 格式化集数为两位数
      episode_number_padded: >-
        { %pad(episode_number, 2, "0") }
      
      # 生成文件名格式
      episode_file_name: "S{season_number_padded}E{episode_number_padded}"

2. 订阅配置

在subscriptions.yml文件中，可以简单地引用这个预设：

TaskmasterPlaylist:
  = Game-Show:
    "Taskmaster": "https://www.youtube.com/playlist?list=..."

3. 优化元数据处理(可选)

如果节目在TMDB等数据库中有完整信息，可以禁用不必要的元数据文件生成：

    # 禁用NFO文件生成
    nfo_tags:
      enable: False
    overrides:
      # 不下载横幅
      tv_show_fanart_file_name: ""
      # 不下载海报
      tv_show_poster_file_name: ""
      # 不下载缩略图
      thumbnail_name: ""

技术解析

1. 正则表达式捕获：使用%regex_capture_many函数从标题中提取季数和集数信息。正则表达式(?:Series|Season) ([0-9]+)匹配"Series"或"Season"后的数字，Episode ([0-9]+)匹配集数。

2. 数组处理：%array_at函数用于从捕获结果中提取特定位置的匹配项。

3. 数字格式化：%pad函数确保季数和集数以两位数显示(如S01E06)。

4. 文件名生成：最终生成标准的季集格式文件名，如S01E06.webm。

优势

1. 自动化处理：自动从视频标题中提取正确的季集信息，无需手动干预。
2. 兼容性：生成的文件名和元数据与Jellyfin等媒体服务器完美兼容。
3. 灵活性：正则表达式可以根据不同节目的标题格式进行调整。

通过这种配置，ytdl-sub能够智能地解析YouTube上传统季集结构的节目，为媒体服务器提供结构化的视频库，大大简化了视频管理的复杂度。