yt-dlp

基于 Python · 开源免费，本地部署，数据完全自主可控

⭐ 85.0k Stars 💻 Python 📄 Unlicense 🏷 AI 9.5分

9.5AI 综合评分

视频下载字幕元数据Python命令行开源

🌐 访问官网

✦ AI Skill Hub 推荐

经 AI Skill Hub 精选评估，yt-dlp 获评「强烈推荐」。在 GitHub 上收获超过 85.0k 颗 Star，这款AI工具在功能完整性、社区活跃度和易用性方面表现出色，AI 评分 9.5 分，适合有一定技术背景的用户使用。

📚 深度解析

yt-dlp 是目前维护最活跃、兼容性最强的开源视频下载工具，由社区从 youtube-dl 分支而来，专门解决原版长期停止更新、频繁失效的问题。它支持从 YouTube、Bilibili、Twitch、Twitter/X、Instagram、TikTok 等超过 1000 个视频网站下载视频和音频内容，是内容创作者、视频剪辑师和媒体研究人员的核心效率工具。

**为什么选择 yt-dlp 而不是其他工具？**
与 youtube-dl 相比，yt-dlp 在速度上有显著提升，支持并发下载片段（aria2c 集成），下载速度通常快 3-5 倍。更重要的是，yt-dlp 拥有活跃的 GitHub 社区，每当 YouTube 等平台更新反爬策略导致下载中断时，通常在 1-3 天内就会发布修复版本。强烈建议通过 pip install -U yt-dlp 定期更新。

**常见使用场景与技巧**
下载 YouTube 视频时，可以用 -f 参数精确指定格式和分辨率：-f "bv*[ext=mp4]+ba[ext=m4a]/b[ext=mp4]" 可以获得最佳兼容性的 mp4 文件。对于播放列表，--playlist-start 和 --playlist-end 参数可以指定下载范围，避免一次性下载全部内容。--write-subs --sub-langs "zh-Hans,en" 参数会同时下载中英文字幕。

yt-dlp 支持通过 --cookies-from-browser chrome 直接读取浏览器的 Cookie，从而下载需要登录的会员内容或地区限制视频，无需手动导出 Cookie 文件。对于 Bilibili 用户，添加 Cookie 后可以下载 1080P 以上分辨率的大会员内容。

**与 ffmpeg 的组合使用**
yt-dlp 本身依赖 ffmpeg 处理视频封装和音视频合并，因此使用前需要确认系统已安装 ffmpeg 并将其加入 PATH。yt-dlp + ffmpeg + auto-subtitle 是目前最流行的"下载-转录-字幕"三件套，可以实现从网络视频到带字幕本地文件的全自动化流程。

**合规说明**
yt-dlp 作为工具本身是合法的开源软件（The Unlicense 协议），但使用它下载受版权保护的内容是否合法，取决于你所在地区的法律和平台服务条款。AI Skill Hub 建议仅用于有合法权限的内容：个人备份自己上传的内容、平台明确允许下载的开放授权内容，或在版权法允许的合理使用范围内。

📋 工具概览

功能强大的视频下载工具，支持数千个视频平台，含字幕/封面/元数据下载

yt-dlp 是一款基于 Python 开发的开源工具，专注于视频下载、字幕、元数据等核心功能。作为 GitHub 开源项目，它拥有活跃的社区支持和持续的版本迭代，代码完全透明可审计，支持本地部署以保护数据隐私。无论是个人使用还是集成到企业工作流，都能提供稳定可靠的解决方案。

GitHub Stars

⭐ 85.0k

开发语言

Python

支持平台

Windows / macOS / Linux

维护状态

活跃维护，更新频繁

开源协议

Unlicense

AI 综合评分

9.5 分

工具类型

AI工具

Forks

—

📖 中文文档

以下内容由 AI Skill Hub 根据项目信息自动整理，如需查看完整原始文档请访问底部「原始来源」。

功能强大的视频下载工具，支持数千个视频平台，含字幕/封面/元数据下载

📌 核心特色

开源免费，支持本地部署，数据完全自主可控
活跃的 GitHub 开源社区，持续迭代更新
提供详细文档和使用示例，新手友好
支持自定义配置，灵活适配不同使用环境
可作为基础组件集成进现有技术栈或进行二次开发

🎯 主要使用场景

本地部署运行，保护数据隐私，满足合规要求
自定义集成到现有系统，扩展技术栈能力
作为开源基础组件进行商业化二次开发

以下安装命令基于项目开发语言和类型自动生成，实际以官方 README 为准。

安装命令

# 方式一：pip 安装（推荐）
pip install yt-dlp

# 方式二：虚拟环境安装（推荐生产环境）
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install yt-dlp

# 方式三：从源码安装（获取最新功能）
git clone https://github.com/yt-dlp/yt-dlp
cd yt-dlp
pip install -e .

# 验证安装
python -c "import yt_dlp; print('安装成功')"

📋 安装步骤说明

访问 GitHub 仓库页面
按照 README 文档完成依赖安装
根据系统环境完成初始化配置
参考官方示例或文档开始使用
遇到问题可在 GitHub Issues 中查找解答

以下用法示例由 AI Skill Hub 整理，涵盖最常见的使用场景。

常用命令 / 代码示例

# 下载视频（自动选最佳画质）
yt-dlp "https://www.youtube.com/watch?v=VIDEO_ID"

# 下载最高分辨率（1080p）
yt-dlp -f "bestvideo[height<=1080]+bestaudio" "URL"

# 仅提取音频（MP3 格式）
yt-dlp -x --audio-format mp3 "URL"

# 下载并自动生成中文字幕
yt-dlp --write-sub --sub-lang zh-Hans "URL"

# 批量下载（从 URL 列表文件读取）
yt-dlp -a urls.txt --output "%(title)s.%(ext)s"

# 仅下载字幕文件（不下载视频）
yt-dlp --write-sub --skip-download "URL"

以下配置示例基于典型使用场景生成，具体参数请参照官方文档调整。

配置示例

# yt-dlp 配置文件示例（config.yml）
app:
  name: "yt-dlp"
  debug: false
  log_level: "INFO"

# 运行时指定配置文件
yt-dlp --config config.yml

# 或通过环境变量配置
export YT_DLP_API_KEY="your-key"
export YT_DLP_OUTPUT_DIR="./output"

⚡ 核心功能