Uso: yt-dlp [OPES] URL [URL...]

Opes:

Opes gerais:
-h, --help  Exibe este texto de ajuda e sai.
--version  Exibe a verso do programa e sai.
-U, --update  Atualiza o programa para a verso estvel mais recente.
--no-update  No verifica atualizaes (padro).
--update-to [CANAL]@[TAG]  Atualiza ou rebaixa para uma verso especfica.
CANAL pode ser tambm um repositrio. CANAL e TAG assumem "stable" e "latest" por padro, respectivamente, quando omitidos. Consulte "UPDATE" para detalhes. Canais suportados: stable, nightly, master.
-i, --ignore-errors  Ignora erros de download e ps-processamento. O download ser considerado bem-sucedido mesmo que o ps-processamento falhe.
--no-abort-on-error  Continua com o prximo vdeo quando ocorrerem erros de download; por exemplo, para ignorar vdeos indisponveis em uma playlist (padro).
--abort-on-error  Interrompe o download dos prximos vdeos se ocorrer um erro (apelido: --no-ignore-errors).
--list-extractors  Lista todos os extratores suportados e sai.
--extractor-descriptions  Exibe as descries de todos os extratores suportados.
--use-extractors NAMES  Nomes dos extratores a serem usados, separados por vrgulas. Tambm aceita expresses regulares, "all", "default" e "end" (correspondncia no final da URL); por exemplo, --ies "holodex.*,end,youtube". Prefixe o nome com "-" para exclu-lo; por exemplo, --ies default,-generic. Use --list-extractors para obter a lista de nomes de extratores. (Apelido: --ies)
--default-search PREFIX  Usa este prefixo para URLs no qualificadas. Por exemplo, "gvsearch2:python" baixa dois vdeos do Google Videos para o termo de pesquisa "python". Use o valor "auto" para permitir que o yt-dlp tente adivinhar ("auto_warning" para emitir um aviso ao adivinhar). "error" simplesmente gera um erro. O padro "fixup_error" corrige URLs quebradas, mas gera um erro se isso no for possvel, em vez de realizar uma pesquisa.
--ignore-config  No carrega mais arquivos de configurao, exceto os especificados por --config-locations. Para compatibilidade retroativa, se esta opo estiver no arquivo de configurao do sistema, a configurao do usurio no ser carregada.
--no-config-locations  No utiliza arquivos de configurao personalizados (padro). Quando usada dentro de um arquivo de configurao, ignora todas as opes --config-locations definidas anteriormente no arquivo atual.
--config-locations PATH  Caminho do arquivo de configurao principal; pode ser o caminho do arquivo ou o diretrio que o contm ("-" para stdin). Pode ser usada vrias vezes e dentro de outros arquivos de configurao.
--plugin-dirs DIR  Caminho para um diretrio adicional onde procurar plugins. Pode ser usada vrias vezes para adicionar diferentes diretrios. Use "default" para procurar nos diretrios padro (padro).
--no-plugin-dirs  Limpa os diretrios de plugins a serem pesquisados, incluindo os padres e os fornecidos anteriormente por --plugin-dirs.
--js-runtimes RUNTIME[:PATH]  Runtime JavaScript adicional a ser habilitado, com um caminho opcional para o runtime (caminho para o executvel ou diretrio que o contm). Pode ser usada vrias vezes para habilitar diferentes runtimes. Os runtimes suportados so, em ordem de prioridade: deno, node, quickjs, bun. Somente "deno"  habilitado por padro. Ser usado o runtime de maior prioridade que esteja habilitado e disponvel. Para usar um runtime de prioridade inferior quando o deno estiver disponvel, --no-js-runtimes precisa ser passado antes de habilitar os outros runtimes.
--no-js-runtimes  Limpa os runtimes JavaScript habilitados, incluindo os padres e os fornecidos anteriormente por --js-runtimes.
--remote-components COMPONENT  Componentes remotos que o yt-dlp pode buscar quando necessrio. Atualmente no so necessrios quando se utiliza um executvel oficial ou quando o pacote yt-dlp-ejs na verso necessria est instalado. Pode-se usar esta opo vrias vezes para permitir diferentes componentes. Valores suportados: ejs:npm (componentes JavaScript externos do npm), ejs:github (componentes JavaScript externos do GitHub do yt-dlp-ejs). Por padro, nenhum componente remoto  permitido.
--no-remote-components  Impede a obteno de todos os componentes remotos, incluindo os anteriormente permitidos por --remote-components ou pelos padres.
--flat-playlist  No extrai as URLs dos itens de uma playlist; alguns metadados dos itens podem ficar ausentes e o download pode ser ignorado.
--no-flat-playlist  Extrai completamente os vdeos de uma playlist (padro).
--live-from-start  Baixa transmisses ao vivo desde o incio. Atualmente experimental e suportado somente para YouTube, Twitch e TVer.
--no-live-from-start  Baixa transmisses ao vivo a partir do momento atual (padro).
--wait-for-video MIN[-MAX]  Aguarda transmisses agendadas ficarem disponveis. Informa o nmero mnimo de segundos (ou um intervalo) a aguardar entre as tentativas.
--no-wait-for-video  No aguarda transmisses agendadas (padro).
--mark-watched  Marca os vdeos como assistidos (mesmo com --simulate).
--no-mark-watched  No marca os vdeos como assistidos (padro).
--color [STREAM:]POLICY  Define se cdigos de cores sero emitidos na sada, opcionalmente precedidos pelo STREAM (stdout ou stderr) ao qual a configurao ser aplicada. Pode ser "always", "auto" (padro), "never" ou "no_color". Tambm aceita "auto-tty" ou "no_color-tty" para decidir com base apenas no suporte do terminal. Pode ser usada vrias vezes.
--compat-options OPTS  Opes que ajudam na compatibilidade com youtube-dl ou youtube-dlc, revertendo algumas alteraes feitas no yt-dlp. Consulte "Differences in default behavior" para detalhes.
--alias ALIASES OPTIONS  Cria apelidos para uma opo. A menos que um apelido comece com um hfen, " --" ser acrescentado. Os argumentos so interpretados de acordo com a mini-linguagem de formatao de strings do Python. Por exemplo, --alias get-audio,-X "-S aext:{0},abr -x --audio-format {0}" cria as opes "--get-audio" e "-X", que aceitam um argumento e expandem para "--get-audio" ou "-X" com ARG0. Todos os apelidos definidos aparecem na sada de ajuda. As opes de apelido podem acionar outros apelidos; portanto, cuidado para no definir opes recursivas. Como medida de segurana, cada apelido pode ser acionado no mximo 100 vezes. Esta opo pode ser usada vrias vezes.
-t, --preset-alias PRESET  Aplica um conjunto predefinido de opes. Por exemplo, --preset-alias mp3. Os presets disponveis so: mp3, aac, mp4, mkv, sleep. Consulte a seo "Apelidos de preset" no final para mais informaes. Pode ser usada vrias vezes.

