youtube-dl CMD

概述

youtube-dl 命令参数简译

USAGE:

youtube-dl [OPTIONS] URL [URL...]

OPTIONS:

通用选项

-h, --help                       打印帮助文档
--version                        打印版本信息
-U, --update                     更新到最新版(需要权限)
-i, --ignore-errors              遇到下载错误时跳过
--abort-on-error                 遇到下载错误时终止
--dump-user-agent                显示当前使用的浏览器(User-agent)
--list-extractors                列出所有的提取器(支持的网站)
--extractor-descriptions         同上
--force-generic-extractor        强制使用通用提取器下载
--default-search PREFIX          使用此前缀补充不完整的URLs,例如:"ytsearch2 yt-dl" 从youtube搜索并下载两个关于yt-dl视频. 使用"auto"youtube-dl就会猜一个,一般效果等价于"ytsearch"("auto_warning"猜测时加入警告).我已知支持的PREFIX:ytsearch (youtube), ytsearchdate (youtube), yvsearch (yahoo videos), gvsearch (google videos)
--ignore-config                  不读取配置文件,当时用了全局配置文件/etc/youtube-dl.conf:不再读取 ~/.config/youtube-dl/config (%APPDATA%/youtube-dl/config.txt on Windows)
--config-location PATH           使用指定路径下的配置文件
--flat-playlist                  列出列表视频但不下载
--mark-watched                   标记看过此视频 (YouTube only)
--no-mark-watched                不标记看过此视频 (YouTube only)
--no-color                       打印到屏幕上的代码不带色

网络选项

--proxy URL                      使用HTTP/HTTPS/SOCKS协议的代理.如:socks5://127.0.0.1:1080/.
--socket-timeout SECONDS         放弃连接前等待时间
--source-address IP              绑定的客户端IP地址
-4, --force-ipv4                 所有连接通过IPv4
-6, --force-ipv6                 所有连接通过IPv6

地理限制

--geo-verification-proxy URL     使用此代理地址测试一些有地理限制的地址
--geo-bypass                     绕过地理限制通过伪装X-Forwarded-For HTTP头部的客户端ip (实验)
--no-geo-bypass                  不 绕过地理限制通过伪装X-Forwarded-For HTTP头部的客户端ip (实验)
--geo-bypass-country CODE        强制绕过地理限制通过提供准确的ISO 3166-2标准的国别代码(实验) 注:以上三个实验参数实测未成功

视频选择

--playlist-start NUMBER          指定列表中开始下载的视频(默认为1)
--playlist-end NUMBER            指定列表中结束的视频(默认为last)
--playlist-items ITEM_SPEC       指定列表中要下载的视频项目编号.如:"--playlist-items 1,2,5,8"或"--playlist-items 1-3,7,10-13"
--match-title REGEX              下载标题匹配的视频(正则表达式或区分大小写的字符串)
--reject-title REGEX             跳过下载标题匹配的视频(正则表达式或区分大小写的字符串)
--max-downloads NUMBER           下载NUMBER个视频后停止
--min-filesize SIZE              不下载小于SIZE的视频(e.g. 50k or 44.6m)
--max-filesize SIZE              不下载大于SIZE的视频(e.g. 50k or 44.6m)
--date DATE                      仅下载上传日期在指定日期的视频
--datebefore DATE                仅下载上传日期在指定日期或之前的视频 (i.e. inclusive)
--dateafter DATE                 仅下载上传日期在指定日期或之后的视频 (i.e. inclusive)
--min-views COUNT                不下载观影数小于指定值的视频
--max-views COUNT                不下载观影数大于指定值的视频
--match-filter FILTER            通用视频过滤器. Specify any key (see help for -o for a list of available keys) to match if the key is present, !key to check if the key is not present, key > NUMBER (like "comment_count > 12", also works with >=, <, <=, !=, =) to compare against a number,key = ‘LITERAL‘ (like "uploader = ‘Mike Smith‘", also works with !=) to match against a string literal and & to require multiple matches. Values which are not known are excluded unless you put a question mark (?) after the operator. For example, to only match videos that have been liked more than 100 times and disliked less than 50 times (or the dislike functionality is not available at the given service), but who also have a description, use --match-filter "like_count > 100 & dislike_count <? 50 & description" .
--no-playlist                    当视频链接到一个视频和一个播放列表时,仅下载视频
--yes-playlist                   当视频链接到一个视频和一个播放列表时,下载视频和播放列表
--age-limit YEARS                下载合适上传年限的视频
--download-archive FILE          仅下载档案文件中未列出的影片,已下载的记录ID
--include-ads                    同时下载广告(实验)

