功能最全的命令行音视频下载器,youtube-dl 的活跃 fork,支持数千个站点,176k stars,Unlicense(核心代码)。

概述

yt-dlp 是 youtube-dl 的 fork(源自曾经不活跃的 youtube-dlc),在原有基础上持续修复站点适配、加速下载、扩展功能,是目前维护最活跃、功能最全的音视频下载工具。支持 YouTube、Bilibili、Twitter/X、TikTok、Instagram、Vimeo 等数千个网站。

核心能力

  • 格式选择:精细的视频/音频格式筛选与排序(分辨率/编码/码率/文件大小)
  • 字幕/字幕轨:下载人工或自动生成的字幕,支持嵌入或独立文件
  • SponsorBlock 集成:自动跳过或标记视频中的广告/赞助片段
  • 元数据修改:写入标题/描述/缩略图等元数据
  • 插件系统:支持第三方 extractor/postprocessor 插件
  • 输出模板:灵活的文件命名模板语法
  • 可嵌入:可作为 Python 库直接调用(import yt_dlp)

发布渠道

渠道说明
stable月度发布,官方推荐渠道但可能因站点变更而”过时”
nightly每日构建,官方推荐常规用户使用
master每次 push 后发布的 canary 版本,最新但可能不稳定

依赖

Python 3.10+(CPython)或 3.11+(PyPy)。提供独立二进制(Windows/Linux/macOS),无需系统装 Python。

与相关工具的关系

  • claude-video — bradautomates/claude-video 的 /watch Skill 用 yt-dlp 做视频下载和字幕抓取,是其核心依赖之一(配合 ffmpeg 抽帧)
  • 与原始 youtube-dl 是 fork 关系,功能上已全面超越并取代后者

资源