yt-dlp

yt-dlp是什么？

yt-dlp是一款开源的命令行音视频下载工具工具，用于从YouTube、B 站、TikTok 等 1000+ 网站 下载视频和音频。它是 youtube-dl 的增强版，功能更强大、更新更频繁。

主要功能特点​

1. ​​全面兼容​​
   • 支持 ​​数千个网站​​ 的视频/音频下载，覆盖主流平台及小众资源。
   • 兼容 youtube-dl 的配置文件和命令，无缝迁移旧脚本。
2. ​​智能格式选择​​
   • 自动选择最佳画质（比如 1080p+、HDR 或杜比音效），以及手动填写格式（如 bestvideo+bestaudio 指定合并音视频）。
   • 过滤低质量、指定分辨率/编码格式（如 –format 1080p 或 –exclude h265）。
3. ​​高性能下载​​
   • 多线程分段下载（如 HLS/DASH 流媒体），支持外部下载器（aria2c、wget）加速。
   • 断点续传、自动重试，应对网络不稳定场景。
4. ​​深度定制​​
   • ​​元数据嵌入​​：将标题、封面、描述、章节等信息写入视频文件（支持 MKV/MP4）。
   • ​​字幕处理​​：自动提取内嵌/外挂字幕，支持多语言筛选（如 –sub-lang en,zh）。
   • ​​插件扩展​​：通过社区插件增强功能（如赞助商内容标记 –sponsorblock）。
5. ​​高级场景支持​​
   • ​​直播流录制​​：从直播开始时间下载（需实验性功能）。
   • ​​分章节下载​​：按视频章节分割输出文件（如 –split-chapters）。
   • ​​反反爬机制​​：模拟浏览器行为（伪造 User-Agent/IP）、Cookie 登录（如 YouTube 账户认证）。

使用场景

• 视频备份与存档：下载个人频道内容或课程视频，保存为本地文件。
• 音频提取：从音乐视频中提取高质量音频，用于离线播放。
• 科研与数据采集：批量下载特定平台的公开视频数据，用于分析或研究。
• 教育与学习：下载在线课程或教程，支持离线观看，不受网络限制。

使用方法

安装

通过pip安装，默认情况下会安装所有依赖项

python -m pip install -U “yt-dlp[default]”

下载单个视频

yt-dlp 是一款命令行工具，使用起来非常简单。只需在命令行中输入简单的命令，即可下载你想要的视频。例如，下载一个 YouTube 视频，只需输入：

yp-dlp <视频URL>

默认下载最高质量的视频和音频，并自动合并。

合并指的是将视频和音频合并成一个完整的视频文件。为什么需要合并？视频平台有时候会将视频和音频分开存储，yp-dlp会分别下载视频和音频，然后使用工具ffmpeg将它们合并成一个文件

下载音频

提取音频并转换为MP3：

yt-dlp -x –audio-format –audioo-quality 0 mp3 <视频URL>

• x：提取音频 –audio-format
• mp3：转换为 .mp3 格式 –audio-quality
• 0：指定音频质量（0 是最高质量，9 是最低质量）

下载指定格式的视频

列出所有可用的视频和音频格式及其对应的代码：

yt-dlp -F <视频URL>

• ID：格式的唯一标识符，用于指定下载的格式
• EXT：文件扩展名（如mp4、webm、m4a）
• RESOLUTION：视频分辨率（如1920 x 1080表示1080p）
• FPS：视频帧率（30表示30帧/秒）
• FILESIZE：文件大小（如果为空，则表示文件大小未知）
• TBR：总比特率（单位：kbps）
• PROTO：协议（如https、m3u8）
• VCODEC：视频编码格式（如 avc1 表示 H.264，vp9 表示 VP9）
• ACODEC：音频编码格式（如 mp4a.40.2 表示 AAC，opus 表示 Opus）
• MORE INFO：附加信息（如语言、质量等）

下载1080p视频和音频，并自动合并

yt-dlp -f 616+140 <视频URL>

下载到指定目录并自定义文件名

下载视频并保存到指定目录，文件名使用视频标题，文件后缀使用文件扩展名

yt-dlp -o “D:\dev\Videos\%(title)s.%(ext)s” <视频URL>

批量下载

将多个视频 URL 放在 urls.txt 文件中，批量下载

yt-dlp -a urls.txt