使用ytdl-sub创建首个媒体订阅配置指南

最新推荐文章于 2025-06-25 09:08:43 发布

原创最新推荐文章于 2025-06-25 09:08:43 发布 · 227 阅读

CC 4.0 BY-SA版权

使用ytdl-sub创建首个媒体订阅配置指南

ytdl-sub Automate downloading and metadata generation with YoutubeDL 项目地址: https://gitcode.com/gh_mirrors/yt/ytdl-sub

什么是ytdl-sub

ytdl-sub是一个强大的视频内容下载与媒体库管理工具，它允许用户通过简单的YAML配置文件定义订阅规则，自动下载视频频道、播放列表等内容，并将其整理成适合Plex、Jellyfin等媒体服务器的格式。

创建第一个订阅配置文件

下面我们将逐步解析一个典型的ytdl-sub订阅配置文件，帮助您快速上手。

基础配置文件结构

__preset__:
  overrides:
    tv_show_directory: "/tv_shows"
    music_directory: "/music"

Jellyfin TV Show by Date:
  = Documentaries:
    "NOVA PBS": "https://www.example.com/@novapbs"

  = Kids | = TV-Y:
    "Jake Trains": "https://www.example.com/@JakeTrains"

Video Releases:
  = Jazz:
    "Thelonious Monk": "https://www.example.com/@theloniousmonk3870/releases"

Video Full Albums:
  = Lofi:
    "Game Chops": "https://www.example.com/playlist?list=PLBsm_SagFMmdWnCnrNtLjA9kzfrRkto4i"

配置文件详解

1. 全局预设部分

__preset__:
  overrides:
    tv_show_directory: "/tv_shows"
    music_directory: "/music"

这部分定义了全局变量，会被文件中所有订阅继承：

tv_show_directory：指定电视节目的存储路径
music_directory：指定音乐内容的存储路径

技术提示：overrides部分仅用于变量定义，其他插件配置需要与overrides同级设置。

2. 预设选择

# Can choose between:
#  - Plex TV Show by Date:
#  - Jellyfin TV Show by Date:
#  - Kodi TV Show by Date:
#
Jellyfin TV Show by Date:

这里我们选择了Jellyfin TV Show by Date预设，它会将内容组织成Jellyfin媒体服务器可识别的电视节目格式。根据您的媒体服务器类型，可以选择对应的预设。

3. 分类与订阅定义

= Documentaries:
  "NOVA PBS": "https://www.example.com/@novapbs"

这部分包含几个关键元素：

= Documentaries：设置内容分类（会写入元数据标签）
"NOVA PBS"：订阅名称（会用作电视节目名称）
URL：要订阅的视频频道地址

4. 多标签分类

= Kids | = TV-Y:
  "Jake Trains": "https://www.example.com/@JakeTrains"

使用|分隔符可以同时设置多个分类标签：

= Kids：设置内容类型
= TV-Y：设置内容分级

5. 音乐内容订阅

Video Releases:
  = Jazz:
    "Thelonious Monk": "https://www.example.com/@theloniousmonk3870/releases"

Video Full Albums:
  = Lofi:
    "Game Chops": "https://www.example.com/playlist?list=PLBsm_SagFMmdWnCnrNtLjA9kzfrRkto4i"

这部分展示了音乐内容的订阅方式：