yt-dlp：命令行音视频下载器

项目简介

yt-dlp 是一个功能丰富的命令行音频/视频下载器，支持数千个网站。项目是 youtube-dl 的 fork，基于已停止维护的 youtube-dlc 发展而来。

主要功能

• 覆盖大量站点的提取器（extractor），并支持通过 --extractor-args 传入提取器参数
• 完善的格式选择能力：按条件过滤（Filtering Formats）、排序（Sorting Formats）后自动挑选最佳格式
• 输出模板（Output Template），自定义保存的文件名与目录结构
• 下载后可修改元数据（Modifying Metadata）
• 支持 SponsorBlock，可标记或跳过视频中的赞助片段
• 缩略图、字幕、 Internet Shortcut 等相关选项
• 支持配置文件、环境变量，以及通过 netrc 进行认证
• 插件机制：可安装第三方插件，也可自行开发插件
• 可作为 Python 库嵌入到其他程序中（Embedding yt-dlp）
• 提供 stable、nightly、master 三个发布通道，并支持自更新

安装与使用

可通过发布的可执行文件、pip 或第三方包管理器安装，详细说明见 wiki。

常用发布文件：

文件	说明
yt-dlp	与平台无关的 zipimport 二进制，需要 Python（推荐 Linux/BSD 使用）
yt-dlp.exe	Windows（Win10+）独立 x64 二进制（推荐 Windows 使用）
yt-dlp_macos	通用 macOS（10.15+）独立可执行文件（推荐 macOS 使用）
yt-dlp_linux	Linux（glibc 2.17+）独立 x86_64 二进制
yt-dlp_musllinux	Linux（musl 1.2+）独立 x86_64 二进制

使用 pip 安装 nightly 版本：

python -m pip install -U --pre "yt-dlp[default]"

使用发布二进制时，可用 yt-dlp -U 更新；用 pip 安装的则重新执行原安装命令。--update-to 可在不同通道间切换或升降级到指定 tag，例如：

yt-dlp --update-to master
yt-dlp --update-to [email protected]
yt-dlp --update-to 2023.10.07

从 stable 更新到 nightly：

yt-dlp --update-to nightly

注意事项

• 需要 Python 3.11+（CPython 与 PyPy），其他版本不保证可用。
• stable 通道按大致每月一次的节奏发布，最新版本常常滞后，容易因网站改动而失效；nightly 是官方推荐普通用户使用的通道，master 提供最新修复但可能引入 bug。
• 运行超过 90 天的旧版本时会提示更新，可在命令或配置文件中加入 --no-update 关闭该提示。
• 使用 --update-to <repository> 从其他仓库更新时不做任何校验，需谨慎。
• 项目本身采用 Unlicense；但 PyInstaller 打包的可执行文件包含 GPLv3+ 代码，整体按 GPLv3+ 分发；zipimport 的 Unix 可执行文件与源码 tarball 还包含 meriyah（ISC）与 astring（MIT）的代码，详见 THIRD_PARTY_LICENSES.txt。
• manpage、shell 补全文件等位于源码 tarball 中。

---

本作品整理自 GitHub 开源项目 yt-dlp/yt-dlp，原作者 @yt-dlp，许可证 Unlicense。中文介绍由 AI 根据项目 README 整理，以原仓库为准。