ytdl-sub

使用 YoutubeDL 自动下载和元数据生成。

ytdl-sub是一个命令行工具，可通过 yt-dlp 下载媒体并为您最喜爱的媒体播放器（包括 Kodi、Jellyfin、Plex、Emby 和现代音乐播放器）做好准备。不需要额外的插件或外部刮刀。

我们认识到每个人存储媒体的方式都不同。我们的文件和元数据格式化方法是在保持简单性的同时提供最大的灵活性。

YouTube 频道作为电视节目

丛

果冻

音乐视频和音乐会

科迪

果冻

SoundCloud 唱片目录

通过 beets API 写入正确的音乐标签

乐队营唱片目录

它是如何运作的

ytdl-sub使用 YAML 文件来定义订阅。每个订阅都会导入定义如何处理和输出媒体文件的预设。 ytdl-sub附带了许多预构建的预设，这些预设可以完成配置构建工作，因此您可以立即开始下载。

 # subscriptions.yaml:# 这里的所有内容都可以使用以下命令下载:# ytdl-sub sub subscriptions.yaml# __preset__ 是为所有订阅定义全局覆盖的地方__preset__: overrides: # 所有 ytdl-sub 电视节目的根文件夹 tv_show_directory ：“/电视节目”
        # 所有 ytdl-sub 音乐的根文件夹 music_directory: "/music"
        # 所有 ytdl-sub 音乐视频的根文件夹 music_video_directory: "/music_videos"
        # 对于“仅最近”预设，仅保留此范围内的视频并限制 only_recent_date_range: "2months" only_recent_max_files: 30
      # 将任何参数直接传递给 yt-dlp 的 Python API ytdl_options: cookiefile: "/config/cookie.txt" ############################ ########################################电视节目预设。可以按日期将 Plex 替换为 Plex/Jellyfin/KodiPlex 电视节目： # 将类型标签设置为“纪录片”= 纪录片：“NOVA PBS”：“https://www.youtube.com/@novapbs”“国家地理”：“ https://www.youtube.com/@NatGeo" "Cosmos - What If": "https://www.youtube.com/playlist?list=PLZdXRHYAVxTJno6oFF9nLGuwXNGYHmE8U" # 将流派标签设置为“Kids”、“TV-Y” “内容分级=儿童| = TV-Y: "Jake Trains": "https://www.youtube.com/@JakeTrains" "Kids Toys Play": "https://www.youtube.com/@KidsToysPlayChannel" = 音乐: # 电视节目订阅可以支持多个 url 并存储在同一电视节目“Rick Beato”中：
      - “https://www.youtube.com/@RickBeato”
      - "https://www.youtube.com/@rickbeato240" # 将流派标签设置为“新闻”，使用“仅最近”预设仅存储最近上传的视频 = 新闻 |仅最近： "BBC News": "https://www.youtube.com/@BBCNews"Plex TV Show Collection: = Music: # 前缀为 ~ 以设置特定覆盖变量 "~Beyond the Guitar": s01_name: "Videos " s01_url: "https://www.youtube.com/c/BeyondTheGuitar" s02_name: "封面" s02_url: "https://www.youtube.com/playlist?list=PLE62gWlWZk5NWVAVuf0Lm9jdv_-_KXs0W"###### #################################################### ############ 音乐预设。可以用 Plex/Jellyfin/Kodi 替换 PlexYouTube Releases: = Jazz: # 将流派标签设置为“Jazz” "Thelonious Monk": "https://www.youtube.com/@theloniousmonk3870/releases"YouTube 完整专辑: = Lofi: “Game Chops”：“https://www.youtube.com/playlist?list=PLBsm_SagFMmdWnCnrNtLjA9kzfrRkto4i”SoundCloud Discography：= Chill Hop：“UKNOWY”：“https://soundcloud.com/uknowymunich”= Synthwave：“Lazerdiscs Records ": "https://soundcloud.com/lazerdiscsrecords" "Earmake": "https://soundcloud.com/earmake"Bandcamp: = Lofi: "Emily Hopkins": "https://emilyharpist.bandcamp.com/" #################################################### ################## 音乐视频预设"Plex Music Videos": = Pop: # 将流派标签设置为“Pop” "Rick Astley": "https://www. youtube.com/playlist?list=PLlaN88a7y2_plecYoJxvRFTLHVbIVAOoc" "迈克尔·杰克逊": "https://www.youtube.com/playlist?list=OLAK5uy_mnY03zP6abNWH929q2XhGzWD_2uKJ_n8E"

所有这些都可以使用命令下载并准备导入到您最喜欢的播放器中

ytdl-sub sub subscriptions.yaml

有关更详细的示例和用例，请参阅我们的示例订阅。

输出

ytdl-sub运行后，最终结果将下载文件并将其格式化为可供您喜爱的媒体播放器/服务器使用的文件。

tv_shows/
  Jake Trains/
    Season 2021/
      s2021.e031701 - Pattys Day Video-thumb.jpg
      s2021.e031701 - Pattys Day Video.mp4
      s2021.e031701 - Pattys Day Video.nfo
      s2021.e031702 - Second Pattys Day Video-thumb.jpg
      s2021.e031702 - Second Pattys Day Video.mp4
      s2021.e031702 - Second Pattys Day Video.nfo
    Season 2022/
      s2022.e122501 - Merry Christmas-thumb.jpg
      s2022.e122501 - Merry Christmas.mp4
      s2022.e122501 - Merry Christmas.nfo
    poster.jpg
    fanart.jpg
    tvshow.nfo

music/
  Artist/
    [2022] Some Single/
      01 - Some Single.mp3
      folder.jpg
    [2023] Latest Album/
      01 - Track Title.mp3
      02 - Another Track.mp3
      folder.jpg

music_videos/
  Elton John/
    Elton John - Rocketman.jpg
    Elton John - Rocketman.mp4