Win10 Python yt-dlp下载youtube视频 | 安装使用详细教程

---

---

前言

yt-dlp是一个命令行程序，可在youtube、twitch、bilbili、西瓜视频等一千多个网站下载视频资源¹。国内平台的解析工具已经存在很多，像you-get之类，我们主要用它来下载海外视频。
作为youtube-dl的增补版，yt-dlp有着比起前辈更快的速度，以及众多新特性。本文仅记录win10系统python环境下的跑通方法。在尝试前，先确保本地存在3.7+的python版本，推荐安装ffmpeg、ffprobe等依赖，以方便视频合并、转码等后续处理。
官方项目地址：https://github.com/yt-dlp/yt-dlp

本文仅作学习记录，如有错误欢迎提出，持续更新。

---

0.科学上网

下载youtube视频的前提是自由访问，默认读到本文的应该都已实现科学访问了~
没有的同学请先行寻找合适的加速器

1.安装yt-dlp

打开命令行输入：

pip install yt-dlp

速度慢可以更换pip镜像源，或在pypi下载离线安装

2.安装FFmpeg

这里的FFmpeg指二进制文件，而非同名的python包，其中包含了ffmpeg、ffprobe、ffplay三大工具。

2.1 官网下载

访问网址：https://www.gyan.dev/ffmpeg/builds
全文搜索CTRL+F找到ffmpeg-release-full.7z这个安装包，点击下载
解压到本地目录中，打开bin文件夹，地址栏复制本地路径

2.2 环境变量配置

计算机右键【属性】-> 【高级系统设置】->【高级】-> 【环境变量】-> 【用户变量】
双击Path，新建一条，在变量值里粘贴复制的路径

2.3 安装成果检查

WIN+R 输入cmd，命令行中测试一下，输入ffmpeg回车，出现下图类似结果安装成功

3. 上手下载

3.1 基础格式

在想要保存的目录下打开命令行（地址栏输入cmd回车），按照如下格式书写命令：

yt-dlp [OPTIONS] [--] URL [URL...]

yt-dlp必须在前，OPTIONS和URL填写不分先后

基础用法示例：

# --proxy 使用指定的HTTP/HTTPS/SOCKS代理。 e.g. socks5://user:[email protected]:1080/
# 127.0.0.1表示本机ip，1080表示当前使用的端口，请根据本机情况查询并更改，见3.2
# URL填写想下载的视频地址

# 下载单个视频
yt-dlp --proxy socks5://127.0.0.1:1080 https://www.youtube.com/watch?v=NtKJSHW68p4

# 下载播放列表的所有视频 
yt-dlp --proxy socks5://127.0.0.1:1080 https://www.youtube.com/playlist?list=PLqWr7dyJNgLJ79otw7N9CXQ_AU0Fm04aq

3.2 脚本地址查询

点右下角网络图标进入【网络和Internet设置】，选择【代理】
找到【使用设置脚本】，开启
检查命令中的ip和端口和【脚本地址】是否一致

3.3 常用参数和用例展示

根据使用需求，追加命令参数，体验yt-dlp的丰富玩法，具体见项目自述，也可在命令行输入yt-dlp --help查看说明

3.3.1 陈列资源 -F, --list-formats

• 含义：列出所有文件的格式信息
• 用法：

yt-dlp [--proxy ...] URL -F

yt-dlp [--proxy ...] URL --list-formats	

对图中的标题做一下阅读理解：

ID	EXT	RESOLUTION	FPS	CH	FILESIZE	TBR	PROTO
编码	扩展名	分辨率（宽x高）	每秒画面帧数	音频通道数	文件字节数	音频和视频的平均比特率（KBit）	下载协议 （http, https, rtsp, rtmp, rtmpe, mms, f4m, ism, http_dash_segments, m3u8, or m3u8_native）

VCODEC	VBR	ACODEC	ABR	ASR	MORE INFO
视频编码方案	平均视频码率（KBit）	音频编码方案	平均音频码率（KBit）	音频采样率(hz)	补充说明

3.3.2 格式选择 -f , --format

• 含义：格式选择器，根据要求下载指定格式的音视频资源

• 说明：未传参时，默认下载最佳质量的格式。按特定要求下载时，写明视频和音频的格式要求。支持单独下载纯视频/音频，合并下载用"+“连接，各自分开下载用”,“，从左到右选择第一个可用资源下载用”/"

• 示例：

# 根据id，下载编号597的资源作为视频画面，599作为视频声音，把图像和音轨合并为MP4格式导出
yt-dlp -f 597+599 [--proxy ...] URL --merge-output-format mp4

# 下载编码为22的文件
yt-dlp -f webm [--proxy ...] URL

# 下载最佳质量的单个webm文件（目前支持3gp, aac, flv, m4a, mp3, mp4, ogg, wav, webm格式）
yt-dlp -f webm [--proxy ...] URL

# 分开下载视频和音频，格式化命名，按title.ID.EXT模板输出
yt-dlp -f "bv,ba/b" -o "%(title)s.f%(format_id)s.%(ext)s" [--proxy ...] URL

# 条件过滤，通过表格中的各项条件筛选目标规格的资源
-f w 	# 下载质量最差的资源文件（同时包含音视频），wv纯视频，wa纯音频，适合测试命令时使用
-f "best[height=720]" 	# 筛选最佳质量的720p视频
-f "[filesize>10M]" 	# 筛选>10M的文件
-f "all[vcodec=none]" 	# 筛选所有纯音频
-f "(mp4,webm)[height<480]"		# 筛选低于480p的最佳mp4视频和webm音轨，合并
-f 'bv[height=1080][ext=mp4]+ba[ext=m4a]' --merge-output-format mp4  # 筛选1080p的mp4视频，与最佳的m4a音频下载合并

