Ir para o conteúdo
yt-dlp

Baixar legendas do YouTube — Gerador de comandos yt-dlp

Monte um comando do yt-dlp que salve as legendas como .srt sem baixar o vídeo.

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

Seu comando

yt-dlp --write-subs --convert-subs srt --sub-langs en --write-auto-subs --no-playlist -s '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

Legendas sem o vídeo

O modo simulação faz tudo exceto gravar o arquivo de vídeo, então você fica com as legendas e evita o download. Converter para SRT precisa do ffmpeg.

Se nada aparecer, é bem provável que o vídeo não tenha legendas escritas por pessoas — as automáticas são uma opção separada e, sem ligá-la, o yt-dlp não encontra nada e também não avisa.

O modo simulação é o interruptor que sustenta esta página: sem ele, o yt-dlp baixa o vídeo inteiro e apenas também salva as legendas, o que num arquivo de duração de filme é muita transferência para uma trilha de texto. Com ele, a rodada busca os metadados, escreve os arquivos de legenda e nunca toca o vídeo. O preço é que o modo simulação também pula a escrita de miniatura e descrição a que você talvez estivesse acostumado — esses são artefatos de uma rodada de vídeo, não de legendas.

A seleção de idioma é onde downloads de legenda ficam delicados. --sub-langs en toma exatamente a trilha marcada "en"; en-orig é o nome do YouTube para a gerada automaticamente, e en.* como padrão pega ambas mais as variantes regionais. Vários idiomas aceitam uma lista separada por vírgulas. Se um vídeo tem trilha humana e automática para o mesmo idioma, são dois itens separados, e baixar os dois é um resultado legítimo, não um bug.

Formatos importam quando o arquivo de legenda vai para um editor: SRT é o intercâmbio seguro, VTT carrega a estilização que o player web mostra, e os formatos JSON3/_SRV do próprio YouTube são para máquinas. O interruptor converter-para-srt cuida do caso comum, precisa do ffmpeg e perde a estilização de propósito — editores querem texto, não marcação. Se a saída parece vazia, confira que o arquivo existe antes de supor que a conversão falhou: um SRT de zero bytes significa que a trilha em si estava vazia.

Legendas automáticas merecem um aviso: são transcrição de máquina, com tudo o que isso implica — homófonos errados, sem pontuação, nomes machucados. Para um vídeo num idioma que você lê, são um índice de busca; para qualquer coisa que você vai citar, a trilha humana (quando existe) é a que vale guardar. Lives recebem legendas automáticas ao vivo, salvas só depois que a transmissão termina — as opções de gravação ao vivo deste site são para a imagem, e as legendas de uma transmissão terminada baixam com as opções normais de legenda.

Perguntas frequentes

Como baixo legendas sem o vídeo?
Escolha a opção .srt e ligue simular, que pula a gravação do arquivo de vídeo mas ainda salva as legendas.
Por que nenhum arquivo de legenda apareceu?
O vídeo provavelmente não tem legendas humanas. Ligue as automáticas para pegar as geradas por máquina.
Como escolho os idiomas das legendas?
Separe por vírgula, por exemplo en,pt. Use all para todos os disponíveis, ou um padrão como en.* para todas as variantes de inglês.
Posso obter SRT em vez de VTT?
Sim — a opção .srt converte, e isso precisa do ffmpeg.