youtube-dl 中文版帮助文档目录

选项：

常规选项：

-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 Adob​​e 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 。+？）-（？P