Referência de opções do yt-dlp

O que você quer

Só áudio extrai a trilha sonora e descarta o vídeo.

Qualidade máxima

Limita a altura. O yt-dlp ainda escolhe a melhor faixa nesse limite ou abaixo.

Selector de formato próprio

Substitui a lista de qualidade. Para quem já conhece a sintaxe de formatos.

Container

O tipo de arquivo em que as faixas separadas de vídeo e áudio são unidas.

Remux para

Reempacota as faixas sem recodificar. Rápido e sem perdas.

Recodificar para

Recodifica o vídeo. Lento e com perdas — só quando remux não resolver.

Formato de áudio

O arquivo para o qual o áudio é convertido.

Qualidade do áudio

VBR dá a melhor relação tamanho-qualidade; bitrates fixos são mais previsíveis.

Legendas

Embutir coloca as legendas dentro do vídeo; salvar grava um .srt separado ao lado.

Idiomas das legendas

Separados por vírgula. Use all para todos os idiomas disponíveis.

Legendas automáticas

Inclui as legendas geradas por máquina quando não existem legendas humanas.

Playlists

O que fazer quando a URL pertence a um vídeo e a uma playlist ao mesmo tempo.

Quais itens

Intervalos e listas funcionam, por exemplo 1-10,15 ou -5::2 para um a cada dois de trás para frente.

Arquivo de registro

Anota o que já foi baixado para que uma nova execução pule. É assim que se mantém um canal sincronizado.

Baixar só um trecho

Um intervalo como *00:01:30-00:03:00, ou o nome de um capítulo. O asterisco na frente indica que é um horário.

Dividir por capítulos

Grava um arquivo por capítulo em vez de um só, longo.

Embutir thumbnail

Usa a thumbnail do vídeo como capa.

Embutir metadados

Grava título, autor e data dentro do próprio arquivo.

Embutir capítulos

Adiciona marcadores de capítulo que seu player consegue pular.

Salvar a thumbnail

Grava a imagem de capa ao lado do vídeo.

Salvar a descrição

Grava a descrição num arquivo .description.

Salvar metadados em JSON

Grava tudo que o yt-dlp sabe sobre o vídeo num arquivo .info.json.

Remover trechos

Corta do arquivo os trechos marcados pela comunidade, usando os dados do SponsorBlock.

Marcar trechos como capítulos

Mantém os trechos, mas marca-os para você pular por conta própria.

Modelo do nome do arquivo

Os campos vão em %(...)s. Barras criam pastas.

Pasta de download

Onde os arquivos são gravados. Combine com o modelo acima para criar subpastas.

Nomes seguros (só ASCII)

Remove acentos, espaços e qualquer caractere que um sistema de arquivos exigente possa rejeitar.

Nomes compatíveis com Windows

Remove os caracteres que o Windows recusa, mesmo rodando em outro sistema.

Cortar nomes em

Tamanho máximo do nome do arquivo, em caracteres.

Sobrescrever arquivos existentes

Substitui os arquivos que já estiverem lá.

Nunca sobrescrever

Pula tudo que já foi baixado.

Continuar downloads parciais

Retoma de onde o download foi interrompido.

Publicado depois de

AAAAMMDD, ou uma data relativa como now-1month.

Publicado antes de

AAAAMMDD, ou uma data relativa.

Tamanho mínimo

Pula o que for menor. Aceita 5M, 500K e similares.

Tamanho máximo

Pula o que for maior.

Parar depois de

Quantidade de arquivos a baixar antes de parar.

Limite de velocidade

Por exemplo 2M ou 500K. Útil quando você precisa do resto da banda.

Fragmentos em paralelo

Acelera faixas fragmentadas. Quatro é um bom ponto de partida.

Tentativas

Quantas vezes tentar de novo uma parte que falhou. infinite é aceito.

Proxy

URL de proxy HTTP, HTTPS ou SOCKS.

Contornar bloqueio regional

Finge a origem da requisição. Funciona em alguns sites, não em todos.

Simular um navegador

Faz as requisições parecerem de um navegador real. É a solução comum para um 403 repentino.

Cookies do navegador

Lê sua sessão logada diretamente. Necessário para conteúdo privado, com restrição de idade ou só para membros.

Arquivo de cookies

Um cookies.txt no formato Netscape exportado do seu navegador.

Gravar desde o início

Começa uma transmissão ao vivo do início em vez do momento atual.

Esperar a transmissão

Consulta até uma transmissão agendada começar. MIN-MAX segundos entre as checagens.

User agent

Obsoleto em favor de --add-headers. Mantido porque muitos guias antigos ainda usam.

Referer

Obsoleto em favor de --add-headers.

Argumentos do extractor

Opções específicas de cada site, por exemplo youtube:player_client=web.

Continuar apesar dos erros

Pula os itens que falham em vez de parar. Indispensável em playlists grandes.

Só listar formatos

Imprime os formatos disponíveis e encerra sem baixar.

Simular

Faz tudo, menos gravar o arquivo.