安装:
yt-dlp项目地址:https://github.com/yt-dlp/yt-dlp
ffmpeg:下载地址:https://www.gyan.dev/ffmpeg/builds/ (下载
ffmpeg-git-full.7z→解压→把bin文件里的三个文件拷贝到yt-dlp同一目录)
下载好后再windows→系统→高级系统设置→环境变量→path→添加文件目录
使用方法:
yt-blp 视频链接地址
获取cookies视频下载:在谷歌浏览器添加扩展Get cookies.txt LOCALLY
在要下载视频的网站点击扩展获取cookies,下载好的文件重命名为cookie.tex
终端输入命令:yt-dlp.exe –cookies cookie.txt ‘视频链接’
yt-dlp Windows 系统使用教程
下载与安装 yt-dlp
要在 Windows 上使用 yt-dlp,需要先准备好必要环境并获取 yt-dlp 可执行程序。yt-dlp 官方推荐下载 Windows 64 位独立版 可执行文件,即 yt-dlp.exe
github.com。你可以在 yt-dlp 的 GitHub Releases 页面 下载最新的 yt-dlp.exe
文件。下载后将其放在任意文件夹,并将该文件夹添加到系统 PATH(或直接在该文件夹中打开命令行使用)。
除了下载 exe 文件外,也可以通过包管理器或 Python pip 安装:
- 使用 Python 环境:
python -m pip install -U yt-dlp
github.com(需先安装 Python)。 - 使用 Windows 包管理器:Scoop:
scoop install yt-dlp
github.com;Chocolatey:choco install yt-dlp
github.com;winget:winget install yt-dlp
github.com。
这些方式会自动将 yt-dlp 安装到系统路径,并可通过相应包管理命令(例如scoop update yt-dlp
)进行更新。
安装 FFmpeg: 为了合并音视频流、转换格式等功能,建议在系统中安装 FFmpeg。realityframeworks.com指出“如果要使用 yt-dlp,最好安装 FFmpeg”。你可以从 FFmpeg Windows Builds 页面下载最新的压缩包,解压后将其中的 bin
文件夹(内含 ffmpeg.exe
、ffprobe.exe
等)路径添加到系统环境变量 PATHrealityframeworks.comrealityframeworks.com。配置完成后,在命令行执行 ffmpeg -version
应能看到版本信息,这说明 FFmpeg 已可被 yt-dlp 调用realityframeworks.com。注意:建议将 yt-dlp.exe 和 ffmpeg 解压文件放在不含中文字符的路径中,以避免可能的编码问题blog.csdn.net。
基本命令示例
- 下载单个视频: 在命令行输入
yt-dlp <视频URL>
,例如 bash复制编辑yt-dlp https://www.youtube.com/watch?v=abcdef12345
默认会下载视频的最佳画质和最佳音频并合并。 - 查看可用格式: 使用
-F
列出视频的所有可用格式,例如: bash复制编辑yt-dlp -F https://www.youtube.com/watch?v=abcdef12345
这会显示可下载的视频、音频流代码(format code)。 - 指定下载格式: 使用
-f
后跟格式代码组合。例如下载 720p 视频和音频: bash复制编辑yt-dlp -f "bv*[height<=720]+ba" https://www.youtube.com/watch?v=abcdef12345
或者下载最高分辨率 mp4:yt-dlp -f bestvideo+bestaudio --merge-output-format mp4 <URL>
github.comgithub.com。 - 下载音频: 加上
-x
(extract audio)并指定输出格式,如 MP3: bash复制编辑yt-dlp -x --audio-format mp3 https://www.youtube.com/watch?v=abcdef12345
这会提取视频中的音频并使用 FFmpeg 转码为 MP3github.com。 - 下载播放列表: 默认情况下,如果给出的是播放列表链接,yt-dlp 会下载列表中的所有视频,也可显式加上
--yes-playlist
。例如 bash复制编辑yt-dlp --yes-playlist https://www.youtube.com/playlist?list=PLxxxxx
如果只想下载单个视频,可加--no-playlist
。 - 指定输出文件名: 使用
-o
参数。例如-o "%(playlist_index)s - %(title)s.%(ext)s"
会按照播放列表序号命名输出文件。
高级参数说明
- 指定视频分辨率: 可以使用格式筛选选项控制下载质量。例如下载 720p 视频: bash复制编辑
yt-dlp -f "bv*[height<=720]+bestaudio/best" <视频URL>
其中bv*
表示最佳视频流,height<=720
限制最高 720p。如无匹配的 720p,则下载最接近的分辨率。更多格式筛选可参考 yt-dlp 文档的 FORMAT SELECTION 部分。 - 下载字幕: 使用
--write-subs
写入字幕文件,--write-auto-subs
写入自动生成的字幕(如 YouTube 自动翻译)。可使用--sub-langs
指定语言,例如下载简体中文字幕: bash复制编辑yt-dlp --write-subs --sub-langs zh-Hans https://www.youtube.com/watch?v=abcdef12345
上例中zh-Hans
表示简体中文cnblogs.com。要列出所有可用字幕语言,可先执行yt-dlp --list-subs <视频URL>
。 - 下载音频并转换为 MP3: 如前所示,使用
-x
提取音频后加上--audio-format mp3
即可github.com。FFmpeg 会在后台完成转换。可以用--audio-quality
指定音质(0-10)或固定比特率。 - 使用代理: 如果网络需要使用代理,可通过
--proxy
指定代理服务器地址github.com。例如: bash复制编辑yt-dlp --proxy socks5://127.0.0.1:1080 <视频URL>
支持 HTTP、HTTPS 和 SOCKS 代理协议github.com。 - 下载特定语言字幕或音轨: 除了使用
--sub-langs
指定字幕语言外,如果视频包含多种音频轨,可以通过格式筛选下载特定音频。例如使用-f
只选择某一语言的音频流(这需要先用-F
查看格式列表)。目前 yt-dlp 本身没有直接的“音轨语言”过滤选项,只能通过格式代码来实现。 - 自动合并视频和音频: 如果视频和音频是分开下载的(常见于较高分辨率的视频),yt-dlp 会自动使用 FFmpeg 将它们合并为一个文件realityframeworks.com。你也可以用
--merge-output-format mp4
(或其他容器格式)显式指定合并后的输出格式github.comgithub.com。
GUI 可视化工具(可选)
除了命令行方式,社区还开发了多个 yt-dlp 的图形界面工具。例如,Kannagi 发布了 yt-dlp-gui(Windows 平台),它提供可视化界面来输入链接和选项github.com;另外还有 dsymbol 的跨平台 GUI 前端(基于 PySide6),图示如下github.comgithub.com。这些 GUI 可让不熟悉命令行的用户通过下拉菜单和按钮选择视频质量、字幕等选项,然后点击下载,无需输入复杂命令。下图为 dsymbol 提供的一个 yt-dlp GUI 示例界面:可以在左侧输入视频链接、选择格式和选项,在右侧查看待下载列表及进度github.com。
常见报错及解决方案
- SSL 证书验证失败: 如果出现 HTTPS 证书相关错误(如 “certificate verify failed”),可以在命令中添加
--no-check-certificates
跳过证书验证github.com。例如: bash复制编辑yt-dlp --no-check-certificates <视频URL>
注意:跳过验证存在安全风险,仅当确实需要时使用。更好的做法是更新操作系统/Python 的根证书列表。 - 找不到
ffmpeg
: 错误提示中如果出现 “ffmpeg not installed” 或 “merging of formats requested but ffmpeg is not installed”,说明 yt-dlp 未检测到 FFmpeg。请确认已正确安装 FFmpeg 并将其bin
目录添加到 PATHrealityframeworks.com。安装后重启命令行,再次执行ffmpeg -version
应能看到信息。 - 路径中包含中文导致错误: 一些用户反馈将
yt-dlp.exe
或 FFmpeg 放在含中文字符的路径中可能出错blog.csdn.net。建议将其所在文件夹路径改为纯英文或数字,确保路径中不包含中文。 - 其他网络错误: 如下载遭限速、地域限制等,可尝试加大重试次数(
-R
)、使用代理(--proxy
)或在 YouTube 上将需要下载的视频加入油管会员以避免被封锁。
常用命令参考表
参数 / 命令 | 作用 |
---|---|
yt-dlp -h | 显示帮助信息 |
yt-dlp -U | 更新到最新版本github.com |
yt-dlp -F | 列出视频的所有可用格式 |
yt-dlp -f <格式> | 指定下载格式(选择视频/音频流),例如 -f "bv+ba" github.com |
yt-dlp -x | 提取音频(需要 FFmpeg),下载音频文件github.com |
yt-dlp --audio-format <格式> | 与 -x 配合,将音频转换为指定格式(如 mp3 )github.com |
yt-dlp --write-subs | 下载字幕文件 |
yt-dlp --sub-langs <语言> | 下载指定语言字幕(如 zh-Hans )github.com |
yt-dlp --proxy <URL> | 使用指定 HTTP/HTTPS/SOCKS 代理github.com |
yt-dlp --merge-output-format <格式> | 合并下载的音视频并输出为指定容器格式(需 FFmpeg)github.com |
yt-dlp -c | 续传已存在的部分文件(继续之前未完成的下载)github.com |
yt-dlp --no-check-certificates | 不验证 HTTPS 证书(跳过 SSL 错误)github.com |
以上命令和参数可以组合使用以满足各种需求。更多详细用法可参考 yt-dlp 官方文档 或 yt-dlp --help
输出的说明。