-h, --help                       打印帮助文本并退出
--version                        打印程序版本并退出
-U, --update                     将这个程序更新到最新版本。确保您有足够的权限(如果需要，可以使用sudo运行)
-i, --ignore-errors              忽略下载和后处理错误。即使后处理失败，downlocal也被认为是成功的
--no-abort-on-error              继续下一个关于下载错误的视频;例如跳过播放列表中不可用的视频(默认)
--abort-on-error                 如果发生错误，终止进一步的视频下载(别名:——no-ignore-errors)
--dump-user-agent                显示当前用户代理并退出
--list-extractors                列出所有支持的提取器并退出
--extractor-descriptions         所有支持的提取器和退出的输出描述
--force-generic-extractor        使用通用提取器强制提取
--default-search PREFIX          对不符合条件的url使用此前缀。
                                 例如“gvsearch2:”为搜索词“大苹果”从谷歌视频下载两个视频。
                                 使用值"auto"让yt-dlp进行猜测("auto_warning"在猜测时发出警告)。
                                  "error"只是抛出一个错误。默认值“fixup_error”修复损坏的url，
                                 但如果无法进行搜索，则会发出错误
--ignore-config, --no-config     禁用加载除——config-location提供的配置文件外的任何配置文件。
                                 当在配置中给出时文件，不再加载进一步的配置文件。
                                 此外，(为了向后兼容)如果在系统配置文件中找到这个选项，
                                 则用户配置不会被加载
--config-location PATH           主配置文件的位置;到配置或其包含目录的路径
--flat-playlist                  不提取播放列表中的视频，只列出它们
--no-flat-playlist               提取一个playzist的视频
--mark-watched                   标记视频观看(甚至-模拟)。目前仅支持YouTube
--no-mark-watched                不标记观看的视频(默认)
--no-colors                      不发出彩色代码输出
--compat-options OPTS            可以帮助保持兼容性的选项使用youtube-dl或youtube-dlc
                                 通过恢复一些配置对yt-dlp的改动。看到“差异默认行为”的详细信息

--proxy URL                      使用指定的HTTP/HTTPS/SOCKS代理。
                                 要启用SOCKS代理，请指定合适的代理
                                 计划。例如
                                 socks5: / / 127.0.0.1:1080 /。传入空的
                                 String(——proxy "")用于直接连接
--socket-timeout SECONDS         在放弃之前等待的时间，以秒为单位
--source-address IP              绑定到的客户端IP地址
-4, --force-ipv4                 通过IPv4进行所有连接
-6, --force-ipv6                 通过IPv6进行所有连接

--geo-verification-proxy URL     使用此代理来验证的IP地址
                                 一些geo-restricted网站。默认的
                                 由——Proxy指定的代理(如果
                                 选项不存在)用于
                                 实际下载
--geo-bypass                     通过作假绕过地理限制X-Forwarded-For 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       播放列表视频项目下载。指定
                                 播放列表中视频的索引
                                 用逗号隔开，如:"——playlist-items
                                 1 2 5 8英寸，如果你想下载视频
                                 在播放列表中索引1,2,5,8。你可以
                                 指定范围:”——playlist-items
                                 1-3,7,10-13"，它会下载视频
                                 在指数12 3 7 10 11 12和13处
--max-downloads NUMBER           下载NUMBER文件后中止
--min-filesize SIZE              切勿下载任何小于尺寸(如50k或446m)的影片。
--max-filesize SIZE              切勿下载超过大小的影片(例如50k或446m)
--date DATE                      只下载在此日期上传的视频。日期可以是“YYYYMMDD”或以下格式"
                                 (now l today) [+-][0-9] (day lweek | month l year) (s)?"
--datebefore DATE                只下载在此日期或之前上传的视频。接受的日期格式与——date相同
--dateafter DATE                 只下载在此日期或之后上传的视频。接受的日期格式与——date相同
--match-filter FILTER            通用的视频滤镜。任何领域(见
                                 “输出模板”)可以与
                                 数字或使用运算符的字符串
                                 定义于“过滤格式”。你可以
                                 还可以简单地指定要匹配的字段
                                 Field is present and !字段"来检查是否
                                 该字段不存在。此外,
                                 Python风格的正则表达式匹配
                                 可以使用“~=”和多个
                                 过滤器可以用“&”进行检查。使用“\”
                                 转义"&"或引号(如果需要)。例如:
                                 ——match-filter”!is_live & like_count > ?One hundred.
                                 & description~='(?i)\bcats \& dogs\b'"
                                 只匹配那些不是直播的视频，有
                                 一个点赞数超过100个(或类似数)
                                 字段不可用)，并具有
                                 包含短语“猫”的描述
                                 &狗”(忽略案例)
--no-match-filter                不要使用通用的视频过滤器(默认)
--no-playlist                    如果URL指的是视频和播放列表，则只下载视频
--yes-playlist                   如果URL是指视频和播放列表，请下载播放列表
--age-limit YEARS                只下载适合特定年龄的视频
--download-archive FILE          只下载档案文件中没有列出的视频。记录所有下载视频的id
--break-on-existing              当遇到存档中的文件时，停止下载过程
--break-on-reject                当遇到已过滤掉的文件时，停止下载过程
--skip-playlist-after-errors N   允许的失败数，直到跳过播放列表的其余部分
--no-download-archive            不要使用存档文件(默认)