下载选项

-r, --limit-rate RATE            最大bps (e.g. 50K or 4.2M)
-R, --retries RETRIES            重试次数 (默认10), or "infinite".
--fragment-retries RETRIES       一个分段的最大重试次数(default is 10), or "infinite" (DASH, hlsnative and ISM)
--skip-unavailable-fragments     跳过不可用分段(DASH, hlsnative and ISM)
--abort-on-unavailable-fragment  放弃某个分段当不可获取时
--keep-fragments                 下载完成后,将下载的片段保存在磁盘上; 片段默认被删除
--buffer-size SIZE               设置缓冲区大小buffer (e.g. 1024 or 16K) (default is 1024)
--no-resize-buffer               不自动调整缓冲区大小.默认情况下自动调整
--playlist-reverse               以相反的顺序下载播放列表视频
--playlist-random                以随机的顺序下载播放列表视频
--xattr-set-filesize             Set file xattribute ytdl.filesize with expected file size (experimental)
--hls-prefer-native              使用本机默认HLS下载器而不是ffmpeg
--hls-prefer-ffmpeg              使用ffmpeg而不是本机HLS下载器
--hls-use-mpegts                 使用TS流容器来存放HLS视频,一些高级播放器允许在下载的同时播放视频
--external-downloader COMMAND    使用指定的第三方下载工具,当前支持:aria2c,avconv,axel,curl,ffmpeg,httpie,wget
--external-downloader-args ARGS  给第三方下载工具指定参数,如:--external-downloader aria2c --external-downloader-args -j8

文件系统选项

-a, --batch-file FILE            文件中包含需要下载的URL
--id                             仅使用文件名中的视频ID
-o, --output TEMPLATE            Output filename template, see the "OUTPUT TEMPLATE" for all the info
--autonumber-start NUMBER        指定%(autonumber)s的起始值(默认为1)
--restrict-filenames             将文件名限制为ASCII字符,并避免文件名中的“&”和空格
-w, --no-overwrites              不要覆盖文件
-c, --continue                   强制恢复部分下载的文件。 默认情况下,youtube-dl仅在可能时将恢复下载。
--no-continue                    不要恢复部分下载的文件(从头开始重新启动)
--no-part                        不使用.part文件 - 直接写入输出文件
--no-mtime                       不使用Last-modified header来设置文件最后修改时间
--write-description              将视频描述写入.description文件
--write-info-json                将视频元数据写入.info.json文件
--write-annotations              将视频注释写入.annotations.xml文件
--load-info-json FILE            包含视频信息的JSON文件(使用“--write-info-json”选项创建)
--cookies FILE                   文件从中读取Cookie(经测试,export cookies插件可以使用,但firebug导出的cookies导致错误,chrome下请用cookies.txt)注意:不同平台windows、Linux、OSX之间需要转换CE LF才能使用!
--cache-dir DIR                  文件存储位置。youtube-dl需要永久保存一些下载的信息。默认为$XDG_CACHE_HOME/youtube-dl或/.cache/youtube-dl。目前,只有YouTube播放器文件(对于具有模糊签名的视频)进行缓存,但可能会发生变化。
--no-cache-dir                   不用缓存
--rm-cache-dir                   删除所有缓存文件

缩略图

--write-thumbnail                把缩略图写入硬盘
--write-all-thumbnails           将所有缩略图写入磁盘
--list-thumbnails                列出所有可用的缩略图格式

详细/模拟选项

