选项：
常规选项：
-h，--help打印此帮助文本并退出
--version打印程序版本并退出
-U，--update将此程序更新为最新版本。使
确保您具有足够的权限
（如果需要，使用sudo运行）
-i，-ignore-errors继续出现下载错误，例如
跳过播放列表中不可用的视频
--abort-on-error终止其他视频的下载（在
播放列表或命令行）（如果有错误）
发生
--dump-user-agent显示当前浏览器标识
--list-extractors列出所有支持的提取器
--extractor-descriptions输出所有受支持的描述
提取器
--force-generic-extractor强制提取以使用通用
提取器
--default-search PREFIX使用此前缀表示不合格的URL。对于
示例“ gvsearch2：”下载两个视频
从Google的youtube-dl视频中“大
苹果”。使用值“自动”
youtube-dlguess（“ auto_warning”发出一个
猜测时警告）。 “错误”就抛出
一个错误。默认值“ fixup_error”
修复损坏的URL，但如果出现错误，则发出错误
除了搜索，这是不可能的。
--ignore-config不读取配置文件。当给
在全局配置文件/ etc中
/youtube-dl.conf：不读取用户
在〜/ .config / youtube-中进行配置
dl / config（％APPDATA％/ youtube-dl / config.txt
在Windows上）
--config-location PATH配置文件的位置；要么
配置或其包含的路径
目录。
--flat-playlist不要提取播放列表的视频，
只列出他们。
--mark-marked观看过Mark视频（仅限YouTube）
--no-mark-watched不标记观看的视频（仅限YouTube）
--no-color在输出中不发出颜色代码
网络选项：
--proxy URL使用指定的HTTP / HTTPS / SOCKS代理。
要启用SOCKS代理，请指定适当的
方案。例如
袜子5：//127.0.0.1：1080 /。传空
字符串（--proxy“”）直接连接
--socket-timeout SECONDS放弃之前要等待的时间，以秒为单位
--source-address IP绑定到的客户端IP地址
-4，-force-ipv4通过IPv4建立所有连接
-6，--force-ipv6通过IPv6建立所有连接
地理限制：
--geo-verification-proxy URL使用此代理来验证IP地址
一些受地理位置限制的网站。默认值
--proxy指定的代理（如果没有，则不指定
选项不存在）用于
实际下载。
--geo-bypass通过伪造X绕过地理限制
-Forwarded-用于HTTP标头
--no-geo-bypass不绕过地理限制
伪造X-Forwarded-For HTTP标头
--geo-bypass-country CODE使用以下命令强制绕过地理限制
明确提供两个字母的ISO 3166-2
国家代码
--geo-bypass-ip-block IP_BLOCK强制绕过地理限制
在CIDR中明确提供的IP块
符号
视频选择：
--playlist-start NUMBER个播放列表视频开始（默认为1）
--playlist-end NUMBER个播放列表视频结尾（默认为最后一个）
--playlist-items ITEM_SPEC要下载的播放列表视频项。指定
播放列表中视频的索引
以逗号分隔，例如：“-播放列表项
1,2,5,8“，如果您要下载视频
在播放列表中索引为1、2、5、8。您可以
指定范围：“-播放列表项
1-3,7,10-13“，它将下载视频
在索引1、2、3、7、10、11、12和13。
--match-title REGEX仅下载匹配的标题（regex或
不区分大小写的子字符串）
--reject-title REGEX跳过下载匹配标题（regex或
不区分大小写的子字符串）
--max-downloads下载NUMBER个文件后中止NUMBER个
--min-filesize SIZE不要下载任何小于
大小（例如50k或44.6m）
--max-filesize SIZE不要下载任何大于SIZE的视频
（例如50k或44.6m）
--date DATE仅下载该日期上传的视频
--datebefore DATE仅下载在或之前上传的视频
此日期（包括该日期）
--dateafter DATE仅下载在以下日期或之后上传的视频
此日期（包括该日期）
--min-views COUNT不要下载少于的视频
观看次数：COUNT
--max-views COUNT个下载的视频不超过
观看次数：COUNT
--match-filter FILTER通用视频过滤器。指定任意键（请参阅
“输出模板”以获取
如果钥匙是
当前，！key检查密钥是否不是
当前，键> NUMBER（例如“ comment_count”
> 12“，也可用于> =，<，<=，！=，=）
与数字比较，键=“文字”
（例如“ uploader ='Mike Smith'”，
与！=）匹配字符串文字
和＆要求多次匹配。价值观
除非您不知道，否则不包括在内
在运算符后面放一个问号（？）。
例如，仅匹配具有以下内容的视频
被超过100次喜欢和不喜欢
少于50次（或不喜欢
给定的功能不可用
服务），但也有说明，
使用--match-filter“ like_count> 100＆
dislike_count <？ 50＆description”。
--no-playlist（如果URL引用），仅下载视频
视频和播放列表。
--yes-playlist如果URL指向下载下载列表
视频和播放列表。
--age-limit年仅下载适合给定视频
年龄
--download-archive FILE仅下载未列出的视频
存档文件。记录所有的ID
下载了其中的视频。
--include-ads也下载广告
（实验性）
下载选项：
-r，--limit-rate RATE最大下载速率，以每秒字节数为单位
（例如50K或4.2M）
-R，--retries RETRIES重试次数（默认为10），或者
“无穷”。
--fragment-retries RETRIES片段的重试次数（默认
是10）或“无限”（DASH，hlsnative和
主义）
--skip-unavailable-fragments跳过不可用的片段（DASH，hlsnative
和ISM）
--abort-on-unavailable-fragment当某些片段不存在时中止下载
可用的
--keep-fragments之后将下载的片段保留在磁盘上
下载完成；碎片是
默认删除
--buffer-size SIZE下载缓冲区的大小（例如1024或16K）
（默认为1024）
--no-resize-buffer不自动调整缓冲区
尺寸。默认情况下，缓冲区大小为
从初始值自动调整大小
的大小。
--http-chunk-size SIZE基于块的HTTP的块大小
下载（例如10485760或10M）（默认
被禁用）。可能对绕过有用
Web服务器施加的带宽限制
（实验性）
--playlist-reverse以相反的顺序下载播放列表视频
--playlist-random以随机顺序下载播放列表视频
--xattr-set-filesize使用以下命令设置文件xattribute ytdl.filesize
预期文件大小
--hls-prefer-native使用本机HLS下载程序代替
ffmpeg
--hls-prefer-ffmpeg使用ffmpeg代替本机HLS
下载器
--hls-use-mpegts将mpegts容器用于HLS视频，
允许在播放视频的同时
下载（某些播放器可能无法
播放）
--external-downloader命令使用指定的外部下载器。
目前支持
aria2c，avconv，axel，curl，ffmpeg，httpie，wget
--external-downloader-args ARGS将这些参数提供给外部
下载器
文件系统选项：
-a，--batch-file文件包含要下载的URL的文件（“-”表示
标准输入），每行一个URL。行开始
用'＃'，';'或']'被认为是
评论和忽略。
--id在文件名中仅使用视频ID
-o，--output TEMPLATE输出文件名模板，请参见“输出
TEMPLATE”查看所有信息
--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标头进行设置
文件修改时间
--write-description将视频描述写入.description
文件
--write-info-json将视频元数据写入.info.json文件
--write-annotations将视频注释写入
.annotations.xml文件
--load-info-json文件包含视频信息的JSON文件
（使用“ --write-info-json”创建
选项）
--cookies FILE文件，用于从中读取cookie并转储cookie
罐入
--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模拟，安静但打印URL
-e，--get-title模拟，安静但可打印标题
--get-id模拟，安静但打印ID
--get-thumbnail模拟，安静但打印缩略图URL
--get-description模拟，安静但打印视频描述
--get-duration模拟，安静但可打印视频长度
--get-filename模拟，安静但打印输出文件名
--get-format模拟，安静但打印输出格式
-j，--dump-json模拟，安静但打印JSON信息。
有关说明，请参见“输出模板”。
可用键。
-J，--dump-single-json模拟，安静但打印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指定自定义用户代理
--referer URL指定自定义引荐来源，如果视频
访问仅限于一个域
--add-header FIELD：VALUE指定自定义HTTP标头及其值，
以冒号“：”分隔。你可以用这个
多次选择
--bidi-workaround解决缺少的终端
双向文本支持。需要bidiv
或fribidi可执行文件在PATH中
--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不要下载DASH清单和
YouTube视频上的相关数据
--merge-output-format FORMAT如果需要合并（例如
bestvideo + bestaudio），输出给定
容器格式。 mkv，mp4，ogg之一
韦布姆如果不需要合并，则忽略
字幕选项：
--write-sub写字幕文件
--write-auto-sub写入自动生成的字幕文件
（仅限YouTube）
--all-subs下载所有可用的字幕
视频
--list-subs列出视频的所有可用字幕
--sub-format FORMAT字幕格式，接受格式
首选项，例如：“ srt”或
“ ass / srt / best”
--sub-lang LANGS字幕语言下载
（可选），以逗号分隔，请使用--list-
可用语言标签的子项
身份验证选项：
-u，--username USERNAME使用此帐户ID登录
-p，--password PASSWORD帐户密码。如果保留此选项
出来，youtube-dl会互动询问。
-2，--twofactor TWOFACTOR两因素身份验证代码
-n，--netrc使用.netrc身份验证数据
--video-password密码视频密码（vimeo，smotri，youku）
Adobe Pass选项：
--ap-mso MSO Adobe Pass多系统操作员（电视
提供程序）标识符，对--ap-list-mso使用
可用的MSO列表
--ap-username USERNAME多系统操作员帐户登录
--ap-password密码多系统操作员帐户密码。
如果忽略此选项，则youtube-dl将
互动询问。
--ap-list-mso列出所有支持的多系统
经营者
后处理选项：
-x，--extract-audio将视频文件转换为纯音频文件
（需要ffmpeg或avconv和ffprobe或
avprobe）
--audio-format FORMAT指定音频格式：“最佳”，“ aac”，
“ flac”，“ mp3”，“ m4a”，“ opus”，“ vorbis”或
“波浪”；默认情况下为“最佳”；没有没有效果
-X
--audio-quality质量指定ffmpeg / avconv音频质量，插入
0（更好）和9（更差）之间的值
用于VBR或特定的比特率，例如128K
（默认为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格式解析其他元数据，例如歌曲标题/
视频标题中的艺术家。格式
语法与--output相同。定期
具有命名捕获组的表达式可以
也可以使用。解析后的参数替换
现有值。示例：--metadata-from-
标题“％（artist）s-％（title）s”与
标题为“ Coldplay-Paradise”。例
（正则表达式）：--metadata-from-title
“（（？P <artist>。+？）-（？P <title>。+）”
--xattrs将元数据写入视频文件的xattrs
（使用都柏林核心和xdg标准）
--fixup策略自动更正已知的错误
文件。永不（不执行任何操作）之一，警告（仅
发出警告），detect_or_warn（
默认;如果可以，请修复文件，警告
除此以外）
--prefer-avconv在运行ffmpeg时优先使用avconv
后处理器
--prefer-ffmpeg在运行avconv时优先使用ffmpeg
后处理器（默认）
--ffmpeg-location PATH ffmpeg / avconv二进制文件的位置；
二进制文件的路径或其
包含目录。
--exec CMD之后在文件上执行命令
下载，类似于find的-exec
句法。示例：--exec'adb push {}
/ sdcard / Music / && rm {}'
–convert-subs格式将字幕转换为其他格式
（当前支持：srt | ass | vtt | lrc）