-N, --concurrent-fragments N     应该并发下载的dash/ hlnative视频片段数(默认为1)
-r, --limit-rate RATE            最大下载速率(字节/秒)(例如50K或4.2M)
--throttled-rate RATE            最小下载速率(以字节/秒为单位)，低于此速率时将进行节流并重新提取视频数据(例如100K)


-R, --retries RETRIES            重试次数(默认为10)，或“无限”
--fragment-retries RETRIES       一个片段的重试次数(默认为10)，或“无限”(DASH, hLsnative和~ AAAISM)
--skip-unavailable-fragments     跳过DASH hlnative和ISM的不可用片段(默认)
                                 (Alias: --no-abort-on-unavailable-fragment)
--abort-on-unavailable-fragment  如果片段不可用，则中止下载
                                 (Alias: --no-skip-unavailable-fragments)
--keep-fragments                 下载完成后，将下载的片段保存在磁盘上
--no-keep-fragments              下载完成后删除下载的片段(默认)
--buffer-size SIZE               下载缓冲区的大小(例如1024或16K)(默认是1024)
--resize-buffer                  缓冲区大小从初始值——buffer-size(默认值)自动调整
--no-resize-buffer               不自动调整缓冲区大小
--http-chunk-size SIZE           基于块的HTTP下载块的大小(例如10485760或10M)(默认禁用)。
                                 可能对绕过网络服务器施加的带宽节流有用(实验)
--playlist-reverse               按倒序下载播放列表视频
--no-playlist-reverse            按默认顺序下载播放列表视频(默认)
--playlist-random                按随机顺序下载播放列表视频
--xattr-set-filesize             设置文件xattribute ytdl。文件大小与预期的文件大小
--hls-use-mpegts                 对HLS视频使用mpegts容器;允许一些播放器在下载时播放视频，
                                 并减少下载中断时文件损坏的机会。这在默认情况下为实时流启用
--no-hls-use-mpegts              不要在HLS视频中使用mpegts容器。当不下载实时流时，这是默认值
--downloader [PROTO:]NAME        要加载的外部下载程序的名称或路径
                                 使用(可选地)以协议为前缀
                                 (http, ftp, m3u8, dash, rstp, rtmp, mms)到
                                 用它来。目前支持本地,
                                 Aria2c avconv axel curl ffmpeg httpie
                                 wget(推荐:aria2c)。您可以使用
                                 此选项多次设置不同
                                 不同协议的下载程序。为
                                 示例:——downloader aria2c——downloader
                                 "dash,m3u8:native"将使用aria2c
                                 Http /ftp下载，和本机
                                 下载的dash/m3u8下载
                                 (别名:——external-downloader)
--downloader-args NAME:ARGS      把这些论点交给外部
                                 下载器。指定下载器名称和
                                 参数由冒号":"分隔。为
                                 Ffmpeg，参数可以传递给
                                 不同的位置使用相同的语法
                                 ——postprocessor-args。你可以用这个
                                 选择多次给予不同
                                 不同下载程序的参数
                                 (别名:——external-downloader-args)

-a, --batch-file FILE            包含要下载的url的文件('-' for
                                 stdin)，每行一个URL。行开始
                                 '#'， ';'或']'被认为是评论和忽视
--no-batch-file                  不从批处理文件中读取url(默认)
-P, --paths [TYPES:]PATH         文件所在的路径
                                 下载。指定文件类型和
                                 以冒号“:”分隔的路径。所有的
                                 支持与——output相同的类型。
                                 此外，您还可以提供“家”
                                 (默认)和"temp"路径。所有
                                 中间文件首先被下载到
                                 临时路径和最终文件是
                                 下载后移动到主路径
                                 完成为止。如果。该选项将被忽略
                                 ——output是一个绝对路径
-o, --output [TYPES:]TEMPLATE    输出文件名模板;详见“输出模板”
--output-na-placeholder TEXT     不可用元的占位符值 输出文件名模板中的字段 (默认:“NA”)
--restrict-filenames             将文件名限制为ASCII字符，避免文件名中出现"&"和空格
--no-restrict-filenames          允许使用Unicode字符，"&"和空格文件名(默认)
--windows-filenames              强制文件名与窗口兼容
--no-windows-filenames           使文件名窗口兼容只有当使用windows(默认)
--trim-filenames LENGTH          限制文件名长度(不包括扩展)到指定的号码字符
-w, --no-overwrites              不覆盖任何文件
--force-overwrites               覆盖所有视频和元数据文件。他的选择包括——不继续
--no-force-overwrites            不覆盖视频，但覆盖相关文件(默认)
-c, --continue                   恢复部分下载的文件/片段(默认)
--no-continue                    不要恢复部分下载的片段。如果文件没有分片，则开始下载整个文件
--part                           使用.part文件而不是直接写入输出文件(默认)
--no-part                        不要使用。part文件-直接写入输出文件
--mtime                          使用Last-modified头来设置文件修改时间(默认)
--no-mtime                       不使用Last-modified头来设置文件修改时间
--write-description              将视频描述写入。description文件
--no-write-description           不写视频描述(默认)
--write-info-json                将视频元数据写入.info.json文件(可能包含个人信息)
--no-write-info-json             不写视频元数据(默认)
--write-playlist-metafiles       编写播放列表元数据，除了
                                 使用——write-info-json时的视频元数据，
                                 ——write-description等等。(默认)