-q, --quiet                      激活退出模式
--no-warnings                    忽略警告
-s, --simulate                   不下载不存储任何文件到硬盘,模拟下载模式
--skip-download                  不下载视频
-g, --get-url                    模拟下载获取视频直连
-e, --get-title                  模拟下载获取标题
--get-id                         模拟下载获取id
--get-thumbnail                  模拟下载获取缩略图URL
--get-description                模拟下载获取视频描述
--get-duration                   模拟下载获取视频长度
--get-filename                   模拟下载获取输出视频文件名
--get-format                     模拟下载获取输出视频格式
-j, --dump-json                  模拟下载获取JSON information.
-J, --dump-single-json           模拟下载获取每条命令行参数的JSON information.如果是个播放列表,就获取整个播放列表的JSON
--print-json                     下载的同时获取视频信息的JSON
--newline                        进度条在新行输出
--no-progress                    不打印进度条
--console-title                  在控制台标题栏显示进度
-v, --verbose                    打印各种调试信息
--dump-pages                     打印下载下来的使用base64编码的页面来调试问题(非常冗长)
--write-pages                    将下载的中间页以文件的形式写入当前目录中以调试问题
--print-traffic                  显示发送和读取HTTP流量
-C, --call-home                  联系youtube-dl服务器进行调试
--no-call-home                   不联系youtube-dl服务器进行调试

解决方法

--encoding ENCODING              强制指定编码(实验)
--no-check-certificate           禁止HTTPS证书验证
--prefer-insecure                使用未加密的连接来检索有关视频的信息(目前仅支持YouTube)
--user-agent UA                  指定user agent
--referer URL                    指定自定义的referer,仅限视频来源于同一网站
--add-header FIELD:VALUE         指定一个自定义值的HTTP头文件,使用分号分割,可以多次使用此选项
--bidi-workaround                围绕缺少双向文本支持的终端工作。需要在PATH中有bidiv或fribidi可执行文件
--sleep-interval SECONDS         在每次下载之前休眠的秒数,或者每次下载之前的随机睡眠的范围的下限(最小可能的睡眠秒数)与-max-sleep-interval一起使用。
--max-sleep-interval SECONDS     每次下载前随机睡眠范围的上限(最大可能睡眠秒数)。只能与--min-sleep-interval一起使用。

视频格式选项

-f, --format FORMAT              视频格式代码,查看"FORMAT SELECTION"获取所有信息
--all-formats                    获取所有视频格式
--prefer-free-formats            开源的视频格式优先,除非有特定的请求
-F, --list-formats               列出请求视频的所有可用格式
--youtube-skip-dash-manifest     不要下载关于YouTube视频的DASH清单和相关数据
--merge-output-format FORMAT     如果需要合并(例如bestvideo + bestaudio),则输出到给定的容器格式。mkv,mp4,ogg,webm,flv之一。如果不需要合并,则忽略

字幕选项

--write-sub                      下载字幕文件
--write-auto-sub                 下载自动生成的字幕文件 (YouTube only)
--all-subs                       下载所有可用的字幕
--list-subs                      列出所有字幕
--sub-format FORMAT              字幕格式,接受格式偏好,如:"srt" or "ass/srt/best"
--sub-lang LANGS                 要下载的字幕的语言(可选)用逗号分隔,请使用--list-subs表示可用的语言标签

验证选项

-u, --username USERNAME          使用ID登录
-p, --password PASSWORD          账户密码,如果此选项未使用,youtube-dl将交互式地询问。
-2, --twofactor TWOFACTOR        双因素认证码
-n, --netrc                      使用.netrc认证数据
--video-password PASSWORD        视频密码(vimeo, smotri, youku)

Adobe Pass 选项

--ap-mso MSO                     Adobe Pass多系统运营商(电视提供商)标识符,使用--ap-list-mso列出可用的MSO
--ap-username USERNAME           MSO账号登录
--ap-password PASSWORD           账户密码,如果此选项未使用,youtube-dl将交互式地询问。
--ap-list-mso                    列出所有支持的MSO

后处理选项