Opes de rede:
--proxy URL  Usa o proxy HTTP/HTTPS/SOCKS especificado. Para habilitar SOCKS, informe um esquema apropriado, como socks5://user:pass@127.0.0.1:1080/. Passe uma string vazia (--proxy "") para uma conexo direta.
--socket-timeout SECONDS  Tempo, em segundos, a aguardar antes de desistir.
--source-address IP  Endereo IP do cliente ao qual vincular.
--impersonate CLIENT[:OS]  Faz as requisies se passarem por um cliente especfico. Por exemplo, chrome, chrome-110, chrome:windows-10. Passe --impersonate="" para imitar qualquer cliente. Observe que forar a imitao em todas as requisies pode prejudicar a velocidade e a estabilidade do download.
--list-impersonate-targets  Lista os clientes disponveis para imitao.
-4, --force-ipv4  Faz todas as conexes por IPv4.
-6, --force-ipv6  Faz todas as conexes por IPv6.
--enable-file-urls  Habilita URLs file://. Isso fica desabilitado por padro por motivos de segurana.

Restrio geogrfica:
--geo-verification-proxy URL  Usa este proxy para verificar o endereo IP para alguns sites com restrio geogrfica. O proxy padro especificado por --proxy (ou nenhum, se a opo no estiver presente)  usado para o download propriamente dito.
--xff VALUE  Define como falsificar o cabealho HTTP X-Forwarded-For para tentar contornar restries geogrficas. Pode ser "default" (somente quando se sabe que  til), "never", um bloco IP em notao CIDR ou um cdigo de pas ISO 3166-2 de duas letras.

Seleo de vdeos:
-I, --playlist-items ITEM_SPEC  ndices dos itens da playlist a serem baixados, separados por vrgulas. Pode-se especificar um intervalo usando "[START]:[STOP][:STEP]". Para compatibilidade retroativa, START-STOP tambm  aceito. ndices negativos contam a partir da direita e STEP negativo percorre a lista na ordem inversa. Por exemplo, "-I 1:3,7,-5::2", em uma playlist com 15 itens, baixa os itens nos ndices 1,2,3,7,11,13,15.
--min-filesize SIZE  Interrompe o download se o tamanho do arquivo for menor que SIZE; por exemplo, 50k ou 44.6M.
--max-filesize SIZE  Interrompe o download se o tamanho do arquivo for maior que SIZE; por exemplo, 50k ou 44.6M.
--date DATE  Baixa somente vdeos enviados nesta data. A data pode ser "AAAAMMDD" ou no formato [now|today|yesterday]-N[day|week|month|year]. Por exemplo, "--date today-2weeks" baixa somente vdeos enviados no mesmo dia de duas semanas atrs.
--datebefore DATE  Baixa somente vdeos enviados nesta data ou antes dela. Os formatos de data aceitos so os mesmos de --date.
--dateafter DATE  Baixa somente vdeos enviados nesta data ou depois dela. Os formatos de data aceitos so os mesmos de --date.
--match-filters FILTER  Filtro genrico de vdeos. Qualquer campo de "OUTPUT TEMPLATE" pode ser comparado com um nmero ou string usando os operadores definidos em "Filtering Formats". Tambm  possvel simplesmente especificar um campo para verificar se ele est presente, usar "!field" para verificar se ele no est presente e "&" para verificar mltiplas condies. Se usado vrias vezes, o filtro corresponde quando pelo menos uma das condies for satisfeita. Por exemplo, --match-filters !is_live --match-filters "like_count>?100 & description~='(?i)\bcats & dogs\b'" corresponde somente a vdeos que no so ao vivo OU que tenham mais de 100 curtidas (ou cujo campo de curtidas no esteja disponvel) e tambm tenham uma descrio contendo a expresso "cats & dogs", sem distino entre maisculas e minsculas. Use "--match-filters -" para perguntar interativamente se cada vdeo deve ser baixado.
--no-match-filters  No usa nenhum --match-filters (padro).
--break-match-filters FILTER  Igual a --match-filters, mas interrompe o processo de download quando um vdeo  rejeitado.
--no-break-match-filters  No usa nenhum --break-match-filters (padro).
--no-playlist  Baixa somente o vdeo quando a URL se refere a um vdeo e a uma playlist.
--yes-playlist  Baixa a playlist quando a URL se refere a um vdeo e a uma playlist.
--age-limit YEARS  Baixa somente vdeos adequados para a idade informada.
--download-archive FILE  Baixa somente vdeos que no estejam listados no arquivo de histrico. Registra nele os IDs de todos os vdeos baixados.
--no-download-archive  No usa arquivo de histrico (padro).
--max-downloads NUMBER  Interrompe aps baixar NUMBER arquivos.
--break-on-existing  Interrompe o processo ao encontrar um arquivo que esteja no arquivo de histrico fornecido com --download-archive.
--no-break-on-existing  No interrompe ao encontrar um arquivo que esteja no arquivo de histrico (padro).
--break-per-input  Faz com que --max-downloads, --break-on-existing, --break-match-filters e a numerao automtica sejam reiniciados para cada URL de entrada.
--no-break-per-input  --break-on-existing e opes semelhantes encerram toda a fila de downloads.
--skip-playlist-after-errors N  Nmero de falhas permitidas antes que o restante da playlist seja ignorado.