--no-write-playlist-metafiles    当使用——write-info-json，——write-description等时，不要写入播放列表元数据。
--clean-infojson                 删除一些私有字段，例如
                                 infojson中的文件名。注意它
                                 还会有私人恩怨吗
                                 信息(默认)
--no-clean-infojson              将所有字段写入infojson
--write-comments                 检索视频评论放置在
                                 infojson。这些评论是牵强附会的
                                 没有这个选项，如果提取是
                                 以快速著称(别名:-get-comments)
--no-write-comments              不要检索视频评论，除非 撤离速度是众所周知的 (别名:——no-get-comments)
--load-info-json FILE            包含视频信息的JSON文件(使用"——write-info-json"选项创建)
--cookies FILE                   文件读取cookie和转储cookie罐子
--no-cookies                     不要从/文件默认读取/转储cookie)
--cookies-from-browser BROWSER[:PROFILE]
                                 的用户配置文件加载cookie
                                 给定的web浏览器。目前支持
                                 浏览器有:勇敢，铬，铬，
                                 Edge, firefox, opera, safari, vivaldi。你
                                 可以指定用户配置文件名称或
                                 使用"BROWSER:PROFILE_NAME"或
                                 “浏览器:PROFILE_PATH”。如果没有配置文件
                                 给定，最近访问的是
                                 使用
--no-cookies-from-browser        不要从浏览器加载cookie(默认)
--cache-dir DIR                  youtube-dl所在的文件系统中的位置
                                 可以存储一些下载的信息(如 作为客户端标识和签名)永久。
                                 默认情况下$XDG_CACHE_HOME/yt-dlp或
                                 ~ / .cache / yt-dlp
--no-cache-dir                   禁用文件系统缓存
--rm-cache-dir                   删除所有文件系统缓存文件

--write-thumbnail                将缩略图图像写入磁盘
--no-write-thumbnail             不将缩略图图像写入磁盘(默认)
--write-all-thumbnails           将所有缩略图图像格式写入磁盘
--list-thumbnails                列出每个视频的可用缩略图。模拟除非使用-no- simulation

--write-link                     写一个互联网快捷方式文件，取决于
                                 在当前平台上(。url, .webloc或
                                 desktop)。该URL可能被操作系统缓存
--write-url-link                 编写一个。url的Windows互联网快捷方式。操作系统根据文件路径缓存URL
--write-webloc-link              编写一个。webloc macOS互联网快捷方式
--write-desktop-link             编写一个。desktop Linux internet快捷方式

-q, --quiet                      启动安静模式。如果与——verbose一起使用，则将日志打印到stderr
--no-warnings                    忽略警告,
-s, --simulate                   不下载视频，不写任何东西到磁盘
--no-simulate                    即使使用了打印/列表选项，也可以下载视频
--ignore-no-formats-error        忽略“无视频格式”错误。有用 提取元数据，即使是视频
                                 实际上不是可以下载的吗 (实验)
--no-ignore-no-formats-error     当没有找到可下载的视频格式时抛出错误(默认)
--skip-download                  不下载视频，但写入所有相关文件(别名:——no-download)
-O, --print TEMPLATE             安静的，但要为每个字段打印给定的字段 视频。模拟除非——no- simulation是
                                 使用。一个字段名或相同的语法 可以使用输出模板
-j, --dump-json                  安静的，但是为每个输出JSON信息
                                 视频。模拟除非——no- simulation是
                                 使用。参见“输出模板”
                                 可用密钥描述
-J, --dump-single-json           安静，但是为每个输出JSON信息
                                 Url或infojson已传递。模拟,除非
                                 ——no-simulate使用。如果URL指向
                                 一个播放列表，整个播放列表信息
                                 在一条线上倾倒
--force-write-archive            即使使用了-s或其他模拟选项，只要没有发生错误，就强制写入下载存档项
                                 (Alias: --force-download-archive)
--newline                        以新行输出进度条
--no-progress                    不打印进度条
--progress                       显示进度条，即使在安静模式
--console-title                  在控制台标题栏显示进度
--progress-template [TYPES:]TEMPLATE
                                 可选的进度输出模板
                                 以“download:”(默认)作为前缀，
                                 “download-title”(主机游戏名称)，
                                 “后处理:”或“postprocess-title:”。
                                 视频的字段可以在
                                 "info"键和进度属性是
                                 可在“进度”键下访问。例如:
                                 ——console-title progress-template
                                 “download-title: % s - (info.id) % (progress.eta)”
-v, --verbose                    打印各种调试信息
--dump-pages                     打印使用base64编码的下载页面以调试问题(非常冗长)
--write-pages                    将下载的中间页面写入当前目录中的文件以调试问题
--print-traffic                  显示发送和读取的HTTP流量

