Ir para o conteúdo
yt-dlp

Baixar vídeo 4K — Gerador de comandos yt-dlp

Monte um comando do yt-dlp para vídeo 2160p preservando capítulos e metadados.

Opcional. Se deixar vazio, o comando termina em URL para você preencher.

Seu comando

yt-dlp -f 'bv*[height<=2160]+ba/b[height<=2160]' --merge-output-format mkv --no-playlist --embed-metadata --embed-chapters -N 4 'https://www.youtube.com/watch?v=dQw4w9WgXcQ'
Básico

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

Vídeo e qualidade

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

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

Opções avançadas (3)

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

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

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

Áudio

O arquivo para o qual o áudio é convertido.

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.

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

Playlists e canais

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

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

Opções avançadas (1)

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

Trechos e capítulos
Opções avançadas (2)

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.

Metadados e capa
Opções avançadas (3)
SponsorBlock

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

Opções avançadas (1)

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

Arquivos e pastas

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

Opções avançadas (4)

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

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

Filtros
Opções avançadas (5)

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

AAAAMMDD, ou uma data relativa.

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

Pula o que for maior.

Quantidade de arquivos a baixar antes de parar.

Rede

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

Opções avançadas (5)

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

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

URL de proxy HTTP, HTTPS ou SOCKS.

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

Login e cookies

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

Opções avançadas (1)

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

Transmissões ao vivo
Opções avançadas (2)

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

Contornos
Opções avançadas (3)

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

Obsoleto em favor de --add-headers.

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

Saída e depuração
Opções avançadas (2)
Redefinir

O que 4K realmente exige

Em 2160p, vídeo e áudio são sempre faixas separadas, então o ffmpeg é obrigatório para uni-las. MKV é o container mais seguro: MP4 não consegue conter alguns dos codecs em que o 4K é entregue, e forçá-lo faz o yt-dlp recodificar — lento, com perdas e a forma usual de perder os metadados HDR.

Se o 4K não aparecer, provavelmente nunca foi publicado nessa resolução. Liste os formatos antes de supor que o comando está errado. Conte com vários gigabytes por hora e use um limite de tamanho ou um intervalo de tempo se isso for um problema.

A escolha de container é a decisão de HDR. 4K HDR chega em codecs — VP9.2, AV1 — que MP4 nem sempre consegue carregar, e forçar MP4 faz o yt-dlp transcodificar: horas de trabalho, perda de qualidade visível, e os metadados HDR perdidos. MKV guarda tudo como está; este preset o usa como padrão exatamente por isso. Um player SDR reproduz um arquivo HDR com aparência lavada — é o player, não o arquivo, e converter HDR para SDR direito é um trabalho de filtro, não uma flag.

Banda é onde o 4K deixa de ser teoria: 2160p num bitrate decente roda 40–90 GB por hora de material, e fragmentos em paralelo fazem o download tão rápido quanto a conexão permite — que é exatamente o que dispara a limitação da plataforma. Se a rodada desacelera até rastejar, corte o número de fragmentos pela metade e deixe correr mais; um arquivo 4K é grande o bastante para terminar devagar ainda vencer recomeçar. A opção de limite de tamanho existe para parar uma rodada desgovernada antes que o disco o faça.

Capítulos e metadados são onde um arquivo 4K ganha o seu valor: um filme de duas horas sem capítulos é um arquivo, e com eles é navegável. SponsorBlock se integra aqui também — os segmentos de patrocínio são marcados em conteúdo 4K igual em qualquer outro, e pular num arquivo de duração de filme economiza mais tempo que em qualquer coisa menor. Incorpore a miniatura como capa, ou sua biblioteca de mídia vai mostrar um bloco vazio para cada arquivo 4K.

O que 4K não consegue: ampliar. Uma fonte de 1080p com o limite levantado continua 1080p — o limite é um máximo, e o yt-dlp escolhe sem reclamar a melhor faixa nela ou abaixo. Se -F não mostra nada acima de 1080p, isso é tudo que quem enviou deu à plataforma. Fontes 4K reais no YouTube costumam ser VP9 ou AV1, que GPUs velhas decodificam em software — um player lento muitas vezes é questão de codec, não de arquivo, e o MKV mantém o codec original intocado.

Perguntas frequentes

Por que não há 4K para este vídeo?
Ele não foi publicado em 4K, ou a plataforma restringe essa versão. Rode -F para ver o que existe antes de supor que o comando está errado.
Qual container devo usar para 4K?
MKV aceita qualquer combinação de codecs. MP4 é mais compatível mas não consegue conter alguns codecs 4K, e nesse caso o yt-dlp tem que recodificar — lento e com perdas.
Qual o tamanho de downloads em 4K?
Muitas vezes vários gigabytes por hora. Use um tamanho máximo ou um intervalo de tempo se isso importar.
HDR funciona?
Sim, quando a fonte tem. Preserve o codec original — recodificar é o que normalmente destrói os metadados HDR.