Opes de download:
-N, --concurrent-fragments N  Nmero de fragmentos de um vdeo DASH/HLS que devem ser baixados simultaneamente (padro: 1).
-r, --limit-rate RATE  Taxa mxima de download em bytes por segundo; por exemplo, 50K ou 4.2M.
--throttled-rate RATE  Taxa mnima de download abaixo da qual se considera que h limitao de velocidade e os dados do vdeo so extrados novamente; por exemplo, 100K.
-R, --retries RETRIES  Nmero de tentativas (padro: 10) ou "infinite".
--file-access-retries RETRIES  Nmero de tentativas em caso de erro de acesso ao arquivo (padro: 3) ou "infinite".
--fragment-retries RETRIES  Nmero de tentativas por fragmento (padro: 10) ou "infinite" (DASH, HLS nativo e ISM).
--retry-sleep [TYPE:]EXPR  Tempo de espera entre tentativas em segundos, opcionalmente precedido pelo tipo de tentativa (http, fragment, file_access, extractor). EXPR pode ser um nmero, linear=START[:END] ou exp=START[:END]. Pode ser usada vrias vezes para definir diferentes tipos de tentativa. Por exemplo, --retry-sleep linear=1::2 --retry-sleep fragment:exp=1:20.
--skip-unavailable-fragments  Ignora fragmentos indisponveis em downloads DASH, HLS nativo e ISM (padro). (Apelido: --no-abort-on-unavailable-fragments)
--abort-on-unavailable-fragments  Interrompe o download se um fragmento estiver indisponvel. (Apelido: --no-skip-unavailable-fragments)
--keep-fragments  Mantm os fragmentos baixados no disco aps o trmino do download.
--no-keep-fragments  Exclui os fragmentos baixados aps o trmino do download (padro).
--buffer-size SIZE  Tamanho do buffer de download; por exemplo, 1024 ou 16K (padro: 1024).
--resize-buffer  O tamanho do buffer  redimensionado automaticamente a partir do valor inicial de --buffer-size (padro).
--no-resize-buffer  No ajusta automaticamente o buffer.
--http-chunk-size SIZE  Tamanho de um bloco para downloads HTTP baseados em blocos; por exemplo, 10485760 ou 10M (padro: desabilitado). Pode ser til para contornar limitao de banda imposta por um servidor web (experimental).
--playlist-random  Baixa os vdeos da playlist em ordem aleatria.
--lazy-playlist  Processa as entradas da playlist conforme so recebidas. Desabilita n_entries, --playlist-random e --playlist-reverse.
--no-lazy-playlist  Processa os vdeos da playlist somente depois que toda a playlist tiver sido analisada (padro).
--hls-use-mpegts  Usa o continer MPEG-TS para vdeos HLS, permitindo que alguns players reproduzam o vdeo enquanto ele est sendo baixado e reduzindo a possibilidade de corrupo do arquivo caso o download seja interrompido.  habilitado por padro para transmisses ao vivo.
--no-hls-use-mpegts  No usa o continer MPEG-TS para vdeos HLS. Este  o padro quando no se baixam transmisses ao vivo.
--download-sections REGEX  Baixa somente captulos que correspondam  expresso regular. Um prefixo "*" indica um intervalo de tempo em vez de um captulo. Marcas de tempo negativas so calculadas a partir do final. "*from-url" pode ser usado para baixar entre start_time e end_time extrados da URL. Requer ffmpeg. Pode ser usada vrias vezes para baixar vrias sees; por exemplo, --download-sections "*10:15-inf" --download-sections "intro".
--downloader [PROTO:]NAME  Nome ou caminho do downloader externo a ser usado, opcionalmente precedido pelos protocolos aos quais ele se aplica (http, ftp, m3u8, dash, rstp, rtmp, mms). Atualmente suporta native, aria2c, axel, curl, ffmpeg, httpie e wget. Pode ser usada vrias vezes para definir diferentes downloaders para diferentes protocolos. Por exemplo, --downloader aria2c --downloader "dash,m3u8:native" usa aria2c para downloads HTTP/FTP e o downloader nativo para DASH/M3U8. (Apelido: --external-downloader)
--downloader-args NAME:ARGS  Fornece argumentos ao downloader externo. Especifique o nome do downloader e os argumentos separados por dois-pontos ":". Para ffmpeg, argumentos podem ser passados para diferentes posies usando a mesma sintaxe de --postprocessor-args. Pode ser usada vrias vezes para fornecer argumentos a diferentes downloaders. (Apelido: --external-downloader-args)

