FEATURES

功能特性

yt-dlp 不止是「视频下载器」,更是一套完整的媒体获取与处理管线。以下能力全部内置,无需额外付费,自由组合、按需使用。

Core Capabilities

核心能力

围绕「下载」构建的四项基础能力,覆盖绝大多数使用场景。

上千网站支持

内置数百个站点提取器(Extractor),覆盖 YouTube、Bilibili、TikTok、Twitter/X、Instagram、Facebook、Reddit、SoundCloud、Twitch、Vimeo、Dailymotion、微博、AcFun 等平台。完整支持列表超过 1700 个站点,每次更新都会适配新站点、修复旧站点。

格式自由选择

通过 -f-S 参数,可按分辨率、编码(H.264/H.265/AV1/VP9)、码率、大小等维度筛选与排序。支持音视频流分离下载后自动合并,1080p 以上的高画质同样轻松获取。

批量下载与频道抓取

支持单个视频、播放列表、整个频道、用户主页等批量抓取;通过 -a urls.txt 批量导入链接,配合输出模板自动整理目录结构。

断点续传与并发加速

下载中断后自动续传,不浪费已有进度;支持多线程并发下载(-N),并可对接 aria2c 等外部下载器,充分利用带宽。

Post-processing

智能后处理

下载完成只是开始,yt-dlp 会自动完成转码、合并与增强。

FFmpeg 集成

自动调用 FFmpeg 完成音视频流合并、容器封装(MP4/MKV/WebM)与格式转换,无需手动操作。

SponsorBlock 跳过

内置 SponsorBlock 支持,可自动跳过或标记赞助商片段、片头片尾、互动环节,观看体验更纯净。

音频提取转码

一条命令将视频转为 MP3、M4A、FLAC、Opus 等音频格式,支持按码率、声道、采样率精细控制。

Metadata & Subtitles

元数据与字幕

收藏的内容不再是一堆无意义的文件名,而是信息完整的媒体资产。

字幕与弹幕

下载原生字幕(SRT/VTT/ASS)并自动合并到视频;支持多语言字幕选择、自动翻译字幕,以及部分平台弹幕抓取。

元数据嵌入

标题、作者、封面、描述、上传日期、标签等元数据自动写入文件,媒体库(如 Plex、Jellyfin)识别更准确。

缩略图与封面

自动下载并嵌入视频封面缩略图,支持自定义尺寸与质量,列表视图一目了然。

Customization & Extensibility

自定义与扩展

从个人偏好到企业级集成,yt-dlp 为高级用户预留了充分的空间。

输出模板

通过 -o 自定义文件命名与目录结构,如按「频道/系列/标题」自动归档,适合大型媒体库管理。

配置文件

全局或按目录编写配置文件(config.txt),默认参数、常用模板、代理设置一次写好,处处生效。

插件机制

社区插件可扩展新站点支持与自定义后处理;开发者可基于插件 API 快速发布自己的扩展,安装即用。

嵌入 API

yt-dlp 可作为 Python 库嵌入任意应用:import yt_dlp,获取元数据、执行下载、处理后事,一站集成。

自动更新

yt-dlp -U 一键更新,stable / nightly / master 三个发布通道自由切换,始终与最新站点适配保持同步。

Comparison

与 youtube-dl 的差异

yt-dlp 是 youtube-dl 的高性能分支,继承了全部核心能力,并带来大量新特性。

能力对比 yt-dlp youtube-dl(原版)
维护与更新频率高频更新,几乎每日提交基本停止活跃维护
SponsorBlock 赞助片段跳过内置支持不支持
音视频流自动合并自动合并至 8K / HDR支持有限
格式筛选与排序-f / -S 精细控制能力较弱
并发下载与断点续传-N 多线程 + -c 续传不支持并发
插件扩展机制官方插件 API
嵌入 Python APIimport yt_dlp支持(能力有限)
新站点适配速度网站变更后数天内修复响应缓慢

功能如此强大,现在就用起来

最新版本 2026.07.04 已发布,支持 Windows、macOS、Linux 与 BSD。