yt-dlp 下载视频使用指南

yt-dlp -U # 升级版本
yt-dlp -F url 或 vid # 列出音频和视频，可用查看详细信息及编号

yt-dlp url # 默认直接下载最高画质视频
yt-dlp --yes-playlist # 下载播放列表

yt-dlp -f 22 url 或 vid # 下载编号 22 的视频（可用看到是 720p 还包含了音轨）
yt-dlp -f 137+140 url --merge-output-format mp4 # 将音视频合并下载为 MP4 文件（需要 ffmpeg）
yt-dlp -f "bestvideo[height<=1080]+bestaudio" url # 指定下载格式（即 1080p+高品质音频）

yt-dlp -f 22 url --proxy socks5://127.0.0.1:10808 # 使用代理

# 通过指定代理下载音视频及字幕
yt-dlp -F url # 先列出所有音视频，以确定要下载哪个
yt-dlp -f 136+140 url --write-auto-subs --sub-langs zh-Hans --proxy socks5://192.168.10.1:18111 # 指定视频音频字幕（自动翻译）

# 下载播放列表，最佳视频+最佳音频，并输出为 mp4
ytdl -f "bestvideo+bestaudio" --merge-output-format mp4 "https://youtube.com/playlist?list=XXX"

# 同时下载写入英文字幕+略缩图+影片介绍（适合转存）
yt-dlp --write-subs --write-auto-subs --sub-format SRT --sub-langs en --write-thumbnail --write-description url

yt-dlp -x --audio-format mp3 url # 仅下载音频为 mp3 格式
yt-dlp -f 140 url # 下载编号为 140 的音频

yt-dlp --list-subs url # 列出字幕，查看所需语言字幕是否存在
yt-dlp --write-subs --sub-langs zh-Hans,en --skip-download --convert-subs srt url # 下载中文和英文字幕
yt-dlp --write-auto-subs --sub-langs zh-Hans --skip-download url # 下载自动翻译字幕到中文

yt-dlp -f 137+140 url --write-subs --sub-langs zh-Hans # 下载视频+音频+字幕
yt-dlp -f 137+140 url --embed-subs --sub-langs zh-Hans --merge-output-format mp4 # 下载视频+音频+字幕

ffmpeg -i 1.mp4 -vf 'subtitles=1.srt' -c:a copy output.mp4 # 如果要写入硬字幕

# Firefox
yt-dlp --cookies-from-browser firefox:/Users/appinn/Library/Application\ Support/Firefox/Profiles/12345.default-release-12345/ https://www.bilibili.com/video/xxx
# Edge，
yt-dlp.exe --cookies-from-browser edge:"C:\Users\appinn\AppData\Local\Microsoft\Edge\User Data\Profile 1" -F https://www.bilibili.com/video/xxxx
# Chrome
yt-dlp.exe --cookies-from-browser chrome:"C:\Users\scavi\AppData\Local\Google\Chrome\User Data\Default" -F https://www.bilibili.com/video/xxxx

# 可以随时编辑配置文件调整，将不要的选项前加上 # 号注释掉
# 格式：yt-dlp -f [编号] [代理配置] [视频链接] [合并语句] [外部下载器选择] [下载器参数]
yt-dlp -f 137+140 --proxy socks5://127.0.0.1:8080 url --merge-output-format mp4 --external-downloader aria2c --downloader-args aria2c:"-x 16 -k 1M" url

# 说明
-f 137+140 # 指定下载的编号为 137 和 140（视频+音频） 
--output T:/%(title)s-%(resolution)s.%(ext)s # 指定输出路径
--proxy socks5://192.168.1.1:0000 # socks5 代理配置
--merge-output-format mp4 # 合并后输出格式
-x --audio-format mp3 # 如果只要音频
--external-downloader aria2c # 下载器选择
--downloader-args [下载器名]:"[下载器配置]" # 如上 -x 16 为16线程 -k 1M 代表块大小为1M（youtube 不支持分块，此句可忽略）

# 字幕处理
--write-subs # 下载字幕文件，如 .srt 
--embed-subs # 或将字幕嵌入视频
--sub-langs zh-Hans,en # 指定字幕语言
--convert-subs srt # 转换成 srt
--skip-download # 只下载字幕

# 是否保存元数据
--embed-thumbnail # 缩略图
--embed-metadata # 元数据

# Cookies 引入
--cookies-from-browser chrome:"T:\PortableApps\ungoogled-chromium\userdata\Default"
--cookies T:/www.youtube.com_cookies.txt

# 指定 ffmpeg 路径
--ffmpeg-location D:/Qsync/Apps/MPV/ffmpeg.exe

yt-dlp --config-location /path/to/config/file.conf [URL] # 直接指定配置文件
yt-dlp --ignore-config --config-location /path/to/config/file.conf [URL] # 忽略默认配置文件并指定配置文件

# D:/MPV/default.conf (默认)
# D:/MPV/hd.conf (高清视频)
-f "bestvideo[height<=1080]+bestaudio/best[height<=1080]"
-o "%(title)s.%(ext)s"
--merge-output-format mp4

# D:/MPV/audio.conf (仅音频)
-x
--audio-format mp3
--audio-quality 0
-o "%(title)s.%(ext)s"