yt-dlp:一款功能丰富的命令行音频/视频下载器
yt-dlp 是一个功能强大的命令行工具,用于从各种网站下载视频、音频和其他媒体内容。它支持的站点非常广泛,涵盖了全球范围内的主流媒体平台、社交媒体平台、新闻网站、教育平台等。
yt-dlp 简介
- 项目名称:yt-dlp
- 项目地址:https://github.com/yt-dlp/yt-dlp
- 项目描述:yt-dlp 是一款功能丰富的命令行音频/视频下载器,支持数千个网站。它是基于现已停止维护的 youtube-dlc 开发的 youtube-dl 分支。
- 项目状态:活跃开发中,最新版本为 2025.12.08,拥有 139k 颗星和 11.2k 个分叉。
- 项目特点:
- 支持多种网站的音频/视频下载。
- 提供丰富的命令行选项,用于定制下载行为。
- 支持多种格式选择、后处理(如提取音频、嵌入元数据等)。
- 支持从浏览器导入 cookies,便于登录下载。
- 支持 SponsorBlock,可用于去除 YouTube 视频中的赞助部分。
安装方法
- 二进制文件:提供多种平台的预编译二进制文件,包括 Windows、Linux、MacOS 等。
- pip 安装:可通过 Python 的包管理工具 pip 安装。
- 其他包管理器:支持通过 Homebrew(MacOS)、Chocolatey(Windows)等第三方包管理器安装。
下载地址
| 文件 | 描述 |
|---|---|
| yt-dlp | 平台无关的zipimport二进制文件。需要 Python(推荐用于Linux/BSD)。 |
| yt-dlp.exe | Windows(Win8+)独立 x64 二进制文件(推荐用于Windows) |
| yt-dlp_macos | 通用 macOS (10.15+) 独立可执行文件(推荐用于macOS) |
使用方法
- 基本命令:
yt-dlp [OPTIONS] [--] URL [URL...] - 常用选项:
-f:指定下载的视频格式。-o:指定输出文件名模板。-P:指定下载路径。-x:提取音频。--embed-thumbnail:将缩略图嵌入视频文件。--write-info-json:将视频元数据写入.info.json文件。
- 高级功能:
- 支持通过
.netrc文件进行身份验证。 - 支持自定义配置文件,可放置在多个位置(如用户目录、系统目录等)。
- 支持插件系统,可扩展功能。
- 支持通过
配置文件
- 配置文件位置:
- 主配置文件:通过
--config-locations指定。 - 便携配置文件:与可执行文件同目录下的
yt-dlp.conf。 - 用户配置文件:
~/.config/yt-dlp/yt-dlp.conf或~/.yt-dlp.conf。 - 系统配置文件:
/etc/yt-dlp/yt-dlp.conf。
- 主配置文件:通过
- 配置文件格式:支持命令行选项的格式,例如
-x、--embed-thumbnail等。
输出模板
- 模板语法:使用
%(字段)s格式,支持多种字段,如title、id、ext等。 - 特殊功能:
- 支持日期时间格式化,如
%(upload_date>%Y-%m-%d)s。 - 支持条件表达式,如
%(field|默认值)s。 - 支持字段替换和解析,通过
--parse-metadata和--replace-in-metadata。
- 支持日期时间格式化,如
格式选择
- 默认行为:下载最佳质量的视频和音频。
- 格式选择语法:
- 使用
-f指定格式,如bv*+ba/b。 - 支持过滤和排序,如
-S选项。 - 支持多种格式,如
mp4、webm等。
- 使用
- 高级用法:
- 支持下载多个格式并合并。
- 支持下载特定分辨率或比特率的格式。
后处理选项
- 提取音频:通过
-x选项提取音频。 - 嵌入元数据:通过
--embed-metadata嵌入元数据到视频文件。 - 转换格式:支持将视频转换为其他格式,如
--remux-video。 - 处理字幕:支持下载和嵌入字幕。
插件系统
- 插件类型:支持提取器插件和后处理插件。
- 安装方法:可通过配置目录、pip 或其他方式安装插件。
- 开发指南:提供插件开发指南和示例代码。
兼容性选项
- 与 youtube-dl 兼容:提供
--compat-options选项,用于恢复与 youtube-dl 相同的行为。 - 与 youtube-dlc 兼容:同样支持与 youtube-dlc 的兼容性设置。
很抱歉,我无法直接访问网页链接。不过,根据您提供的文件内容,我可以为您整理一份关于 yt-dlp 支持的站点的详尽笔记。
支持的站点分类
以下是根据功能和类型对支持的站点进行的分类整理:
1. 主流视频平台
- YouTube:支持下载视频、播放列表、用户视频、搜索结果等。
- Bilibili:支持下载视频、音频、有声专辑、收藏列表等。
- TikTok:支持下载视频、用户视频、直播等。
- Dailymotion:支持下载视频、播放列表、用户视频等。
- Vimeo:支持下载视频、播放列表、用户视频等。
2. 社交媒体平台
- Facebook:支持下载视频、广告、故事等。
- Instagram:支持下载视频、用户视频、故事等。
- Twitter:支持下载视频、直播、推文中的视频等。
- Twitch:支持下载直播、视频、剪辑等。
3. 新闻媒体平台
- CNN:支持下载新闻视频。
- BBC:支持下载 BBC iPlayer 视频。
- Fox News:支持下载新闻视频。
- The New York Times:支持下载视频。
4. 教育平台
- Khan Academy:支持下载课程视频。
- Coursera:支持下载课程视频。
- Udemy:支持下载课程视频。
- edX:支持下载课程视频。
5. 音乐平台
- Spotify:支持下载音乐、播放列表等。
- SoundCloud:支持下载音乐、播放列表、用户音乐等。
- QQ Music:支持下载音乐、专辑、MV 等。
- NetEase Cloud Music:支持下载音乐、专辑、MV 等
其他信息
- 支持站点列表:可在 supportedsites.md 查看支持的站点列表。
- 文档:提供详细的 Wiki 文档。
- 社区支持:可通过 Discord 获取社区支持。