Opes do sistema de arquivos:
-a, --batch-file FILE  Arquivo contendo URLs para baixar ("-" para stdin), uma URL por linha. Linhas iniciadas por "#", ";" ou "]" so consideradas comentrios e ignoradas.
--no-batch-file  No l URLs de um arquivo em lote (padro).
-P, --paths [TYPES:]PATH  Caminhos nos quais os arquivos devem ser baixados. Especifique o tipo de arquivo e o caminho separados por ":". Todos os mesmos TYPES de --output so suportados. Alm disso, pode-se usar "home" (padro) e "temp". Todos os arquivos intermedirios so primeiro baixados para o caminho temporrio e, depois, os arquivos finais so movidos para o caminho principal aps o trmino do download. Esta opo  ignorada quando --output  um caminho absoluto.
-o, --output [TYPES:]TEMPLATE  Modelo de nome de arquivo de sada; consulte "OUTPUT TEMPLATE" para detalhes.
--output-na-placeholder TEXT  Texto usado como substituto para campos indisponveis em --output (padro: "NA").
--restrict-filenames  Restringe os nomes de arquivos ao ASCII e evita "&" e espaos nos nomes.
--no-restrict-filenames  Permite caracteres Unicode, "&" e espaos nos nomes (padro).
--windows-filenames  Fora nomes de arquivos compatveis com Windows.
--no-windows-filenames  Sanitiza os nomes de arquivos apenas minimamente.
--trim-filenames LENGTH  Limita o tamanho do nome do arquivo, sem a extenso, ao nmero especificado de caracteres.
-w, --no-overwrites  No sobrescreve arquivos.
--force-overwrites  Sobrescreve todos os arquivos de vdeo e metadados. Inclui --no-continue.
--no-force-overwrites  No sobrescreve o vdeo, mas sobrescreve arquivos relacionados (padro).
-c, --continue  Retoma arquivos ou fragmentos parcialmente baixados (padro).
--no-continue  No retoma fragmentos parcialmente baixados. Se o arquivo no for fragmentado, reinicia o download inteiro.
--part  Usa arquivos .part em vez de gravar diretamente no arquivo de sada (padro).
--no-part  No usa arquivos .part; grava diretamente no arquivo de sada.
--mtime  Usa o cabealho Last-modified para definir a data de modificao do arquivo.
--no-mtime  No usa o cabealho Last-modified para definir a data de modificao (padro).
--write-description  Grava a descrio do vdeo em um arquivo .description.
--no-write-description  No grava a descrio do vdeo (padro).
--write-info-json  Grava os metadados do vdeo em um arquivo .info.json (isso pode conter informaes pessoais).
--no-write-info-json  No grava os metadados do vdeo (padro).
--write-playlist-metafiles  Grava metadados da playlist alm dos metadados do vdeo quando --write-info-json, --write-description etc. so usados (padro).
--no-write-playlist-metafiles  No grava metadados da playlist quando --write-info-json, --write-description etc. so usados.
--clean-info-json  Remove alguns metadados internos, como nomes de arquivos, do infojson (padro).
--no-clean-info-json  Grava todos os campos no infojson.
--write-comments  Obtm os comentrios do vdeo para coloc-los no infojson. Os comentrios so obtidos mesmo sem esta opo quando se sabe que a extrao  rpida (apelido: --get-comments).
--no-write-comments  No obtm comentrios, a menos que se saiba que a extrao  rpida (apelido: --no-get-comments).
--load-info-json FILE  Arquivo JSON contendo as informaes do vdeo (criado com a opo --write-info-json).
--cookies FILE  Arquivo em formato Netscape do qual os cookies so lidos e para o qual o cookie jar  gravado.
--no-cookies  No l nem grava cookies em arquivo (padro).
--cookies-from-browser BROWSER[+KEYRING][:PROFILE][::CONTAINER]  Nome do navegador do qual os cookies devem ser carregados. Atualmente so suportados: brave, chrome, chromium, edge, firefox, opera, safari, vivaldi, whale. Opcionalmente, pode-se informar o KEYRING usado para descriptografar cookies do Chromium no Linux, o nome/caminho do PROFILE a ser carregado e o nome do CONTAINER (se for Firefox), usando seus respectivos separadores. Por padro, todos os containers do perfil acessado mais recentemente so usados. Keyrings suportados: basictext, gnomekeyring, kwallet, kwallet5, kwallet6.
--no-cookies-from-browser  No carrega cookies do navegador (padro).
--cache-dir DIR  Local no sistema de arquivos onde o yt-dlp pode armazenar permanentemente algumas informaes baixadas, como IDs de cliente e assinaturas. Por padro: ${XDG_CACHE_HOME}/yt-dlp.
--no-cache-dir  Desabilita o cache no sistema de arquivos.
--rm-cache-dir  Exclui todos os arquivos do cache.