-x, --extract-audio              将视频文件转换为纯音频文件(需要ffmpeg或avconv和ffprobe或avprobe)
--audio-format FORMAT            指定音频格式: "best", "aac", "flac", "mp3", "m4a", "opus", "vorbis", or "wav"; "best" by default;-x存在时无效
--audio-quality QUALITY          指定ffmpeg/avconv音频质量,为VBR插入一个0(best)-9(worse)的值(默认5),或者指定比特率
--recode-video FORMAT            必要时将视频转码为其他格式(当前支持: mp4|flv|ogg|webm|mkv|avi)
--postprocessor-args ARGS        给后处理器提供这些参数
-k, --keep-video                 视频文件在后处理后保存在磁盘上; 该视频默认被删除
--no-post-overwrites             不要覆盖后处理文件; 默认情况下,后处理文件将被覆盖
--embed-subs                     在视频中嵌入字幕(仅适用于mp4,webm和mkv视频)
--embed-thumbnail                将缩略图嵌入音频作为封面艺术
--add-metadata                   将元数据写入视频文件
--metadata-from-title FORMAT     从视频标题中解析附加元数据,如歌曲标题/艺术家。格式语法和--output相似.也可以使用带有命名捕获组的正则表达式。解析的参数替换现有值。Example: --metadata-from-title "%(artist)s - %(title)s" matches a title like "Coldplay - Paradise". Example (regex): --metadata-from-title "(?P<artist>.+?) - (?P<title>.+)"
--xattrs                         将元数据写入视频文件的xattrs(使用dublin core 和 xdg标准)
--fixup POLICY                   自动更正文件的已知故障。never(不做警告), warn(只发出警告), detect_or_warn (默认;如果可以的话修复文件,否则警告)
--prefer-avconv                  后处理时相较ffmpeg偏向于avconv
--prefer-ffmpeg                  后处理优先使用ffmpeg
--ffmpeg-location PATH           ffmpeg/avconv程序位置;PATH为二进制所在文件夹或者目录.
--exec CMD                       在下载后对文件执行命令,类似于find -exec语法.示例:--exec‘adb push {} /sdcard/Music/ && rm {}‘
--convert-subs FORMAT            转换字幕格式(当前支持: srt|ass|vtt)

本地配置

您可以通过将任何支持的命令行选项放置到配置文件来配置 youtube-dl。在 Linux 和 OS X 上,系统范围的配置文件位于 /etc/youtube-dl.conf,用户范围的配置文件位于 ~/.config/youtube-dl/config。在Windows上,用户范围的配置文件位置是 %APPDATA%\youtube-dl\config.txt 或 C:\Users&lt;user name>\youtube-dl.conf。请注意,默认情况下,配置文件可能不存在,所以您可能需要自己创建它。

例如,使用如下配置文件,youtube-dl 将始终只提取音频,不使用文件上次使用时间来设置文件最后修改时间,使用代理下载并保存所有输出到用户主目录下的 Movies 文件夹下

# Lines starting with # are comments
# Always extract audio
-x
# Do not copy the mtime
--no-mtime
# Use this proxy
--proxy 127.0.0.1:3128
# Save all videos under Movies directory in your home directory
-o ~/Movies/%(title)s.%(ext)s

请注意,配置文件中的选项与常规命令行中所调用的选项(又名 switches)相同,因此在 - 或者 -- 后面不得包含空格,例如 -o--proxy 不能写成 - o 或者 -- proxy

你可以使用 --ignore-config 来禁用配置文件,也可以使用 --config-location 启用自定义配置文件

输出模板

-o 选项允许用户指定输出文件名称的模板。

基本用法下载一个文件时,就像在没有设置任何模板参数 youtube-dl -o funny_video.flv "https://some/video"。 但是,它可能包含下载每个视频时将被替换的特殊序列。特殊序列可以根据python字符串格式化操作来格式化。例如,%(NAME)s或者%(NAME)05d。为了澄清,这是一个百分号,后面跟着一个名字,然后是格式化操作。允许的名称和序列类型如下:

id (字符串):                     视频标识符
title (字符串):                  视频标题
url (字符串):                    视频网址
ext (字符串):                    视频文件扩展名
alt_title (字符串):              视频的次要标题
display_id (字符串):             视频的替代标识符
uploader (字符串):               视频上传器的全名
license (字符串):                视频许可的许可证名称
creator (字符串):                视频的创建者
release_date (字符串):           视频发布时的日期(YYYYMMDD)
timestamp (数字):                视频可用时的UNIX时间戳
upload_date (字符串):            视频上传日期(YYYYMMDD)
uploader_id (字符串):            视频上传器的昵称或ID
location (字符串):               视频被拍摄的物理位置
duration (数字):                 以秒为单位的视频长度
view_count (数字):               有多少用户在该平台上观看过视频
like_count (数字):               视频的正面评级的数量
dislike_count (数字):            视频的负面评级的数量
repost_count (数字):             视频的转贴次数
average_rating (数字):           用户给出的平均评分,使用的比例取决于网页
comment_count (数字):            视频上的评论数量
age_limit (数字):                视频年龄限制(年)
is_live (布尔值):                这个视频是一个实时流还是一个固定长度的视频
start_time (数字):               按照URL中的指定开始复制的时间(以秒为单位)
end_time (数字):                 按照URL中的指定,结束复制的时间(以秒为单位)
format (字符串):                 格式的可读描述
format_id (字符串):              指定的格式代码 --format
format_note (字符串):            关于格式的附加信息
width (数字):                    视频的宽度
height (数字):                   视频的高度
resolution (字符串):             宽度和高度的文本描述
tbr (数字):                      音频和视频的平均比特率,以KBit / s为单位
abr (数字):                      以KBit / s为单位的平均音频比特率
acodec (字符串):                 正在使用的音频编解码器的名称
asr (数字):                      以赫兹为单位的音频采样率
vbr (数字):                      以KBit / s为单位的平均视频比特率
fps (数字):                      帧率
vcodec (字符串):                 正在使用的视频编解码器的名称
container (字符串):              容器格式的名称
filesize (数字):                 如果预先知道的话,字节数
filesize_approx(数字):           字节数的估计值
protocol (字符串):               将用于实际下载的协议
extractor (字符串):              提取器的名称
extractor_key (字符串):          提取器的键名
epoch (数字):                    创建文件时的Unix纪元
autonumber (数字):               从零开始,每次下载将增加的五位数字
playlist (字符串):               包含视频的播放列表的名称或ID
playlist_index (数字):           根据播放列表的总长度填充前导零的播放列表中的视频索引
playlist_id (字符串):            播放列表标识符
playlist_title (字符串):         播放列表标题
playlist_uploader (字符串):      播放列表上传者的全名
playlist_uploader_id (字符串):   播放列表上传者的昵称或ID

可用于属于某个逻辑章节或部分的视频:

chapter (字符串):                视频所属章节的名称或标题
chapter_number (数字):           视频所属章节的编号
chapter_id (字符串):             视频所属章节的ID

可用于某个系列或节目的情节的视频:

series (字符串):                 该视频片段所属的系列或节目的标题
season (字符串):                 视频剧集所属季节的标题
season_number (数字):            视频片段属于的季节的数量
season_id (字符串):              视频片段属于的季节的ID
episode (字符串):                视频片段的标题
episode_number (数字):           一个季节内的视频片段的数量
episode_id (字符串):             视频情节的ID

适用于音乐专辑的音轨或音乐专辑的媒体:

track (字符串):                  曲目的标题
track_number (数字):             专辑或光盘中的曲目编号
track_id (字符串):               轨道的Id
artist (字符串):                 曲目的艺术家
genre (字符串):                  曲目的类型
album (字符串):                  曲目所属专辑的标题
album_type (字符串):             相册的类型
album_artist (字符串):           专辑中出现的所有艺术家列表
disc_number (数字):              轨道所属的光盘或其他物理介质的编号
release_year (数字):             发行专辑时的年(YYYY)

