Skip to main content

youtube-dl

# sudo curl -L https://yt-dl.org/downloads/latest/youtube-dl --create-file-mode 0755 -o /usr/local/bin/youtube-dl
sudo chmod a+rx /usr/local/bin/youtube-dl

# 测试文件名
# --restrict-filenames 将空格转换为下划线
youtube-dl --get-filename -o '%(title)s.%(ext)s' d0yGdNEWdn0
# 默认格式
youtube-dl --get-filename -o '%(title)s-%(id)s.%(ext)s' d0yGdNEWdn0

# 生成列表增量下载
youtube-dl --download-archive archive.txt "https://www.youtube.com/playlist?list=PLwiyx1dc3P2JR9N8gQaQN_BCvlSlap7re"

# 当前目录 youtube-dl.conf
# 或直接指向文件
youtube-dl --config-location $PWD

# 可以同时利用全局配置
youtube-dl $(cat youtube-dl.conf)

# 查看所有格式
# -f best 不一定会选择最佳 audio - 最佳 video+最佳 audio 不一定存在
# 可以单独下载最佳 audio
youtube-dl -F J9bjJEjK2dQ
# -f best 也可以会选择差的
youtube-dl -F anbrb2u9GYI

# 最好的 mp4 或其他任意格式
youtube-dl -f 'bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]/best'
# 最好 video 但小于 480p
youtube-dl -f 'bestvideo[height<=480]+bestaudio/best[height<=480]'
# 最好 video 但小于 50M
youtube-dl -f 'best[filesize<50M]'
# HTTP/HTTPS 直接链接下载
youtube-dl -f '(bestvideo+bestaudio/best)[protocol^=http]'
# 最好的音频和视频但不合并
youtube-dl -f 'bestvideo,bestaudio' -o '%(title)s.f%(format_id)s.%(ext)s'

# -f bestvideo[vcodec=vp9]+bestaudio[acodec=opus]/best
# -xf bestaudio[acodec=opus]
# -f bestvideo[vcodec=av1]+bestaudio[acodec=opus]/best

# -f 'bestvideo[vcodec=av1]+bestaudio[acodec=opus]/bestvideo[vcodec=vp9]+bestaudio[acodec=opus]/bestvideo[ext=mp4]+bestaudio[ext=m4a]/best'

# archiving videos
# bestvideo[ext=webm]+251/bestvideo[ext=mp4]+(258/256/140)/bestvideo[ext=webm]+(250/249)/best
# archiving audio
# 258/251/22/256/140/250/18/249/139
# streaming videos
# bestvideo+bestaudio/best
OptionDesc
-o ~/Movies/%(title)s.%(ext)s按照模板输出到指定位置
--proxy 127.0.0.1:3128代理，支持 socks
-f, --format best选择最好的格式,默认
--no-playlist复制了播放列表中的视频，但只下载单个视频
--all-subs下载所有字幕
-R 50失败重试
--ignore-errors忽略列表中的错误视频
--download-archive archive.txt记录已经下载的视频，下次不再下载，每行记录 <extractor> <id>
-a, --batch-file urls.txt批量下载地址,支持 #,; 注释
--id批量文件里只有 ID
-w, --no-overwrites不覆盖
--write-thumbnail写入缩略图
后处理
-x, --extract-audio提取音频
--embed-subs
--embed-thumbnail
--add-metadata写入元信息到媒体文件
--xattrs写入元信息到文件 xattrs
--convert-subs FORMAT

youtube-dl.conf

--all-subs
--geo-bypass
--ignore-errors
--proxy socks5://127.0.0.1:8888
--write-thumbnail
-f best
-R 50
  • -f best 不一定会下载最优格式

推荐

-f 'bestvideo[vcodec=av1]+bestaudio[acodec=opus]/bestvideo[vcodec=vp9]+bestaudio[acodec=opus]/bestvideo[ext=mp4]+bestaudio[ext=m4a]/best'

下载翻译字幕​

  • --convert-subs srt
  • --all-subs 下载所有字幕
  • --embed-subs
  • --write-auto-sub - 下载生成字幕
# 中文字幕
youtube-dl --write-auto-sub --write-sub --skip-download --sub-lang=en,zh-Hans
# 查看所有字幕
youtube-dl --list-subs

FAQ

unable to download video data: HTTP Error 403: Forbidden​

尝试 --rm-cache-dir