yt-dlp操作命令和脚本

常规选项

-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-items1 2 5 8英寸，如果你想下载视频在播放列表中索引1,2,5,8。你可以指定范围:”——playlist-items1-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 httpiewget(推荐:aria2c)。您可以使用此选项多次设置不同不同协议的下载程序。为示例:——downloader aria2c——downloader"dash,m3u8:native"将使用aria2cHttp /ftp下载，和本机下载的dash/m3u8下载(别名:——external-downloader)
--downloader-args NAME:ARGS      把这些论点交给外部下载器。指定下载器名称和参数由冒号":"分隔。为Ffmpeg，参数可以传递给不同的位置使用相同的语法——postprocessor-args。你可以用这个选择多次给予不同不同下载程序的参数(别名:——external-downloader-args)

文件系统选项

-a, --batch-file FILE            包含要下载的url的文件('-' forstdin)，每行一个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 oggwebm 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 '

YT-DLP

这是一个更完整的程序示例，该程序仅输出错误（以及下载完成后的一条短消息），将视频转换为 mp3 文件，实现自定义后处理器并将最终 info_dict 打印为 json：

import jsonimport yt_dlp
from yt_dlp.postprocessor.common import PostProcessorclass 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] '):passelse:self.info(msg)def info(self, msg):passdef warning(self, msg):passdef error(self, msg):print(msg)class MyCustomPP(PostProcessor):def run(self, info):self.to_screen('Doing stuff')return [], infodef 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)))