yt-dlp：一款功能丰富的命令行音频/视频下载器
2025年12月18日 19:49
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 获取社区支持。