--encoding ENCODING              强制指定的编码(实验性)
--no-check-certificate           禁止HTTPS证书验证
--prefer-insecure                使用未加密的连接来检索有关视频的信息(目前仅支持YouTube)
--user-agent UA                  指定自定义用户代理
--referer URL                    指定一个自定义引用，如果视频访问被限制在一个域使用
--add-header FIELD:VALUE         指定一个自定义HTTP报头及其值，用冒号":"分隔。你可以多次使用这个方法
--bidi-workaround                解决缺乏双向文本支持的终端。在PATH中需要双div r fribidi可执行文件
--sleep-requests SECONDS         数据提取期间请求之间的休眠秒数
--sleep-interval SECONDS         入睡前的秒数
                                 下载。这是最小的睡眠时间
                                 当与——max-sleep-interval一起使用时
                                 (别名:——min-sleep-interval)
--max-sleep-interval SECONDS     睡眠的最大秒数。只能与-min-sleep-interval一起使用
--sleep-subtitles SECONDS        每次字幕下载前休眠的秒数

-f, --format FORMAT              视频格式代码，详见“格式选择”
-S, --format-sort SORTORDER      根据给定的字段对格式进行排序，详见“格式排序”
--S-force, --format-sort-force   强制用户指定的排序顺序优先于所有字段，详情请参阅“排序格式”
--no-format-sort-force           有些字段优先于用户指定的排序顺序(默认)，请参阅“排序格式”了解更多细节
--video-multistreams             允许多个视频流合并成一个单一的文件
--no-video-multistreams          每个输出文件只下载一个视频流(默认)
--audio-multistreams             允许多个音频流合并成一个单一的文件
--no-audio-multistreams          每个输出文件只下载一个音频流(默认)
--prefer-free-formats            更喜欢带有免费容器的视频格式 而非同等质量的免费产品。使用
                                 与“-S ext”严格偏好免费 集装箱不论质量如何
--no-prefer-free-formats         不要给空闲容器任何特殊的优先级(默认)
--check-formats                  检查所选的格式是否确实可以下载
--no-check-formats               不检查所选的格式实际上是可下载的
-F, --list-formats               列出每个视频的可用格式。模拟除非使用-no- simulation
--merge-output-format FORMAT     如果需要合并(例如，bestvideo+bestaudio)，输出到给定的容器格式。mkv mp4 ogg
                                 webm flv。如果不需要合并，则忽略