Opes de miniaturas:
--write-thumbnail  Grava a imagem da miniatura no disco.
--no-write-thumbnail  No grava a miniatura no disco (padro).
--write-all-thumbnails  Grava no disco todos os formatos de miniatura.
--list-thumbnails  Lista as miniaturas disponveis de cada vdeo. Simula a operao, a menos que --no-simulate seja usado.

Atalhos da Internet:
--write-link  Grava um arquivo de atalho da Internet, dependendo da plataforma atual (.url, .webloc ou .desktop). A URL pode ser armazenada em cache pelo sistema operacional.
--write-url-link  Grava um atalho .url do Windows. O sistema operacional armazena a URL em cache com base no caminho do arquivo.
--write-webloc-link  Grava um atalho .webloc do macOS.
--write-desktop-link  Grava um atalho .desktop do Linux.

Opes de verbosidade e simulao:
-q, --quiet  Ativa o modo silencioso. Quando usado com --verbose, imprime o log em stderr.
--no-quiet  Desativa o modo silencioso (padro).
--no-warnings  Ignora avisos.
-s, --simulate  No baixa o vdeo nem grava nada no disco.
--no-simulate  Baixa o vdeo mesmo quando opes de impresso/listagem so usadas.
--ignore-no-formats-error  Ignora o erro "Sem formatos de vdeo". til para extrair metadados mesmo quando os vdeos no esto realmente disponveis para download (experimental). 
--no-ignore-no-formats-error  Gera um erro quando nenhum formato de vdeo para download  encontrado (padro).
--skip-download  No baixa o vdeo, mas grava todos os arquivos relacionados (apelido: --no-download).
-O, --print [WHEN:]TEMPLATE  Nome do campo ou modelo de sada a ser impresso na tela, opcionalmente precedido por WHEN, separado por ":". Os valores aceitos de WHEN so os mesmos de --use-postprocessor (padro: video). Implica --quiet. Implica --simulate, a menos que --no-simulate ou estgios posteriores de WHEN sejam usados. Pode ser usada vrias vezes.
--print-to-file [WHEN:]TEMPLATE FILE  Acrescenta o modelo fornecido ao arquivo. Os valores de WHEN e TEMPLATE so os mesmos de --print. FILE usa a mesma sintaxe do modelo de sada. Pode ser usada vrias vezes.
-j, --dump-json  Silenciosamente imprime informaes JSON de cada vdeo. Simula, a menos que --no-simulate seja usado. Consulte "OUTPUT TEMPLATE" para a descrio das chaves disponveis.
-J, --dump-single-json  Silenciosamente imprime informaes JSON para cada URL ou infojson fornecido. Simula, a menos que --no-simulate seja usado. Se a URL se referir a uma playlist, todas as informaes da playlist sero exibidas em uma nica linha.
--force-write-archive  Fora a gravao das entradas no arquivo de histrico, desde que no ocorram erros, mesmo quando -s ou outra opo de simulao estiver sendo usada (apelido: --force-download-archive).
--newline  Exibe a barra de progresso como novas linhas.
--no-progress  No exibe a barra de progresso.
--progress  Exibe a barra de progresso, mesmo no modo silencioso.
--console-title  Exibe o progresso na barra de ttulo do console.
--progress-template [TYPES:]TEMPLATE  Modelo para as informaes de progresso, opcionalmente precedido por um dos seguintes tipos: "download:" (padro), "download-title:" (ttulo do console), "postprocess:" ou "postprocess-title:". Os campos do vdeo ficam disponveis na chave "info" e os atributos de progresso na chave "progress". Por exemplo, --console-title --progress-template "download-title:%(info.id)s-%(progress.eta)s".
--progress-delta SECONDS  Tempo, em segundos, entre as atualizaes da sada de progresso (padro: 0).
-v, --verbose  Exibe diversas informaes de depurao.
--dump-pages  Exibe as pginas baixadas codificadas em base64 para depurao (muito detalhado).
--write-pages  Grava as pginas intermedirias baixadas em arquivos no diretrio atual para depurao.
--print-traffic  Exibe o trfego HTTP enviado e recebido.

Solues alternativas:
--encoding ENCODING  Fora a codificao especificada (experimental).
--legacy-server-connect  Permite explicitamente conexes HTTPS com servidores que no suportam renegociao segura RFC 5746.
--no-check-certificates  Suprime a validao de certificados HTTPS.
--prefer-insecure  Prefere uma conexo no criptografada para obter informaes sobre o vdeo.
--add-headers FIELD:VALUE  Especifica um cabealho HTTP personalizado e seu valor, separados por ":". Pode ser usada vrias vezes.
--bidi-workaround  Corrige problemas em terminais que no tm suporte a texto bidirecional. Requer o executvel bidiv ou fribidi no PATH.
--sleep-requests SECONDS  Nmero de segundos de espera entre requisies durante a extrao.
--sleep-interval SECONDS  Nmero de segundos de espera antes de cada download.  o tempo mnimo de espera quando usado junto com --max-sleep-interval (apelido: --min-sleep-interval).
--max-sleep-interval SECONDS  Tempo mximo de espera. S pode ser usado junto com --min-sleep-interval.
--sleep-subtitles SECONDS  Nmero de segundos de espera antes de cada download de legenda.

