U g}@sBddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl m Z ddl m Z mZddlmZddlmZmZmZmZmZmZddlmZddlmZmZmZdd lmZm Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,dd l-m.Z.m/Z/dd d Z0Gdddej1Z2Gdddej3Z4ddZ5ddZ6dS)N)compat_expanduser)SUPPORTED_BROWSERSSUPPORTED_KEYRINGS)list_external_downloaders)FFmpegExtractAudioPPFFmpegMergerPPFFmpegSubtitlesConvertorPPFFmpegThumbnailsConvertorPPFFmpegVideoRemuxerPPSponsorBlockPP)"DEFAULT_SPONSORBLOCK_CHAPTER_TITLE)UPDATE_SOURCESdetect_variantis_non_updateable) OUTTMPL_TYPESPOSTPROCESS_WHENConfigdeprecation_warning expand_path format_fieldget_executable_pathget_system_config_dirsget_user_config_dirs join_nonemptyorderedSet_from_options remove_endvariadic write_string)CHANNEL __version__ if_overridec sPdttdkr|dk ddfdddfdd fd d }td d d }zrzz>|dk rj |ddnj t j ddddt |}Wn.t k r}zj|W5d}~XYnX|r"djr"tddtjDd}|dk r"j|zjdWn0t k rd}zj|W5d}~XYnX\}}Wnbtjk rttjjd d\}} W5QRXYn"ttfk rd |_YnXW5|joddddd}|rt|d|jr2|r(tdjX|jrDt j||fS)Nyt-dlpr!cWs.tjj|}tj|dd}|dk r*||fSdS)Ndefault)ospathjoinr read_file)pathsr&confr+2/tmp/pip-unpacked-wheel-q5ljy6pj/yt_dlp/options.py read_config2s zparseOpts..read_configc3s|D]}tj|\}}|ks@|tjtddks@t|dV|drn|dV|dV|dVqdS)N~.z.confz .conf.txtconfigz config.txt)r%r&splitr'rAssertionError startswith)Z config_dirsZ config_dirheadtail) PACKAGE_NAMEr-r+r,_load_from_config_dirs8s(  z)parseOpts.._load_from_config_dirscsxdjrdS|r@|dks"tttd|d\}}ntj|d}tj |dd}|dk rtj |||ddS) z- Adds config and returns whether to continue rFN)NNz yt-dlp.confr#labelT) parse_known_args ignoreconfigr2nextfilterr%r&r'rr( append_config)r9r&funcargs current_path)r6r7rootr+r, add_configCs  zparseOpts..add_configc3s\ VdtVdtdjddVdtdVdtdVdS) NZPortableZHomerhomeUser)r?System)rrr:r)getstriprrr+)rCignore_config_filesrBr+r, load_configsRs &zparseOpts..load_configsTF)verbose print_help z | z [debug] rZOverrider8z Command-linercss |]\}}|jdkr|VqdS)rFNr8).0ir*r+r+r, hs zparseOpts..)strict)NN)r create_parseroptparseValuesrLreplacerrMparserr>sysargvall ValueErrorerrorr:r;r< enumerateZconfigspoprK parse_args OptParseError contextlibsuppress SystemExitKeyboardInterruptexit) ZoverrideArgumentsrJrKoptsrLZloaded_all_configserrZ user_confr@_r+)r6r7rCrJr-rBr, parseOpts+sX     " rics(eZdZfddZeddZZS)_YoutubeDLHelpFormattercs*tjp d}tj|td|ddS)NPg?)widthmax_help_position)shutilget_terminal_sizecolumnssuper__init__int)self max_width __class__r+r,rrsz _YoutubeDLHelpFormatter.__init__cCsBt|jo|jd|jo|jddd}|r>|d|j7}|S)z, ('-o', '--option') -> -o, --format METAVAR r, )delim )r _short_opts _long_opts takes_valuemetavar)optionrfr+r+r,format_option_stringssz-_YoutubeDLHelpFormatter.format_option_strings)__name__ __module__ __qualname__rr staticmethodr __classcell__r+r+rvr,rjs rjcsdeZdZdZdZfddZejejfZ ej Z dddZ d d Z d d Zd dZfddZZS)_YoutubeDLOptionParserZ_triggered_aliasesdcs@tjtdkrdndtddtdd||jtt dS)Nsourcer"z%prog [OPTIONS] URL [URL...]zBSee full documentation at https://github.com/yt-dlp/yt-dlp#readmeresolve)progversionusageepilog formatterconflict_handler) rqrrrr rj set_default ALIAS_DEST collections defaultdictrsrtrvr+r,rrsz_YoutubeDLOptionParser.__init__NTc Cs,||g|_|_|p||_|jr|jd}z~|dkrN|jd=Wqnb|drj||j|jnF|dr|dkr||j|jn"|jr|j |j dnWqWq"t j k r}zDt ||jr|j |jn$|rt ||jr|t|W5d}~XYq"Xq"||j|jS)zUSame as parse_args, but ignore unknown switches. Similar to argparse.parse_known_argsr---N) _get_argsrargslargsget_default_valuesvaluesr3_process_long_opt_process_short_optsallow_interspersed_argsappendr^rTr` isinstance_UNKNOWN_OPTIONopt_str _BAD_OPTIONr\str check_values)rtr@rrRargrgr+r+r,r:s.    z'_YoutubeDLOptionParser.parse_known_argscCs8|dt|d}|jr4|d|S|S)Nz : error: rN) get_prog_namerrIr get_usagertmsgr+r+r,_generate_error_messagesz._YoutubeDLOptionParser._generate_error_messagecCst||dSN)rTr`rrr+r+r,r\sz_YoutubeDLOptionParser.errorcCs|dkrtjddSt|S)Nr)rXrYlist)rtr@r+r+r,rsz _YoutubeDLOptionParser._get_argsc shzt|WStjk rb}z4tfdd|jDdkrP|jdWYSW5d}~XYnXdS)z]Improve ambiguous argument resolution by comparing option objects instead of argument stringscsh|]}j|qSr+) _long_opt)rOprr+r, sz9_YoutubeDLOptionParser._match_long_opt..rrN)rq_match_long_optrTAmbiguousOptionErrorlen possibilities)rtoptervrr,rs z&_YoutubeDLOptionParser._match_long_opt)NNT)rrrrALIAS_TRIGGER_LIMITrrrTBadOptionErrorrrOptionValueErrorrr:rr\rrrr+r+rvr,rs  rc"s%ddtjfdd}diddfdd}d d dddtjd fd d fdd}t}t|dtfdd}ddt|d}|jdddddd|jdddd|jd d!d"d#t t t dd$d%t d&d'd(|jd)d*d#d+d,|jd-d.d#d/d0t d1d2d3d4 td5|jd6d7dd8d9d,|jd:d"d8d;dd*d8d?d,|jd@ddAd dBdC|jdDddEd dFdC|jdGddHd dIdC|jdJdKdLdMdNdOg|dPdQ |jdRddSd tjdC|jdTdUdVdWdX|jdYdZdd[d\d,|jd]d"d^gd_d(|jd`d^dadbdcdd|jdedfdadbdgdd|jdhd"didjd dkdl|jdmd*didnd,|jdoddpdqd,|jdrd*dpdsd,|jdtdudvddwdx|jdydud"ddzd{|jd|dd}d d~dC|jdd*d}dd,|jddd"ddddtjd(|jdddidOdLdddgtjddd |jdddtdOdL|ddddddddddddddddddddddddddhdddddgddddddgdddgdddddggdddd |jddddOddL|dtjddt|d}|jddddddč|jddtddddɍ|jdddddd΍|jdddddd΍|jddd ddd֍|jddd"ddddۍ|jddd"ddddۍ|jdddd ddCt|d}|jddddddč|jddddtjdč|jdddddd΍|jdd"ddtjd(|jdd"ddtjd(|jdddtjd|jdddtjdt|d}|jddddttjd|jddddttjd|jdddddddx|jdddtjdX|jdddtjdX|jdd d dd d΍|jd d d ddd΍|jdddddd΍|jdddddd΍|jdddddd΍|jddddttjd|jddddttjd|jdd d!dbd"d#|jd$d!d"dd%d{|jd&d d'dbd(d#|jd)d'd"dd*d{|jd+dd,d d-dC|jd.d*d,d/d,|jd0d1d2dtd3d|jd4d5d6d7d|jd8d6d"dd9d{|jd:d;dtdd<d=|jd>dd?d d@dC|jdAd*d?dBd,|jdCddDd tjdC|jdEddFd dGdC|jdHd*dFdId,|jdJdKdLdtdMd|jdNdOdtjd|jdPdOd*tjdt|dQ} | jdRdSdTdUdVdX| jdWdXdYdZd[dX| jd\d]d^d_d`dX| jdadbddcd dddC| jdedfdadgdX| jdhdidjdkdX| jdldmdZdndX| jdodpdqdrdX| jdsdtdUdudX| jdvdwdZdxdX| jdyddzd d{dC| jd|d}d~ddX| jdddddX| jdddZddXt|d} | jddd.ddddd| jddddgdOdL|dbdidd | jdddddd dd| jdd*ddd dd| jddddddC| jdd*ddd,| jddddddC| jdd*ddd,| jdd"ddtjd(| jdddd ddC| jdd*dd ddC| jdd"ddddd| jddddd,| jdd*ddd,| jdddddd,| jddddtjdC| jddd*dtjd,| jdd.ddddd4 ttjdd| jdddd tjdC| jdd*dtjd,t|d¡} | jdÐdddd ddC| jdǐdd*dŐdd,| jdʐdddd ddC| jdΐdd*dd ddC| jdddd tjdC| jdddd ddC| jdd.dאddؐdِd| jdڐddLdܐddOg|ddQ t|dߡ} | jddddKdtdd| jdddddddX| jdddddX| jdddddddx| jddddddx| jddddddx| jdddidOdLddddd | jdddddddC| jddd*ddd,| jddd d d dC| jd d*d d d,| jd dd dddx| jdd*ddd,| jdddd ddC| jddd dddx| jdddd tjdC| jdddtjd,| jdd*dtjd,| jdddd d,| jd!dd"d#d,| jd$d*d"d%d,| jd&d'dd(d| jd)d*ddtjd+| jd,d*d*dtjd+| jd-d.ddd/d+| jd0d.d*d1d| jd2dd3dbd4d#| jd5d6d7d8idOdLd9dtjdd:d4 ttd;d | jd<d=d>d?idOdLd@dA ttjtdtjddBd t|dC} | jdDdEdFdGdX| jdHddId dJdC| jdKddLd dMdC| jdNdOddPdQd,| jdRdSdTtjd| jdUddVdtjd΍| jdWdXdYidOdLdZd id[d | jd\d]dd^d| jd_dǐd`tdadb| jdcdddǐdetdfdb| jdgdǐdhtdidb| jdjdǐdkd2tdldt|dm}|jdndoddpddqdC|jdrd*dpdsd,|jdtdudd dvd+|jdwdxddyddzdC|jd{d*dyd|d,|jd}dd~d ddC|jdd*d~dd,|jddddd ddC|jdZddd|dddi|jd[dddd|dddi|jddddd tjdC|jddddd tjdC|jdddd tjdC|jdddd tjdC|jdddd tjdC|jdddd tjdC|jdddd tjdC|jdddd tjdC|jddddd ddC|jddddd ddC|jdddd tjdC|jdddddd ddC|jdddd ddC|jddddddC|jdd*ddd,|jdddd ddC|jdddidOdLddÐddd |jddd.dtd2dǐdȍ|jdɐdddd ddC|jd͐dddd ddC|jdddd ddC|jdddd tjdC|jdddd tjdC|jdؐdِddd dېd+|jdܐdݐddd tjd+|jdߐdd*tjdt|d}|jdddd5ddX|jddd"ddd{|jdd ddtjd|jddddidOdLddA ttjtdddd |jddddidOdLdA ttjtdddd |jddddddx|jdddttjd|jddddttjd|jdddd ddC|jdd*ddd,|jdddd ddC|jdd*ddd,|jd d d d d2td d|jddd*ddddC|jdddddd,|jdd"dddd(|jdddddddC|jdd*ddd,|jdd*dd ddC|jd ddd!d,|jd"dd#dd$dC|jd%d*d#d&d,|jd'dd(d d)dC|jd*d*d(d+d,|jd,dd-dd.dC|jd/d*d-d0d,|jd1dd2d tjdC|jd3d*d2tjd,|jd4dd5dd6dC|jd7d*d5d8d,|jd9d:dd;ddd*d;d?d,|jd@dAddBd dCdC|jdDdEd*dBdFd,|jdGdHdId5dJdX|jdKdLd5dMdX|jdNd"ddLd5dOdP|jdQdRdSdTd4 tt dUd4 ttjtt!dX|jdVd"ddRdWdۍ|jdXdYddZd[dč|jd\d*dYd]d,|jd^dd_d`d,t|da}|jdbdLdcd ddddedf|jdgd*dcdhd,|jdid"dcddjd(|jdkddld dmdCt|dn}|jdoddpd dqdC|jdrddsd dtdC|jduddvd dwdC|jdxddyd dzdCt|d{}|jd|d}dd~d ddC|jddddؐdd4 tt"jdd΍|jdddddd΍|jdddddd4 t#jdd΍|jdddddd΍|jddd>didOdLddtjd ddd |jddddd ddC|jdd*ddd,|jdd*ddd,|jdddd ddC|jdddd ddC|jdd*ddd,|jdddd ddC|jdd*ddd,|jddddd ddC|jddd*ddd,|jdddddddC|jddd*ddd,|jddddddC|jdd*ddd,|jdddtjd|jd\ddÐd|dăddi|jd]dÐdǐddȜ|dăddi|jdʐdddd ddC|jdΐdϐdАdѐdҐdӐdԍ|jdՐdϐdddאdؐdԍ|jdِdd*dtjd,|jdܐddddtjdC|jdސddaddd|jd^ddd|dddi|jdd"didd(|jdddbdtjd|jdd"ddtjd(|jdddddddd4 tt$jdd΍|jdddddd4 tt%jdd΍|jddddd dd+|jdddd*dd|jddddbdd#|jddd"ddd{|jdddd ddC|jdd*ddd,d_d d|jd d d gdOdL|dfddddd tj|ddd}|jdddtdLdO|t&j'ddgiddd4 t&j'dd |jdddtdLdO|tt&j'tt&j(dddgiddd4 t&j(dd |jdd t)d!d"d#|jd$d dd%d&d|jd'dd(d)d*d#|jd+dd,d tjdC|jd-d*d,tjd,|jd.d dd/tjd|jd0d*d/tjd,|jd1d dd2tjd|jd3dd2tjd,|jd4dad5d tjd΍|jd6d7d8tjdXt|d9}|jd:d;ddddd?dd@dC|jdAdBd*d?dCd,|jdDdEdd dFd+|jdGdEd*dHdd`dId|jdJdKdLidOdLd fdMddNdOd |jdPdQddRdtjdC|jdSdTd*dRtjd,|jdUdVddWdtjdC|jdXdYd*dWtjd,|*||*||*||*||*| |*||*||*||*||*| |*| |*| |*| |*||*||*||S(aNT,cSsn|rtt|j|jng}ttd|dkr2||gnt|||}t|j|j|dkr`||n||dSNT)rgetattrrdestr=mapr1setattr)rrvaluerWrryprocesscurrentr+r+r,_list_from_options_callbacks,z2create_parser.._list_from_options_callbackcSs |Sr)lowerrI)xr+r+r,zcreate_parser..c Ss|dkr||gnt|||}z(t|t|d|it|j|jd} WnFtk r} z(t d|j d|d| j dW5d} ~ XYnXt |j|jt| dS)NrZ)startwrong z for z: r)rr1rrChainMaprrrr[rTrr~r@rset) rrrrWallowed_valuesryaliasesrr requestedrr+r+r,_set_from_options_callbacks" 6z1create_parser.._set_from_options_callbackz[\w-]+:Fc  Ssptt|j|j} t|t } |r4d|d|d}td|d|d| rT|dn|} | dk r| d d | d }}| r|f|d d}n8|dk rt ||}}n t d |d |j d|dz&| rt| |n|}|r||n|}Wn:tk r.}zt d |d|W5d}~XYnX|D]&}| rP| |g|fn|| |<q4t|j|j| dS)N(z)(,(z))*z(?is)(?P)z (?P.*)$rkeysrvalrrz formatting; it should be z, not "" formatting; )dictrrrrrrematchgroupr1rrTrr~r ExceptionrHr)rrrrW allowed_keys delimiter default_keyr multiple_keysZ process_keyrZout_dictZ multiple_argsZmobjrrrgkeyr+r+r,_dict_from_options_callbacks2 ($z2create_parser.._dict_from_options_callbackc s(idddttjt|ddddS)Nrcallback|FT)rrrr)r$typeactionrcallback_kwargs)r'rrescaperr#)rr+r, when_prefixsz"create_parser..when_prefixZAliasesc s6|\}}z4tddt|D}|jttt|Wn8tk rt}zt d|d|W5d}~XYnX|j kr| ddttj | dD}zPdd t|D}j|||j|rd ndd ||j|d ||d dWn:tk r0}zt d|d|W5d}~XYnXdS)NcSs0h|](\}\}}}}|dk r|dkr(|n|qS)NrEr+)rOrPrhfr+r+r,r#sz7create_parser.._create_alias..rz OPTIONS formatting; css&|]}|dr|nd|VqdS)rrN)r3)rOrr+r+r,rQ+sz7create_parser.._create_alias..rcSsg|]}d|qS)ZARGr+)rOrPr+r+r, -sz8create_parser.._create_alias..rrzr)rfnargs)rrrr~helprrrr)rr]parseformatrrrangerrTr option_groupsadd_option_grouprIr1 add_optionrr') rrrrWrrfrrgr@) Formatter_alias_callback alias_groupr+r, _create_alias s4 (    z$create_parser.._create_aliascSst|j|j}||d7<|||jkr>td|d|dkrL|g}|dkr\|dkslt||ksltt |dkr||n|j t tj ||j dd<dS)NrzAlias z exceeded invocation limitr)rrrrrTrrr2shlexr1rrquoter)rrrrWrfrcounterr+r+r,r5s z&create_parser.._alias_callbackzGeneral Optionsz-hz--helprM store_truezPrint this help text and exit)rrrz --versionrzPrint program version and exit)rrz-Uz--update store_constZ update_selfz"Check if updates are available. %sz"Update this program to the latest z versionr#)rrconstrz --no-update store_falsez"Do not check for updates (default))rrrz --update-tostorez[CHANNEL]@[TAG]zjUpgrade/downgrade to a specific version. CHANNEL can be a repository as well. CHANNEL and TAG default to "@rzV" and "latest" respectively if omitted; See "UPDATE" for details. Supported channels: rx)rrr~rz-iz--ignore-errorsZ ignoreerrorszvIgnore download and postprocessing errors. The download will be considered successful even if the postprocessing failsz--no-abort-on-errorZ only_downloadzdContinue with next video on download errors; e.g. to skip unavailable videos in a playlist (default)z--abort-on-errorz--no-ignore-errorszRAbort downloading of further videos if an error occurs (Alias: --no-ignore-errors)z--dump-user-agentZdump_user_agentz'Display the current user-agent and exit)rrr$rz--list-extractorsZlist_extractorsz&List all supported extractors and exitz--extractor-descriptionsZlist_extractor_descriptionsz8Output descriptions of all supported extractors and exitz--use-extractorsz--iesrZallowed_extractorsZNAMESra#Extractor names to use separated by commas. You can also use regexes, "all", "default" and "end" (end URL matching); e.g. --ies "holodex.*,end,youtube". Prefix the name with a "-" to exclude it, e.g. --ies default,-generic. Use --list-extractors for a list of extractor names. (Alias: --ies))rrr~rr$rrz--force-generic-extractorZforce_generic_extractorz--default-searchZdefault_searchPREFIXaqUse this prefix for unqualified URLs. E.g. "gvsearch2:python" downloads two videos from google videos for the search term "python". Use the value "auto" to let yt-dlp guess ("auto_warning" to emit a warning when guessing). "error" just throws an error. The default value "fixup_error" repairs broken URLs, but emits an error if this is not possible instead of searching)rr~rz--ignore-configz --no-configr;zDon't load any more configuration files except those given to --config-locations. For backward compatibility, if this option is found inside the system configuration file, the user configuration is not loaded. (Alias: --no-config)z--no-config-locationsZconfig_locationszDo not load any custom configuration files (default). When given inside a configuration file, ignore all previous --config-locations defined in the current filez--config-locationsPATHrzLocation of the main configuration file; either the path to the config or its containing directory ("-" for stdin). Can be used multiple times and inside other configuration files)rr~rrz --plugin-dirsZ plugin_dirsaPath to an additional directory to search for plugins. This option can be used multiple times to add multiple directories. Note that this currently only works for extractor plugins; postprocessor plugins can only be loaded from the default plugin directoriesz--flat-playlistZ extract_flatZ in_playlistz7Do not extract the videos of a playlist, only list them)rrrr$rz--no-flat-playlistz0Fully extract the videos of a playlist (default)z--live-from-startZlive_from_startzXDownload livestreams from the start. Currently only supported for YouTube (Experimental)z--no-live-from-startz4Download livestreams from the current time (default)z--wait-for-videoZwait_for_videoz MIN[-MAX]zuWait for scheduled streams to become available. Pass the minimum number of seconds (or range) to wait between retries)rr~r$rz--no-wait-for-videoz+Do not wait for scheduled streams (default))rrrrz--mark-watchedZ mark_watchedz*Mark videos watched (even with --simulate)z--no-mark-watchedz$Do not mark videos watched (default)z --no-colorsz --no-colourscolorno_color)stdoutstderrz--colorz[STREAM:]POLICYz stdout|stderrrr)rrra?Whether to emit color codes in output, optionally prefixed by the STREAM (stdout or stderr) to apply the setting to. Can be one of "always", "auto" (default), "never", or "no_color" (use non color terminal sequences). Use "auto-tty" or "no_color-tty" to decide based on terminal support only. Can be used multiple times)rr~r$rrrrrz--compat-optionsZOPTSZ compat_optsfilenamezfilename-sanitizationz format-sortzabort-on-errorz format-speczno-playlist-metafilesZ multistreamsz no-live-chatzplaylist-indexz list-formatszno-direct-mergezplaylist-match-filterzno-attach-info-jsonzembed-thumbnail-atomicparsleyzno-external-downloader-progresszembed-metadatazseperate-video-versionszno-clean-infojsonz no-keep-subsz no-certifizno-youtube-channel-redirectzno-youtube-unavailable-videosz!no-youtube-prefer-utc-upload-datezprefer-legacy-http-handlerzmanifest-filesize-approxzallow-unsafe-extrZz -multistreamsz-playlist-match-filterz-manifest-filesize-approxz-allow-unsafe-extz-no-youtube-channel-redirectz -no-live-chat20222023)z youtube-dlz youtube-dlcZ2021rr)rrzOptions that can help keep compatibility with youtube-dl or youtube-dlc configurations by reverting some of the changes made in yt-dlp. See "Differences in default behavior" for details)r~rr$rrrrrz--aliaszALIASES OPTIONSrhaDCreate aliases for an option string. Unless an alias starts with a dash "-", it is prefixed with "--". Arguments are parsed according to the Python string formatting mini-language. E.g. --alias get-audio,-X "-S=aext:{0},abr -x --audio-format {0}" creates options "--get-audio" and "-X" that takes an argument (ARG0) and expands to "-S=aext:ARG0,abr -x --audio-format ARG0". All defined aliases are listed in the --help output. Alias options can trigger more aliases; so be careful to avoid defining recursive options. As a safety measure, each alias may be triggered a maximum of z. times. This option can be used multiple times)r~rrrrrrzNetwork Optionsz--proxyproxyURLzUse the specified HTTP/HTTPS/SOCKS proxy. To enable SOCKS proxy, specify a proper scheme, e.g. socks5://user:pass@127.0.0.1:1080/. Pass in an empty string (--proxy "") for direct connection)rr$r~rz--socket-timeoutsocket_timeoutZSECONDSz)Time to wait before giving up, in seconds)rrr$r~rz--source-addressZIPsource_addressz!Client-side IP address to bind to)r~rr$rz --impersonatez CLIENT[:OS]Z impersonatezClient to impersonate for requests. E.g. chrome, chrome-110, chrome:windows-10. Pass --impersonate="" to impersonate any client. Note that forcing impersonation for all requests may have a detrimental impact on download speed and stabilityz--list-impersonate-targetsZlist_impersonate_targetsz&List available clients to impersonate.)rr$rrz-4z --force-ipv4z0.0.0.0zMake all connections via IPv4)rrrrz-6z --force-ipv6z::zMake all connections via IPv6z--enable-file-urlsZenable_file_urlszFEnable file:// URLs. This is disabled by default for security reasons.zGeo-restrictionz--geo-verification-proxyZgeo_verification_proxyzUse this proxy to verify the IP address for some geo-restricted sites. The default proxy specified by --proxy (or none, if the option is not present) is used for the actual downloadingz--cn-verification-proxyZcn_verification_proxyz--xffZVALUEZ geo_bypassr$zHow to fake X-Forwarded-For HTTP header to try bypassing geographic restriction. One of "default" (only when known to be useful), "never", an IP block in CIDR notation, or a two-letter ISO 3166-2 country codez --geo-bypassz--no-geo-bypassneverz--geo-bypass-countryZCODE)r~rrz--geo-bypass-ip-blockZIP_BLOCKzVideo Selectionz--playlist-startZ playliststartNUMBERr)rr~r$rrz--playlist-endZ playlistendz-Iz--playlist-itemsZplaylist_itemsZ ITEM_SPECalComma separated playlist_index of the items to download. You can specify a range using "[START]:[STOP][:STEP]". For backward compatibility, START-STOP is also supported. Use negative indices to count from the right and negative STEP to download in reverse order. E.g. "-I 1:3,7,-5::2" used on a playlist of size 15 will download the items at index 1,2,3,7,11,13,15z --match-titleZ matchtitleZREGEXz--reject-titleZ rejecttitlez--min-filesizeZSIZEZ min_filesizezBAbort download if filesize is smaller than SIZE, e.g. 50k or 44.6Mz--max-filesizeZ max_filesizezAAbort download if filesize is larger than SIZE, e.g. 50k or 44.6Mz--dateZDATEdatezDownload only videos uploaded on this date. The date can be "YYYYMMDD" or in the format [now|today|yesterday][-N[day|week|month|year]]. E.g. "--date today-2weeks" downloads only videos uploaded on the same day two weeks agoz --datebeforeZ datebeforezfDownload only videos uploaded on or before this date. The date formats accepted are the same as --datez --dateafterZ dateafterzeDownload only videos uploaded on or after this date. The date formats accepted are the same as --datez --min-viewsZCOUNTZ min_views)r~rr$rrz --max-viewsZ max_viewsz--match-filtersZFILTERZ match_filtera)Generic video filter. Any "OUTPUT TEMPLATE" field can be compared with a number or a string using the operators defined in "Filtering Formats". You can also simply specify a field to match if the field is present, use "!field" to check if the field is not present, and "&" to check multiple conditions. Use a "\" to escape "&" or quotes if needed. If used multiple times, the filter matches if at least one of the conditions is met. E.g. --match-filters !is_live --match-filters "like_count>?100 & description~='(?i)\bcats \& dogs\b'" matches only videos that are not live OR those that have a like count more than 100 (or the like field is not available) and also has a description that contains the phrase "cats & dogs" (caseless). Use "--match-filters -" to interactively ask whether to download each video)r~rrrz--no-match-filtersz(Do not use any --match-filters (default)z--break-match-filtersZbreaking_match_filterzQSame as "--match-filters" but stops the download process when a video is rejectedz--no-break-match-filtersz.Do not use any --break-match-filters (default)z --no-playlistZ noplaylistzDDownload only the video, if the URL refers to a video and a playlistz--yes-playlistzBDownload the playlist, if the URL refers to a video and a playlistz --age-limitZYEARSZ age_limitz/Download only videos suitable for the given agez--download-archiveFILEZdownload_archivezbDownload only videos not listed in the archive file. Record the IDs of all downloaded videos in itz--no-download-archivez!Do not use archive file (default)z--max-downloadsZ max_downloadsz$Abort after downloading NUMBER files)rr~rr$rz--break-on-existingZbreak_on_existingzIStop the download process when encountering a file that is in the archivez--no-break-on-existingzZDo not stop the download process when encountering a file that is in the archive (default)z--break-on-rejectZbreak_on_rejectz--break-per-inputZ break_per_urlziAlters --max-downloads, --break-on-existing, --break-match-filters, and autonumber to reset per input URLz--no-break-per-inputzL--break-on-existing and similar options terminates the entire download queuez--skip-playlist-after-errorsNZskip_playlist_after_errorszDNumber of allowed failures until the rest of the playlist is skippedz --include-adsZ include_adsz--no-include-adszAuthentication Optionsz-uz --usernameusernameUSERNAMEzLogin with this account IDz-pz --passwordpasswordZPASSWORDzKAccount password. If this option is left out, yt-dlp will ask interactivelyz-2z --twofactorZ twofactorZ TWOFACTORzTwo-factor authentication codez-nz--netrcZusenetrczUse .netrc authentication dataz--netrc-locationZnetrc_locationziLocation of .netrc authentication data; either the path or its containing directory. Defaults to ~/.netrcz --netrc-cmdZ netrc_cmdZ NETRC_CMDz;Command to execute to get the credentials for an extractor.z--video-passwordZ videopasswordzVideo-specific passwordz--ap-msoZap_msoZMSOzlAdobe Pass multiple-system operator (TV provider) identifier, use --ap-list-mso for a list of available MSOsz --ap-usernameZ ap_usernamez&Multiple-system operator account loginz --ap-passwordZ ap_passwordzdMultiple-system operator account password. If this option is left out, yt-dlp will ask interactivelyz --ap-list-msoZ ap_list_msoz,List all supported multiple-system operatorsz--client-certificateZclient_certificateZCERTFILEzJPath to client certificate file in PEM format. May include the private keyz--client-certificate-keyZclient_certificate_keyZKEYFILEz/Path to private key file for client certificatez--client-certificate-passwordZclient_certificate_passwordzPassword for client certificate private key, if encrypted. If not provided, and the key is encrypted, yt-dlp will ask interactivelyzVideo Format Optionsz-fz--formatrZFORMATz:Video format code, see "FORMAT SELECTION" for more details)rrr~r$rz-Sz --format-sortZ SORTORDERZ format_sortzLSort the formats by the fields given, see "Sorting Formats" for more detailsz--format-sort-forcez --S-forceZformat_sort_forcez}Force user specified sort order to have precedence over all fields, see "Sorting Formats" for more details (Alias: --S-force)z--no-format-sort-forcezHSome fields have precedence over the user specified sort order (default)z--video-multistreamsZallow_multiple_video_streamszDon't give any special preference to free containers (default)z--check-formatsselectedZ check_formatszMMake sure formats are selected only from those that are actually downloadable)rrrr$rz--check-all-formatszm4a/mov>mp4/mkv" will remux aac to m4a, mov to mp4 and anything else to mkvz--recode-videoZ recodevideoztRe-encode the video into another format if necessary. The syntax and supported formats are the same as --remux-videoz--postprocessor-argsz--ppaZpostprocessor_argsz \w+(?:\+\w+)?zdefault-compat)rrrraGive these arguments to the postprocessors. Specify the postprocessor/executable name and the arguments separated by a colon ":" to give the argument to the specified postprocessor/executable. Supported PP are: Merger, ModifyChapters, SplitChapters, ExtractAudio, VideoRemuxer, VideoConvertor, Metadata, EmbedSubtitle, EmbedThumbnail, SubtitlesConvertor, ThumbnailsConvertor, FixupStretched, FixupM4a, FixupM3u8, FixupTimestamp and FixupDuration. The supported executables are: AtomicParsley, FFmpeg and FFprobe. You can also specify "PP+EXE:ARGS" to give the arguments to the specified executable only when being used by the specified postprocessor. Additionally, for ffmpeg/ffprobe, "_i"/"_o" can be appended to the prefix optionally followed by a number to pass the argument before the specified input/output file, e.g. --ppa "Merger+ffmpeg_i1:-v quiet". You can use this option multiple times to give different arguments to different postprocessors. (Alias: --ppa)z-kz --keep-videoZ keepvideoz>Keep the intermediate video file on disk after post-processingz--no-keep-videozBDelete the intermediate video file after post-processing (default)z--post-overwritesZnopostoverwritesz(Overwrite post-processed files (default)z--no-post-overwritesz%Do not overwrite post-processed filesz --embed-subsZembedsubtitlesz@Embed subtitles in the video (only for mp4, webm and mkv videos)z--no-embed-subsz Do not embed subtitles (default)z--embed-thumbnailZembedthumbnailz)Embed thumbnail in the video as cover artz--no-embed-thumbnailz Do not embed thumbnail (default)z--embed-metadataz--add-metadataZ addmetadatazEmbed metadata to the video file. Also embeds chapters/infojson if present unless --no-embed-chapters/--no-embed-info-json are used (Alias: --add-metadata)z--no-embed-metadataz--no-add-metadataz@Do not add metadata to file (default) (Alias: --no-add-metadata)z--embed-chaptersz--add-chaptersZ addchaptersz=Add chapter markers to the video file (Alias: --add-chapters)z--no-embed-chaptersz--no-add-chaptersz?Do not add chapter markers (default) (Alias: --no-add-chapters)z--embed-info-jsonZembed_infojsonz:Embed the infojson as an attachment to mkv/mka video filesz--no-embed-info-jsonzConvert the subtitles to another format (currently supported: zY). Use "--convert-subs none" to disable conversion (default) (Alias: --convert-subtitles)z--convert-thumbnailsZconvertthumbnailsz?Convert the thumbnails to another format (currently supported: z). You can specify multiple rules using similar syntax as "--remux-video". Use "--convert-thumbnails none" to disable conversion (default)z--split-chaptersz--split-tracksZsplit_chapterszSplit video into multiple files based on internal chapters. The "chapter:" prefix can be used with "--paths" and "--output" to set the output filename for the split files. See "OUTPUT TEMPLATE" for detailsz--no-split-chaptersz--no-split-tracksz.Do not split video based on chapters (default)z--remove-chaptersZremove_chapterszRemove chapters whose title matches the given regular expression. The syntax is the same as --download-sections. This option can be used multiple timesz--no-remove-chaptersz2Do not remove any chapters from the file (default)z--force-keyframes-at-cutsZforce_keyframes_at_cutszForce keyframes at cuts when downloading/splitting/removing sections. This is slow due to needing a re-encode, but the resulting video may have fewer artifacts around the cutsz--no-force-keyframes-at-cutszKDo not force keyframes around the chapters when cutting/splitting (default)rEcSs,dd|r|dngDdt|dffS)Ncss|]}|ddVqdS=rNr1)rOitemr+r+r,rQs2create_parser....;rZPP)r1r)rrr+r+r,rs z--use-postprocessorz NAME[:ARGS]Zadd_postprocessorscst|ddS)Nrrrr1r)_postprocessor_opts_parserr+r,rr)ryraThe (case-sensitive) name of plugin postprocessors to be enabled, and (optionally) arguments to be passed to it, separated by a colon ":". ARGS are a semicolon ";" delimited list of NAME=VALUE. The "when" argument determines when the postprocessor is invoked. It can be one of "pre_process" (after video extraction), "after_filter" (after video passes filter), "video" (after --format; before --print/--output), "before_dl" (before each video download), "post_process" (after each video download; default), "after_move" (after moving the video file to its final location), "after_video" (after downloading and processing all formats of a video), or "playlist" (at end of playlist). This option can be used multiple times to add different postprocessorszSponsorBlock OptionszMake chapter entries for, or remove various segments (sponsor, introductions, etc.) from downloaded YouTube videos using the SponsorBlock API (https://sponsor.ajay.app)) descriptionz--sponsorblock-markZCATSZsponsorblock_markz^SponsorBlock categories to create chapters for, separated by commas. Available categories are z, all and default (=all). You can prefix the category with a "-" to exclude it. See [1] for descriptions of the categories. E.g. --sponsorblock-mark all,-preview [1] https://wiki.sponsor.ajay.app/w/Segment_Categories)r~rr$rrrrrz--sponsorblock-removeZsponsorblock_removez-filleraSponsorBlock categories to be removed from the video file, separated by commas. If a category is present in both mark and remove, remove takes precedence. The syntax and available categories are the same as for --sponsorblock-mark except that "default" refers to "all,-filler" and z are not availablez--sponsorblock-chapter-titleTEMPLATEZsponsorblock_chapter_titlezAn output template for the title of the SponsorBlock chapters created by --sponsorblock-mark. The only available fields are start_time, end_time, category, categories, name, category_names. Defaults to "%default")r~r$rrz--no-sponsorblockZno_sponsorblockz:Disable both --sponsorblock-mark and --sponsorblock-removez--sponsorblock-apizhttps://sponsor.ajay.appZsponsorblock_apiz/SponsorBlock API location, defaults to %defaultz --sponskrubZ sponskrubz--no-sponskrubz--sponskrub-cutZ sponskrub_cutz--no-sponskrub-cutz--sponskrub-forceZsponskrub_forcez--no-sponskrub-forcez--sponskrub-locationZsponskrub_pathz--sponskrub-argsZsponskrub_argsZARGSzExtractor Optionsz--extractor-retriesZextractor_retrieszQNumber of retries for known extractor errors (default is %default), or "infinite"z--allow-dynamic-mpdz--no-ignore-dynamic-mpdZ dynamic_mpdzIProcess dynamic DASH manifests (default) (Alias: --no-ignore-dynamic-mpd)z--ignore-dynamic-mpdz--no-allow-dynamic-mpdzEDo not process dynamic DASH manifests (Alias: --no-allow-dynamic-mpd)z--hls-split-discontinuityZhls_split_discontinuityzMSplit HLS playlists to different formats at discontinuities such as ad breaksz--no-hls-split-discontinuityz`Do not split HLS playlists into different formats at discontinuities such as ad breaks (default)cSs*|ddddtd|DfS)NrrhcSsg|]}|ddqS)z\,r)rVrI)rOrr+r+r,rlsz3create_parser....z(?rr,rSs                  .                          rScCstdtdt|S)Nrzz._hide_login_info" is deprecated and may be removed in a future version. Use "yt_dlp.utils.Config.hide_login_info" instead)rrrZhide_login_info)rfr+r+r,_hide_login_infosrP)Nr!)7rrarTos.pathr%rrrnrErXcompatrcookiesrrZdownloader.externalrZ postprocessorrrr r r r Zpostprocessor.modify_chaptersr updaterrrutilsrrrrrrrrrrrrrrrrr riIndentedHelpFormatterrj OptionParserrrSrPr+r+r+r,sD    @ [BP