--write-subs                     编写字幕文件
--no-write-subs                  不写字幕文件(默认)
--write-auto-subs                写自动生成的字幕文件(别名:——Write -automatic-subs)
--no-write-auto-subs             不写自动生成的字幕(默认)(别名:——no-write-automatic-subs)
--list-subs                      列出每个视频可用的字幕。模拟除非使用-no- simulation
--sub-format FORMAT              字幕格式，接受格式优先，例如:“srt”或“ass/srt/best”
--sub-langs LANGS                语言字幕下载(可以是正则表达式)或用逗号分隔的“全部”。
                                 (例如:——sub-langs en.*，ja 带有"-"的语言代码免除了它
                                 从请求的语言。(如:——子 使用——list-subs 可用语言标记列表

-u, --username USERNAME          使用此帐户ID登录
-p, --password PASSWORD          账户密码。如果省略了这个选项，那么yt-dlp将会交互地询问
-2, --twofactor TWOFACTOR        双因素身份验证代码
-n, --netrc                      使用.netrc身份验证数据
--netrc-location PATH            .netrc认证数据的位置;路径或其包含的目录。默认为~ / . netrc
--video-password PASSWORD        视频密码(vimeo, youku)
--ap-mso MSO                     Adobe Pass多系统运营商(电视供应商)标识符，使用——ap-list-mso为可用的mso列表
--ap-username USERNAME           多系统操作员帐号登录
--ap-password PASSWORD           多系统操作员帐号密码。
                                 如果省略了这个选项，那么yt-dlp将会交互地询问
--ap-list-mso                    列出所有支持的多系统操作符

-x, --extract-audio              将视频文件转换为音频文件(需要ffmpeg和ffprobe)
--audio-format FORMAT            指定音频格式以转换音频
                                 当使用-x时。目前支持
                                 格式有:best(默认)或
                                 最好| aac | flac mp3 | | m4a格式|作品| vorbis | wav
--audio-quality QUALITY          指定ffmpeg音频质量，插入一个
                                 值介于0(较好)和9(较差)之间
                                 VBR或特定的比特率，如128K (默认5)
--remux-video FORMAT             将视频重新放入另一个容器，如果 必要的
                                 (目前支持:mp4|mkv|flv | webm | mov avi mp3 | | | mka | m4a格式| ogg |作品)。
                                 如果 目标容器不支持 视频/音频编解码器，重放将失败。你
                                 可以指定多个规则;如。 “aac>m4a/mov>mp4/mkv”将重放aac到 M4a, mov到mp4，其他任何东西到mkv。
--recode-video FORMAT            重新编码成另一种格式，如果 重新编码是必要的。的语法和 支持的格式与——remux-video相同
--postprocessor-args NAME:ARGS   将这些参数给后处理器。
                                 指定后处理器/可执行程序名称
                                 参数由冒号":"分隔
                                 将参数赋给指定的
                                 后处理程序/可执行。支持页:
                                 合并,ModifyChapters SplitChapters,
                                 ExtractAudio、VideoRemuxer VideoConvertor,
                                 元数据、EmbedSubtitle EmbedThumbnail,
                                 SubtitlesConvertor ThumbnailsConvertor,
                                 FixupStretched、FixupM4a FixupM3u8,
                                 FixupTimestamp FixupDuration。的
                                 支持的可执行文件有:AtomicParsley，
                                 FFmpeg FFprobe。你也可以指定
                                 “PP+EXE:ARGS”给出了论证
                                 仅在使用时指定可执行文件
                                 由指定的后处理程序处理。
                                 此外，对于ffmpeg/ffprobe， "_i"/"_o"
                                 可以附加到前缀可选
                                 后面跟着一个数字来传递参数
                                 在指定的输入/输出文件之前。例如:
                                 ——ppa“合并+ ffmpeg_i1: - v安静”。你可以
                                 多次使用这个选项
                                 不同的论点
                                 后处理程序。(别名:——ppa)
-k, --keep-video                 后期处理后将中间视频文件保存在磁盘上
--no-keep-video                  后期处理后删除中间视频文件(默认)
--post-overwrites                覆盖后期处理的文件(默认)
--no-post-overwrites             不覆盖后期处理的文件
--embed-subs                     视频中嵌入字幕(仅mp4, webm和mkv视频)
--no-embed-subs                  不要嵌入字幕(默认)
--embed-thumbnail                嵌入缩略图在视频作为封面艺术
--no-embed-thumbnail             不嵌入缩略图(默认)
--embed-metadata                 在视频文件中嵌入元数据。还增加了
                                 章节文件除非-no-add-章
                                 别名:——add-metadata
--no-embed-metadata              不添加元数据到文件(默认)(别名:——no-add-metadata)
--embed-chapters                 添加章节标记到视频文件(别名:——Add -章)
--no-embed-chapters              不添加章节标记(默认)(别名:——no-add-章)
--parse-metadata FROM:TO         解析其他领域的元数据，如标题/艺术家;详情请参见“修改元数据”
--replace-in-metadata FIELDS REGEX REPLACE 使用给定的正则表达式替换元数据字段中的文本。这个选项可以多次使用
--xattrs                         将元数据写入视频文件的xattrs(使用dublin core和xdg标准)
--fixup POLICY                  自动纠正系统的已知故障
                                文件。一个永远(什么都不做)，警告(只有)
                                发出警告)，detect_or_warn
                                违约;如果可以，修复文件，警告
                                否则)，强制(尝试修复即使文件
                                已经存在
--ffmpeg-location PATH          ffmpeg二进制文件的位置;二进制文件或其包含目录的路径
--exec CMD                       在文件上执行命令
                                 下载和后处理。相同
                                 语法作为输出模板可以使用
                                 将任何字段作为参数传递给
                                 命令。附加字段“filepath”
                                 它包含了
                                 下载的文件也可用。如果没有
                                 字段被传递，%(filepath)q被追加
                                 直到命令的最后。这个选项可以
                                 多次使用
--no-exec                        删除任何先前定义的——exec
--exec-before-download CMD       执行命令之前，实际下载。语法与——exec相同
                                 但是“filepath”不可用。这选项可以多次使用
--no-exec-before-download        删除任何以前定义的- execute -before-download
--convert-subs FORMAT            将字幕转换为另一种格式(目前支持:srt|vtt|ass|lrc)(别名:——Convert -副标题)
--convert-thumbnails FORMAT      将缩略图转换为另一种格式(目前支持:jpg|png)
--split-chapters                 将视频分割成多个文件基于
                                 内部章节。“章:”前缀
                                 可以与"——paths"和"——output"一起使用
                                 设置分割的输出文件名
                                 文件。详见“OUTPUT TEMPLATE”
--no-split-chapters              不要基于章节分割视频(默认)
--remove-chapters REGEX          删除标题匹配的章节
                                 给定的正则表达式。时间范围
                                 用“*”作为前缀也可以在适当的地方使用
                                 的章节，以删除指定的范围。
                                 如:remove-chapters“* 10:15-15:00”
                                 ——remove-chapters“介绍”。这个选项可以多次使用
--no-remove-chapters             不要从文件中删除任何章节(默认)
--force-keyframes-at-cuts       强制关键帧围绕章节之前
                                删除/分裂。需要一个
                                重新编码会很慢，但是
                                最终的视频可能有更少的伪影
                                在削减
--no-force-keyframes-at-cuts    当切割/分割章节时，不要强制关键帧(默认)插件的(区分大小写)名称
--use-postprocessor NAME[:ARGS]  启用后处理器，以及 (可选)传递给它的参数，
                                 由冒号":"分隔。参数是一个
                                 分号";"分隔的NAME=VALUE列表。
                                 "when"参数决定 后处理程序被调用。它可以是
                                 “pre_process”(提取)后, "before_dl"(视频下载前)，
                                 "post_process"(视频下载后; 或"after_move"(在移动文件后
                                 最终到达目的地)。这个选项可以 可多次使用以添加不同 后处理程序

--extractor-retries RETRIES      已知提取器错误的重试次数(默认为3)，或“无限”
--allow-dynamic-mpd              进程动态DASH清单(默认)(别名:——no-ignore-dynamic-mpd)
--ignore-dynamic-mpd             不处理动态DASH清单(别名:—no-allow-dynamic-mpd)
--hls-split-discontinuity        将HLS播放列表分割成不同的格式，如广告中断
--no-hls-split-discontinuity     不要将HLS播放列表分割成不同的格式，如广告中断(默认)
--extractor-args KEY:ARGS        将这些参数传递给提取器。看到 详细信息请参见“EXTRACTOR ARGUMENTS”。
                                 你可以多次使用这个选项 不同提取器的参数

该-o选项用于指示输出文件名的模板，而-P选项用于指定每种类型的文件应保存到的路径。

tl;dr： 导航到示例。

最简单的用法-o是在下载单个文件时不设置任何模板参数，例如 in yt-dlp -o funny_video.flv "https://some/video"（不推荐像这样的硬编码文件扩展名，可能会破坏一些后处理）。

然而，它也可能包含在下载每个视频时将被替换的特殊序列。特殊序列可以根据python字符串格式化操作进行格式化。例如，%(NAME)s或%(NAME)05d。澄清一下，这是一个百分比符号，后跟括号中的名称，后跟格式化操作。

字段名本身（括号内的部分）也可以有一些特殊的格式：

对象遍历：可以使用.（点）分隔符遍历元数据中可用的字典和列表。您还可以使用:. 例如：%(tags.0)s, %(subtitles.en.-1.ext)s, %(id.3:7:-1)s, %(formats.:.format_id)s。%()s指的是整个 infodict。请注意，下面未列出使用此方法可用的所有字段。使用-j看到这样的领域
加法：数字字段的加法和减法可以分别使用+和来完成-。例如：%(playlist_index+10)03d，%(n_entries+1-playlist_index)d
日期/时间格式：可以根据strftime 格式设置日期/时间字段的格式，方法是使用>. 例如：%(duration>%H-%M-%S)s, %(upload_date>%Y-%m-%d)s,%(epoch-3600>%H-%M-%S)s
备选：备选字段可以用,. 例如：%(release_date>%Y,upload_date>%Y|Unknown)s
Default：可以使用|分隔符指定字段为空时的文字默认值。这将覆盖--output-na-template. 例如：%(uploader|Unknown)s
更换算：除了正常格式类型diouxXeEfFgGcrs，B，j，l，q可用于转化成乙ytes，Ĵ子，逗号分隔升IST（替代形式标志#使得新线\n分隔）和一个串q uoted为终端，分别
Unicode 规范化：格式类型U可用于 NFC Unicode 规范化。替代形式标志 ( #) 将规范化更改为 NFD，并且转换标志+可用于 NFKC/NFKD 兼容性等价规范化。例如：%(title)+.100U是 NFKC
总而言之，字段的一般语法是：

%(name[.keys][addition][>strf][,alternate][|default])[flags][width][.precision][length]type
此外，您可以通过指定文件类型，后跟以冒号分隔的模板，为各种元数据文件分别设置不同的输出模板与通用输出模板:。支持的不同文件类型是subtitle、thumbnail、description、annotation（已弃用）、infojson、link、pl_thumbnail、pl_description、pl_infojson、chapter。例如，-o '%(title)s.%(ext)s' -o 'thumbnail:%(title)s\%(title)s.%(ext)s' 将缩略图放在与视频同名的文件夹中。如果任何模板（默认除外）为空，则不会写入该类型的文件。例如：--write-thumbnail -o "thumbnail:"只会为播放列表而不是视频编写缩略图。

id （字符串）：视频标识符
title （字符串）：视频标题
url （字符串）：视频网址
ext （字符串）：视频文件扩展名
alt_title （字符串）：视频的次要标题
description （字符串）：视频的描述
display_id （字符串）：视频的替代标识符
uploader (string): 视频上传者的全名
license （字符串）：视频许可的许可名称
creator （字符串）：视频的创建者
timestamp （数字）：视频可用时的 UNIX 时间戳
upload_date （字符串）：视频上传日期（YYYYMMDD）
release_date (string): 视频发布的日期 (YYYYMMDD)
release_timestamp （数字）：视频发布时刻的 UNIX 时间戳
uploader_id （字符串）：视频上传者的昵称或 ID
channel （字符串）：上传视频的频道的全名
channel_id （字符串）：频道的 ID
location （字符串）：视频拍摄的物理位置
duration （数字）：以秒为单位的视频长度
duration_string （字符串）：视频的长度（HH:mm:ss）
view_count （数字）：有多少用户在平台上观看过视频
like_count （数字）：视频的正面评价数
dislike_count （数字）：视频的负面评价数
repost_count （数字）：视频的转发次数
average_rating （数字）：用户给出的平均评分，使用的比例取决于网页
comment_count (numeric): 视频的评论数（对于一些提取器，评论只在最后下载，所以这个字段不能使用）
age_limit （数字）：视频的年龄限制（年）
live_status （字符串）：“is_live”、“was_live”、“is_upcoming”、“not_live”之一
is_live (boolean): 这个视频是直播还是定长视频
was_live (boolean): 这个视频最初是否是直播
playable_in_embed (string): 此视频是否允许在其他网站的嵌入式播放器中播放
availability (string): 视频是“private”、“premium_only”、“subscriber_only”、“needs_auth”、“unlisted”还是“public”
start_time （数字）：在 URL 中指定的应开始再现的时间（以秒为单位）
end_time （数字）：复制结束的时间（以秒为单位），如 URL 中所指定
format (string): 人类可读的格式描述
format_id (string): 指定的格式代码 --format
format_note （字符串）：关于格式的附加信息
width （数字）：视频的宽度
height （数字）：视频的高度
resolution (string): 宽度和高度的文字描述
tbr （数字）：以 KBit/s 为单位的音频和视频的平均比特率
abr （数字）：以 KBit/s 为单位的平均音频比特率
acodec （字符串）：正在使用的音频编解码器的名称
asr （数字）：以赫兹为单位的音频采样率
vbr （数字）：以 KBit/s 为单位的平均视频比特率
fps （数字）：帧率
dynamic_range （字符串）：视频的动态范围
vcodec （字符串）：正在使用的视频编解码器的名称
container （字符串）：容器格式的名称
filesize （数字）：字节数，如果事先知道
filesize_approx （数字）：估计字节数
protocol （字符串）：将用于实际下载的协议
extractor （字符串）：提取器的名称
extractor_key (string): 提取器的键名
epoch （数字）：创建文件时的 Unix 纪元
autonumber (numeric): 每次下载都会增加的数字，从 --autonumber-start
n_entries （数字）：播放列表中提取的项目总数
playlist （字符串）：包含视频的播放列表的名称或 ID
playlist_index （数字）：播放列表中视频的索引，根据最终索引填充前导零
playlist_autonumber （数字）：视频在播放列表下载队列中的位置，根据播放列表的总长度填充前导零
playlist_id （字符串）：播放列表标识符
playlist_title （字符串）：播放列表标题
playlist_uploader （字符串）：播放列表上传者的全名
playlist_uploader_id （字符串）：播放列表上传者的昵称或 ID
webpage_url （字符串）：视频网页的 URL，如果提供给 yt-dlp 应该允许再次获得相同的结果
original_url（字符串）：用户提供的 URL（或与webpage_url播放列表条目相同）

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

chapter （字符串）：视频所属章节的名称或标题
chapter_number （数字）：视频所属章节的编号
chapter_id (string): 视频所属章节的 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 (string): 专辑类型
album_artist （字符串）：专辑中出现的所有艺术家的列表
disc_number （数字）：曲目所属的光盘或其他物理介质的编号
release_year （数字）：专辑发行年份（YYYY）
用于带有内部章节的视频chapter:时可用于前缀--split-chapters：

section_title (string): 章节标题
section_number （数字）：文件中的章节编号
section_start （数字）：章节的开始时间（以秒为单位）
section_end （数字）：以秒为单位的章节结束时间
仅在用于--print以下情况时可用：

urls (string): 所有请求格式的 URL，每行一个
filename（字符串）：视频文件的名称。请注意，实际文件名可能因后期处理而有所不同。用于--exec echo在所有后处理完成后获取名称
仅适用于--sponsorblock-chapter-title：

start_time （数字）：章节的开始时间（以秒为单位）
end_time （数字）：以秒为单位的章节结束时间
categories （列表）：章节所属的 SponsorBlock 类别
category (string): 章节所属的最小 SponsorBlock 类别
category_names （列表）：类别的友好名称
name (string): 最小类别的友好名称

输出模板示例
请注意，在 Windows 上，您需要使用双引号而不是单引号。
yt-dlp --get-filename -o ' %(title)s.%(ext)s ' BaW_jenozKc 

默认情况下，如果您不传递任何选项，yt-dlp 会尝试下载最佳可用质量。
这通常等同于使用-f bestvideo*+bestaudio/best.
但是，如果启用了多个音频流 ( --audio-multistreams)，
则默认格式更改为-f bestvideo+bestaudio/best. 
同样，如果 ffmpeg 不可用，或者如果您使用 yt-dlp 流式传输到stdout( -o -)，
则默认值变为-f best/bestvideo+bestaudio.

您还可以使用特殊名称来选择特定的边缘情况格式：

all: 选择所有格式
mergeall：选择和合并所有格式（必须与使用--audio-multistreams，--video-multistreams或两者）
b*, best*: 无论是否包含视频或音频，选择最佳质量格式
w*, worst*: 选择质量最差的格式，不管它是否包含视频或音频
b, best: 选择包含视频和音频的最佳质量格式。相当于best*[vcodec!=none][acodec!=none]
w, worst: 选择包含视频和音频的最差质量格式。相当于worst*[vcodec!=none][acodec!=none]
bv, bestvideo: 选择最佳质量的纯视频格式。相当于best*[acodec=none]
wv, worstvideo: 选择质量最差的纯视频格式。相当于worst*[acodec=none]
bv*, bestvideo*: 选择包含视频的最佳质量格式。它还可能包含音频。相当于best*[vcodec!=none]
wv*, worstvideo*: 选择包含视频的最差质量格式。它还可能包含音频。相当于worst*[vcodec!=none]
ba, bestaudio: 选择质量最好的纯音频格式。相当于best*[vcodec=none]
wa, worstaudio: 选择质量最差的纯音频格式。相当于worst*[vcodec=none]
ba*, bestaudio*: 选择包含音频的最佳质量格式。它还可能包含视频。相当于best*[acodec!=none]
wa*, worstaudio*: 选择包含音频的最差质量格式。它还可能包含视频。相当于worst*[acodec!=none]

filesize: 字节数，如果事先知道的话
width：视频的宽度（如果已知）
height：视频的高度（如果已知）
tbr: 音频和视频的平均比特率 (KBit/s)
abr：以 KBit/s 为单位的平均音频比特率
vbr: 以 KBit/s 为单位的平均视频比特率
asr：以赫兹为单位的音频采样率
fps：帧率
还过滤比较=(equals), ^=(starts with), $=(ends with), *=(contains) 和以下字符串元字段的工作：

ext： 文件扩展名
acodec：正在使用的音频编解码器的名称
vcodec：正在使用的视频编解码器的名称
container: 容器格式的名称
protocol: 将用于实际下载的协议，小写 ( http, https, rtsp, rtmp, rtmpe, mms, f4m, ism, http_dash_segments, m3u8, or m3u8_native)
format_id: 格式的简短描述
language: 语言代码

您可以best使用-S( --format-sort)更改被视为 的标准。这个的一般格式是--format-sort field1,field2....

可用的字段是：

hasvid：优先考虑具有视频流的格式
hasaud：优先考虑具有音频流的格式
ie_pref：提取器给出的格式首选项
lang：提取器给出的语言偏好
quality：提取器给出的格式质量
source: 提取器给出的来源偏好
proto: 用于下载的协议 ( https/ ftps> http/ ftp> m3u8_native/ m3u8> http_dash_segments> websocket_frag> 其他 > mms/ rtsp> > 未知 > f4f/ f4m)
vcodec：视频编解码器（av01> vp9.2> vp9> h265> h264> vp8> h263> theora>其它>未知）
acodec：音频编解码器（opus> vorbis> aac> mp4a> mp3> ac3> dts>其他>未知）
codec： 相当于 vcodec,acodec
vext: 视频扩展名 ( mp4> webm> flv> 其他 > 未知)。如果--prefer-free-formats使用，webm则首选。
aext：音频扩展（m4a> aac> mp3> ogg> opus> webm> 其他 > 未知）。如果--prefer-free-formats使用，则顺序更改为opus> ogg> webm> m4a> mp3> aac。
ext： 相当于 vext,aext
filesize: 确切的文件大小，如果事先知道的话。这将不适用于 mu38 和 DASH 格式。
fs_approx：根据清单计算的近似文件大小
size: 如果可用，则为精确文件大小，否则为近似文件大小
height: 视频高度
width: 视频宽度
res：视频分辨率，以最小尺寸计算。
fps: 视频帧率
hdr: 视频的动态范围 ( DV> HDR12> HDR10+> HDR10> HLG> SDR)
tbr：以 KBit/s 为单位的总平均比特率
vbr: 以 KBit/s 为单位的平均视频比特率
abr：以 KBit/s 为单位的平均音频比特率
br: 相当于使用 tbr,vbr,abr
asr：以Hz为单位的音频采样率
请注意，在 Windows 上，您可能需要使用双引号而不是单引号。

#下载并合并最好的纯视频格式和最好的纯音频格式，
#或者如果纯视频格式不可用，则下载最好的组合格式
$ yt-dlp -f ' bv+ba/b '

import json

import yt_dlp
from yt_dlp.postprocessor.common import PostProcessor


class MyLogger:
    def debug(self, msg):
        # For compatability with youtube-dl, both debug and info are passed into debug
        # You can distinguish them by the prefix '[debug] '
        if msg.startswith('[debug] '):
            pass
        else:
            self.info(msg)

    def info(self, msg):
        pass

    def warning(self, msg):
        pass

    def error(self, msg):
        print(msg)


class MyCustomPP(PostProcessor):
    def run(self, info):
        self.to_screen('Doing stuff')
        return [], info


def my_hook(d):
    if d['status'] == 'finished':
        print('Done downloading, now converting ...')


ydl_opts = {
    'format': 'bestaudio/best',
    'postprocessors': [{
        'key': 'FFmpegExtractAudio',
        'preferredcodec': 'mp3',
        'preferredquality': '192',
    }],
    'logger': MyLogger(),
    'progress_hooks': [my_hook],
}

with yt_dlp.YoutubeDL(ydl_opts) as ydl:
    ydl.add_post_processor(MyCustomPP())
    info = ydl.extract_info('https://www.youtube.com/watch?v=BaW_jenozKc')
    print(json.dumps(ydl.sanitize_info(info)))