3.3.3 字幕下载 --write-subs，–write-auto-subs

• 含义：下载字幕（投稿外挂的或自动翻译生成的）
• 用例：

yt-dlp [--proxy ...] URL --list-subs	# 列出所有支持的字幕信息（语言标识名、语言名、文件格式）

下图列出的字幕使用--write-subs下载

下图的字幕使用--write-auto-subs下载

# 下载视频时一同下载srt格式的中文字幕，--sub-lang后的值从图中的Langeuage列取得
yt-dlp --write-auto-subs --sub-format srt --sub-lang zh-Hans [--proxy ...] URL

# 单独下载最佳格式的英文字幕
yt-dlp --write-auto-subs --sub-format best --sub-lang en --skip-download [--proxy ...] URL

# 在视频中嵌入自动生成的阿拉伯语字幕，字幕嵌入操作仅适用于mp4，Webm和MKV视频
yt-dlp --write-auto-subs --sub-lang ar --embed-subs --merge-output-format mp4 [--proxy ...] URL

3.3.4 批量下载 -a FILE

下载文本中所有视频

yt-dlp -a urls.txt [--proxy ...] URL

3.3.5 片段提取 --download-sections

下载时间戳范围的片段

yt-dlp --download-sections "*1:30-inf" [--proxy ...] URL      # 前缀*，范围边界0:00 - inf

下载指定章节的片段

yt-dlp --download-sections "intro" [--proxy ...] URL

下载所有章节切片并按id.title.ext命名，同时下载一份完整的视频。
输出模板参数有section_number，section_title，section_start和section_end

yt-dlp --split-chapters -o "chapter:%(section_number)03d. %(section_title)s.%(ext)s" [--proxy ...] URL

3.3.6 格式化命名和存储 -o TEMPLATE

格式化命名文件并指定路径保存

-o "~/YouTube/%(title)s.%(ext)s"
-o "%(uploader)s/%(upload_date)s - %(title)s (%(id)s).%(ext)s"
-o "%(duration>%H-%M-%S)s" # 视频时长

输出模板的语法见output-template

3.3.7 更多

• –merge-output-format FORMAT：视频合并操作
• -j, --dump-json：打印JSON信息
• –embed-thumbnail：将视频缩略图嵌入视频封面，需要合并操作

  yt-dlp --embed-thumbnail --merge-output-format mp4 [--proxy ...] URL
  

• –embed-metadata：嵌入元数据，如视频简介描述，需要合并操作
• –audio-format FORMAT：纯音频下载，支持格式转换

  yt-dlp -x --audio-format mp3 [--proxy ...] URL -o '%(title)s_%(id)s.mp3'
  

• –skip-download：跳过视频下载，仅下载相关文件
• –cookies-from-browser BROWSER：对于要求登录或会员才可下载的网址，调取浏览器cookies
  目前支持的浏览器有brave, chrome, chromium, edge, firefox, opera, safari, vivaldi
  ​

3.4 其他平台使用

3.4.1 b站

下载高清视频需要调取浏览器cookie登录

# 下载单P视频
yt-dlp https://www.bilibili.com/video/BV1dM411t7Ls --cookies-from-browser chrome
# 分P视频仅下载P1
yt-dlp https://www.bilibili.com/video/BV1vs4y1b7rU?p=1 --cookies-from-browser chrome

4. 进阶技巧

4.1 Aria2下载加速

作为外部下载器加速下载，多线程并发，提升带宽利用率。 详情见Aria2 Manual
下面仅介绍arias作为命令行工具的下载配置以及基础用法

4.1.1 官网下载

访问官网releases页面，根据选择的版本和本机环境在Assets下找到安装包，点击下载
我这里选择windows x64的安装包

下载成功后解压，为了方便我直接放D盘并改名aria2

4.1.2 环境变量配置

打开文件夹，复制aria2c.exe的路径（我这里是D:\aria2），在环境变量path中配置（方法同2.2）

快捷操作：
win+R调出【运行】对话框 -> 输入sysdm.cpl，回车打开【系统属性】 -> 【高级】-> 【环境变量】 -> 【用户变量】
双击path新建，粘贴路径

4.1.3 命令行调用格式

aria2c [OPTIONS] [URI | MAGNET | TORRENT_FILE | METALINK_FILE]...

命令行输入aria2c -h查看具体参数说明
最简单的用法是aria2c URL，例如：

aria2c https://www.bilibili.com/

4.1.4 在yt-dlp中调用Aria2

# --downloader：指定下载器，aria2c以外还支持avconv,axel,curl,ffmpeg,httpie,wget
# --downloader-args：下载参数 -c：断点续传；-j：并发数；-x：线程数（最多16）；-k：分段（每段1M）

yt-dlp --downloader aria2c --downloader-args aria2c:"-c -j 3 -x 8 -k 1M" [--proxy ...] URL

4.2 Python程序调用

基础用例：

from yt_dlp import YoutubeDL

URLS = ['https://www.youtube.com/watch?v=BaW_jenozKc']
with YoutubeDL() as ydl:
    ydl.download(URLS)

更多用例参考见embedding-examples
了解可用参数和公共函数列表，见yt_dlp.YoutubeDL.py

5.报错解决

5.1 无法连接

WARNING: [youtube] Unable to download webpage:

解决：

1. 检查或代理是否正常连接
2. 检查命令的地址和脚本地址是否一致

6. 拓展阅读

ArchWiki：https://wiki.archlinux.org/title/Yt-dlp

---

1. 支持的视频列表见supportedsites ↩︎