Opes de formato de vdeo:
-f, --format FORMAT  Cdigo do formato de vdeo; consulte "FORMAT SELECTION" para mais detalhes.
-S, --format-sort SORTORDER  Ordena os formatos pelos campos fornecidos; consulte "Sorting Formats" para mais detalhes.
--format-sort-reset  Desconsidera a ordem de classificao especificada anteriormente pelo usurio e restaura a padro.
--format-sort-force  Fora a ordem de classificao especificada pelo usurio a ter precedncia sobre todos os campos (apelido: --S-force).
--no-format-sort-force  Alguns campos tm precedncia sobre a ordem de classificao especificada pelo usurio (padro).
--video-multistreams  Permite que mltiplos fluxos de vdeo sejam combinados em um nico arquivo.
--no-video-multistreams  Baixa somente um fluxo de vdeo para cada arquivo de sada (padro).
--audio-multistreams  Permite que mltiplos fluxos de udio sejam combinados em um nico arquivo.
--no-audio-multistreams  Baixa somente um fluxo de udio para cada arquivo de sada (padro).
--prefer-free-formats  D preferncia a formatos de vdeo com contineres livres em relao aos no livres da mesma qualidade. Use com "-S ext" para dar preferncia estrita a contineres livres independentemente da qualidade.
--no-prefer-free-formats  No d preferncia especial a contineres livres (padro).
--check-formats  Garante que os formatos selecionados estejam somente entre aqueles que podem realmente ser baixados.
--check-all-formats  Verifica todos os formatos para determinar se podem realmente ser baixados.
--no-check-formats  No verifica se os formatos podem realmente ser baixados.
-F, --list-formats  Lista os formatos disponveis de cada vdeo. Simula, a menos que --no-simulate seja usado.
--merge-output-format FORMAT  Contineres que podem ser usados ao combinar formatos, separados por "/"; por exemplo, avi/flv/mkv/mov/mp4/webm.  ignorado quando no  necessria uma combinao. Atualmente suportados: avi, flv, mkv, mov, mp4, webm.

Opes de legendas:
--write-subs  Grava o arquivo de legenda.
--no-write-subs  No grava arquivo de legenda (padro).
--write-auto-subs  Grava legendas geradas automaticamente (apelido: --write-automatic-subs).
--no-write-auto-subs  No grava legendas geradas automaticamente (padro; apelido: --no-write-automatic-subs).
--list-subs  Lista as legendas disponveis de cada vdeo. Simula, a menos que --no-simulate seja usado.
--sub-format FORMAT  Formato das legendas; aceita preferncias separadas por "/", por exemplo, "srt" ou "ass/srt/best".
--sub-langs LANGS  Idiomas das legendas a serem baixadas (pode ser uma expresso regular) ou "all", separados por vrgulas; por exemplo, --sub-langs "en.*,ja". Pode-se prefixar o cdigo do idioma com "-" para exclu-lo; por exemplo, --sub-langs all,-live_chat. Use --list-subs para obter a lista de identificadores de idioma disponveis.

Opes de autenticao:
-u, --username USERNAME  Faz login usando este identificador de conta.
-p, --password PASSWORD  Senha da conta. Se esta opo for omitida, o yt-dlp solicitar a senha interativamente.
-2, --twofactor TWOFACTOR  Cdigo de autenticao de dois fatores.
-n, --netrc  Usa os dados de autenticao do .netrc.
--netrc-location PATH  Localizao dos dados de autenticao do .netrc; pode ser o caminho ou o diretrio que o contm. O padro  ~/.netrc.
--netrc-cmd NETRC_CMD  Comando a executar para obter as credenciais de um extrator.
--video-password PASSWORD  Senha especfica do vdeo.
--ap-mso MSO  Identificador do provedor de televiso do Adobe Pass; use --ap-list-mso para obter a lista de MSOs suportados.
--ap-username USERNAME  Login da conta do provedor de televiso.
--ap-password PASSWORD  Senha da conta do provedor de televiso. Se esta opo for omitida, o yt-dlp solicitar a senha interativamente.
--ap-list-mso  Lista todos os provedores de televiso suportados.
--client-certificate CERTFILE  Caminho para um certificado de cliente em formato PEM. Pode incluir a chave privada.
--client-certificate-key KEYFILE  Caminho para a chave privada do certificado de cliente.
--client-certificate-password PASSWORD  Senha da chave privada do certificado de cliente, caso esteja criptografada. Se no for fornecida e a chave estiver criptografada, o yt-dlp solicitar a senha interativamente.