在输出模板中引用的每个上述序列都将被与序列名称对应的实际值替换。请注意,某些序列不能保证存在,因为它们依赖于特定提取器获得的元数据。这样的序列将被替换为NA。

例如,对于-o %(title)s-%(id)s.%(ext)s带有标题youtube-dl test video和ID 的mp4视频BaW_jenozKcj,这将导致在youtube-dl test video-BaW_jenozKcj.mp4当前目录中创建一个文件。 对于数字序列,您可以使用与数字相关的格式,例如,%(view_count)05d将导致视图计数的字符串填充最多5个字符的零,如in 00042。

输出模板还可以包含任意的分层路径,例如-o '%(playlist)s/%(playlist_index)s - %(title)s.%(ext)s',这将导致下载与该路径模板相对应的目录中的每个视频。任何丢失的目录将自动为您创建。 要在输出模板使用使用%的文字%%。输出到标准输出使用-o -。 当前的默认模板是%(title)s-%(id)s.%(ext)s。

在某些情况下,您不需要特殊字符(如中,空格或&),例如通过8位不安全通道将下载的文件名传送到Windows系统或文件名时。在这些情况下,添加--restrict-filenames标志以获得较短的标题: 输出模板和Windows批处理文件

如果您在Windows批处理文件中使用输出模板,那么您必须%通过加倍来避免普通的百分号字符(),所以-o "%(title)s-%(id)s.%(ext)s"应该成为-o "%%(title)s-%%(id)s.%%(ext)s"。但是你不应该碰到%不是普通字符的东西,例如扩展的环境变量应该保持不变-o "C:%HOMEPATH%\Desktop%%(title)s.%%(ext)s"。

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏架构之路

追源索骥:透过源码看懂Flink核心框架的执行流程

写在最前:因为这篇博客太长,所以我把它转成了带书签的pdf格式,看起来更方便一点。想要的童鞋可以到我的公众号“老白讲互联网”后台留言flink即可获取。

3.3K50
来自专栏西枫里博客

thinkPHP升级到5.0.13导致update更新出错的问题

话题还得从tinkPHP群消息说起,双十二那天,群内通知官方发布了5.0.13版本。刚好那几天在折腾redis缓存。官方文档中说5.0.13是一个集合诸多改进的...

12850
来自专栏Golang语言社区

Go语言实战: 编写可维护Go语言代码建议

大家好, 我在接下来的两个会议中的目标是向大家提供有关编写Go代码最佳实践的建议。

23630
来自专栏老秦求学

汇编语言学习01

汇编语言(8086cpu) 恩,学习一门课程,我觉得应该有一定的条理性,而且自己要勤加思考才能学好,条理性:最好就是先整体的介绍一下全本书,然后再详细的介绍各个...

30790
来自专栏图像识别与深度学习

蓝牙项目开发流程

775100
来自专栏java一日一条

编写可靠 Shell 脚本的 8 个建议

这八个建议,来源于键者几年来编写 shell 脚本的一些经验和教训。事实上开始写的时候还不止这几条,后来思索再三,去掉几条无关痛痒的,最后剩下八条。毫不夸张地说...

12120
来自专栏腾讯大讲堂的专栏

设计模式笔记

| 导语 “计算机科学领域的任何问题都可以通过增加一个间接的中间层来解决” “Any problem in computer science can be so...

51380
来自专栏阮一峰的网络日志

都柏林核心(Dublin Core)

在上一篇日志中,我介绍了元数据(MetaData),并且说只要有一个集合,就可以定义一套元数据。 这样一来,很自然的,我们就会想到一个问题:有没有可能定义一套通...

28470
来自专栏牛客网

2018秋招面经-后端开发

18850
来自专栏FreeBuf

基于时延的盲道研究:受限环境下的内容回传信道

在一次漏洞赏金活动中,挖到个命令注入的洞,我先以时延作为证明向厂商提交该漏洞,厂商以国内网络环境差为由(的确得翻墙)拒收,几次沟通,告知若我能取回指定文件 se...

14450

扫码关注云+社区

领取腾讯云代金券