yt-dlp简单使用指南

1 安装 yt-dlp

这里使用pip安装yt-dlp
win+r打开终端输入

pip install yt-dlp

1.2 更新yt-dlp

更新与安装的命令相同

pip install yt-dlp

1.3 安装依赖

1.3.1 下载 FFmpeg

前往gyan.dev或者github镜像下载ffmpeg二进制文件ffmpeg-release-full.7z
解压到 C:\ffmpeg（或者其他位置）

1.3.2 添加环境变量

1. 按 Win + R，输入 sysdm.cpl，回车。
2. 进入“高级”选项卡，点击“环境变量”。
3. 在“系统变量”下找到 Path，点击“编辑”。
4. 点击“新建”，添加 C:\ffmpeg\bin。
5. 保存并关闭所有窗口。

1.3.3 验证 FFmpeg是否成功添加

打开命令提示符cmd，输入：

ffmpeg -version

按 回车，可以看到 FFmpeg 的版本，则安装成功

2 常用命令

下载视频

列出视频所有可用格式

yt-dlp -F 视频链接

示例：

yt-dlp -F https://www.youtube.com/watch?v=dQw4w9WgXcQ

下载指定格式视频

yt-dlp -f id 视频链接

示例：

yt-dlp -f 140+137 https://www.youtube.com/watch?v=dQw4w9WgXcQ

3 报错

3.1 403 错误

现象：youtube下载时出现 403 错误
解决方案: 使用yt-dlp sleep options
使用方法:

yt-dlp -f 140+137 --sleep-requests 5 --sleep-interval 10 --max-sleep-interval 30 https://www.youtube.com/watch?v=dQw4w9WgXcQ

--sleep-requests 5：每次请求间隔 5 秒。
--sleep-interval 10 --max-sleep-interval 30：下载之间，随机休眠 10~30 秒，模拟正常用户行为。

3.2需要登录问题

现象：youtube下载时需要登录
ERROR: [youtube] xxxxxxxx: Sign in to confirm you’re not a bot. This helps protect our community. Learn more
简单的解决方案：更换干净的ip
其它解决方案

3.3其它常见问题

其它常见问题及解决方案详见官方github


-------------------------------------------------------------------------------------------------------------------
yt-dlp 项目地址 https://github.com/yt-dlp/yt-dlp