Opes de ps-processamento:
-x, --extract-audio  Converte arquivos de vdeo para arquivos somente de udio (requer ffmpeg e ffprobe).
--audio-format FORMAT  Formato para o qual converter o udio quando -x for usado. Atualmente suportados: best (padro), aac, alac, flac, m4a, mp3, opus, vorbis, wav. Pode-se especificar vrias regras usando uma sintaxe semelhante  de --remux-video.
--audio-quality QUALITY  Especifica a qualidade de udio do ffmpeg usada na converso com -x. Informe um valor entre 0 (melhor) e 10 (pior) para VBR ou uma taxa de bits especfica, como 128K (padro: 5).
--remux-video FORMAT  Remultiplexa o vdeo para outro continer, se necessrio. Atualmente suportados: avi, flv, gif, mkv, mov, mp4, webm, aac, aiff, alac, flac, m4a, mka, mp3, ogg, opus, vorbis, wav. Se o continer de destino no suportar o codec de vdeo/udio, a remultiplexao falhar. Pode-se especificar vrias regras; por exemplo, "aac>m4a/mov>mp4/mkv" remultiplexa aac para m4a, mov para mp4 e qualquer outra coisa para mkv.
--recode-video FORMAT  Recodifica o vdeo para outro formato, se necessrio. A sintaxe e os formatos suportados so os mesmos de --remux-video.
--postprocessor-args NAME:ARGS  Fornece argumentos aos ps-processadores. Especifique o nome do ps-processador/executvel e os argumentos separados por ":". Os ps-processadores suportados so: Merger, ModifyChapters, SplitChapters, ExtractAudio, VideoRemuxer, VideoConvertor, Metadata, EmbedSubtitle, EmbedThumbnail, SubtitlesConvertor, ThumbnailsConvertor, FixupStretched, FixupM4a, FixupM3u8, FixupTimestamp e FixupDuration. Os executveis suportados so AtomicParsley, FFmpeg e FFprobe. Tambm  possvel usar "PP+EXE:ARGS" para passar argumentos ao executvel especificado somente quando o ps-processador correspondente estiver sendo usado. Para ffmpeg/ffprobe, "_i"/"_o" pode ser acrescentado ao prefixo, opcionalmente seguido por um nmero, para passar o argumento antes do arquivo de entrada/sada especificado. Por exemplo, --ppa "Merger+ffmpeg_i1:-v quiet". Pode ser usada vrias vezes para fornecer argumentos a diferentes ps-processadores.
-k, --keep-video  Mantm o arquivo de vdeo intermedirio no disco aps o ps-processamento.
--no-keep-video  Exclui o arquivo de vdeo intermedirio aps o ps-processamento (padro).
--post-overwrites  Sobrescreve arquivos ps-processados (padro).
--no-post-overwrites  No sobrescreve arquivos ps-processados.
--embed-subs  Incorpora legendas no vdeo (somente para vdeos MP4, WebM e MKV).
--no-embed-subs  No incorpora legendas (padro).
--embed-thumbnail  Incorpora a miniatura no vdeo como arte da capa.
--no-embed-thumbnail  No incorpora a miniatura (padro).
--embed-metadata  Incorpora metadados no arquivo de vdeo. Tambm incorpora captulos/infojson, se presentes, a menos que --no-embed-chapters/--no-embed-info-json sejam usados (apelido: --add-metadata).
--no-embed-metadata  No adiciona metadados ao arquivo (padro; apelido: --no-add-metadata).
--embed-chapters  Adiciona marcadores de captulos ao vdeo (apelido: --add-chapters).
--no-embed-chapters  No adiciona marcadores de captulos (padro; apelido: --no-add-chapters).
--embed-info-json  Incorpora o infojson como anexo em arquivos de vdeo MKV/MKA.
--no-embed-info-json  No incorpora o infojson ao vdeo.
--parse-metadata [WHEN:]FROM:TO  Analisa metadados adicionais, como ttulo/artista, a partir de outros campos; consulte "MODIFYING METADATA" para detalhes. Os valores de WHEN suportados so os mesmos de --use-postprocessor (padro: pre_process).
--replace-in-metadata [WHEN:]FIELDS REGEX REPLACE  Substitui texto em um campo de metadados usando uma expresso regular. Pode ser usada vrias vezes. Os valores de WHEN suportados so os mesmos de --use-postprocessor (padro: pre_process).
--xattrs  Grava metadados nos atributos estendidos do arquivo, usando os padres Dublin Core e XDG.
--concat-playlist POLICY  Concatena vdeos de uma playlist. Pode ser "never", "always" ou "multi_video" (padro; somente quando os vdeos formam um nico programa). Todos os arquivos de vdeo devem possuir os mesmos codecs e o mesmo nmero de fluxos para poderem ser concatenados. O prefixo "pl_video:" pode ser usado com --paths e --output para definir o nome do arquivo de sada dos arquivos concatenados. Consulte "OUTPUT TEMPLATE" para detalhes.
--fixup POLICY  Corrige automaticamente falhas conhecidas no arquivo. Pode ser never (no faz nada), warn (somente emite um aviso), detect_or_warn (padro; corrige o arquivo se puder e avisa caso contrrio) ou force (tenta corrigir mesmo que o arquivo j exista).
--ffmpeg-location PATH  Localizao do executvel ffmpeg; pode ser o caminho para o executvel ou o diretrio que o contm.
--exec [WHEN:]CMD  Executa um comando, opcionalmente precedido por WHEN, separado por ":". Os valores suportados de WHEN so os mesmos de --use-postprocessor (padro: after_move). A mesma sintaxe do modelo de sada pode ser usada para passar qualquer campo como argumento ao comando; por motivos de segurana, as nicas converses permitidas so "i"/"d" (decimal inteiro com sinal), "f" (decimal de ponto flutuante) e "q" (entre aspas para o shell). Se nenhum campo for passado, %(filepath,_filename|)q ser acrescentado ao final do comando. Pode ser usada vrias vezes.
--no-exec  Remove qualquer --exec previamente definido.
--convert-subs FORMAT  Converte as legendas para outro formato. Atualmente suportados: ass, lrc, srt, vtt. Use "--convert-subs none" para desabilitar a converso (padro; apelido: --convert-subtitles).
--convert-thumbnails FORMAT  Converte miniaturas para outro formato. Atualmente suportados: jpg, png, webp. Pode-se especificar vrias regras usando sintaxe semelhante  de --remux-video. Use "--convert-thumbnails none" para desabilitar a converso (padro).
--split-chapters  Divide o vdeo em vrios arquivos com base nos captulos internos. O prefixo "chapter:" pode ser usado com --paths e --output para definir o nome dos arquivos resultantes.
--no-split-chapters  No divide o vdeo com base nos captulos (padro).
--remove-chapters REGEX  Remove captulos cujo ttulo corresponda  expresso regular fornecida. A sintaxe  a mesma de --download-sections. Pode ser usada vrias vezes.
--no-remove-chapters  No remove captulos dos arquivos (padro).
--force-keyframes-at-cuts  Fora keyframes nos cortes ao baixar, dividir ou remover sees. Isso  lento porque requer uma recodificao, mas o vdeo resultante pode apresentar menos artefatos ao redor dos cortes.
--no-force-keyframes-at-cuts  No fora keyframes ao redor dos captulos durante cortes/divises (padro).
--use-postprocessor NAME[:ARGS]  Nome, com diferenciao entre maisculas e minsculas, dos plugins de ps-processamento a serem habilitados e, opcionalmente, argumentos a serem passados a eles, separados por ":". ARGS  uma lista delimitada por ponto e vrgula ";" no formato NAME=VALUE. O argumento "when" determina quando o ps-processador  executado. Pode ser "pre_process" (aps a extrao do vdeo), "after_filter" (depois que o vdeo passa pelo filtro), "video" (aps --format; antes de --print/--output), "before_dl" (antes de cada download), "post_process" (aps cada download; padro), "after_move" (aps mover o vdeo para o local final), "after_video" (aps baixar e processar todos os formatos de um vdeo) ou "playlist" (ao final da playlist). Pode ser usada vrias vezes para adicionar diferentes ps-processadores.

Opes do SponsorBlock:
Cria entradas de captulo ou remove vrios segmentos (patrocinadores, introdues etc.) dos vdeos baixados do YouTube usando a API do SponsorBlock.

--sponsorblock-mark CATS  Categorias do SponsorBlock para as quais criar captulos, separadas por vrgulas. Categorias disponveis: sponsor, intro, outro, selfpromo, preview, filler, interaction, music_offtopic, hook, poi_highlight, chapter, all e default (=all). Pode-se prefixar a categoria com "-" para exclu-la. Consulte [1] para as descries das categorias. Por exemplo, --sponsorblock-mark all,-preview. [1] [https://wiki.sponsor.ajay.app/w/Segment_Categories](https://wiki.sponsor.ajay.app/w/Segment_Categories)
--sponsorblock-remove CATS  Categorias do SponsorBlock a serem removidas do arquivo de vdeo, separadas por vrgulas. Se uma categoria estiver presente tanto em mark quanto em remove, remove ter prioridade. A sintaxe e as categorias disponveis so as mesmas de --sponsorblock-mark, exceto que "default" significa "all,-filler" e poi_highlight e chapter no esto disponveis.
--sponsorblock-chapter-title TEMPLATE  Modelo de sada para o ttulo dos captulos do SponsorBlock criados por --sponsorblock-mark. Os nicos campos disponveis so start_time, end_time, category, categories, name e category_names. O padro  "[SponsorBlock]: %(category_names)l".
--no-sponsorblock  Desabilita tanto --sponsorblock-mark quanto --sponsorblock-remove.
--sponsorblock-api URL  Local da API do SponsorBlock; o padro  [https://sponsor.ajay.app](https://sponsor.ajay.app).

Opes do extrator:
--extractor-retries RETRIES  Nmero de tentativas para erros conhecidos de extratores (padro: 3) ou "infinite".
--allow-dynamic-mpd  Processa manifestos DASH dinmicos (padro). (Apelido: --no-ignore-dynamic-mpd)
--ignore-dynamic-mpd  No processa manifestos DASH dinmicos. (Apelido: --no-allow-dynamic-mpd)
--hls-split-discontinuity  Divide playlists HLS em diferentes formatos nas descontinuidades, como intervalos de anncios.
--no-hls-split-discontinuity  No divide playlists HLS nas descontinuidades (padro).
--extractor-args IE_KEY:ARGS  Passa argumentos ARGS ao extrator IE_KEY. Consulte "EXTRACTOR ARGUMENTS" para detalhes. Pode ser usada vrias vezes para diferentes extratores.

Apelidos de preset:
Apelidos predefinidos para facilitar o uso. Observe que verses futuras do yt-dlp podem adicionar ou ajustar presets, mas os nomes dos presets existentes no sero alterados nem removidos.

-t mp3  -f 'ba[acodec^=mp3]/ba/b' -x --audio-format mp3
-t aac  -f 'ba[acodec^=aac]/ba[acodec^=mp4a.40.]/ba/b' -x --audio-format aac
-t mp4  --merge-output-format mp4 --remux-video mp4 -S vcodec:h264,lang,quality,res,fps,hdr:12,acodec:aac
-t mkv  --merge-output-format mkv --remux-video mkv
-t sleep  --sleep-subtitles 5 --sleep-requests 0.75 --sleep-interval 10 --max-sleep-interval 20

Consulte a documentao completa em [https://github.com/yt-dlp/yt-dlp#readme](https://github.com/yt-dlp/yt-dlp#readme)
