Windows 11/10  ·  SRT / WebVTT  ·  Legendas auto & manuais

Baixar Legendas & Closed Captions do YouTube com yt-dlp no Windows

Salve legendas como arquivos SRT/VTT separados ou incorpore diretamente no MKV. Suporta legendas geradas automaticamente, legendas do criador, múltiplos idiomas e playlists.

⬇ Baixar yt-dlp.exe Configurar FFmpeg →

Legendas geradas automaticamente vs fornecidas pelo criador

Dois tipos de legendas no YouTube — escolha a flag certa para cada tipo.

Geradas automaticamente (legendas de máquina)

Legendas de reconhecimento de voz do YouTube. Disponíveis na maioria dos vídeos. Use --write-auto-sub.

yt-dlp --write-auto-sub --sub-langs "pt,*" --sub-format srt "URL"

pt,* = Português se disponível, caso contrário qualquer idioma

Manuais (fornecidas pelo criador)

Legendas enviadas pelo criador do vídeo. Mais precisas quando disponíveis. Use --write-sub.

yt-dlp --write-sub --sub-langs pt --sub-format srt "URL"

Baixa apenas se existirem legendas manuais — não encontra nada se não disponíveis

Dica: Para obter legendas independentemente do tipo, combine ambas as flags: --write-sub --write-auto-sub — yt-dlp prefere as manuais se disponíveis e usa as automáticas como fallback.

Comandos yt-dlp para download de legendas

Copie e cole no PowerShell. Substitua a URL pelo link do seu vídeo ou playlist.

Baixar vídeo + legendas como arquivos SRT separados
yt-dlp --write-sub --write-auto-sub --sub-langs pt --sub-format srt "URL"
Converter para SRT (YouTube fornece nativamente WebVTT)
yt-dlp --write-sub --sub-langs pt --sub-format srt --convert-subs srt "URL"
Incorporar legendas no MKV (recomendado)
yt-dlp -f "bv+ba/best" --write-sub --write-auto-sub --sub-langs pt --embed-subs --merge-output-format mkv "URL"
Múltiplos idiomas ao mesmo tempo
yt-dlp --write-sub --write-auto-sub --sub-langs "pt,en,es" --sub-format srt "URL"
Baixar todos os idiomas de legendas disponíveis
yt-dlp --write-sub --write-auto-sub --all-subs --sub-format srt "URL"
Playlist com legendas — nomes de arquivo organizados
yt-dlp --write-sub --write-auto-sub --sub-langs "pt.*" --yes-playlist -o "%(playlist)s/%(playlist_index)02d-%(title)s.%(ext)s" "PLAYLIST_URL"

Padrões de sub-langs e opções de formato

Padrões --sub-langs

Apenas português
--sub-langs pt
Variantes do português (pt-BR, pt-PT etc.)
--sub-langs "pt.*"
Português preferido, qualquer idioma como fallback
--sub-langs "pt,*"
Múltiplos idiomas específicos
--sub-langs "pt,en,es"

Opções de formato

Preferir formato SRT
--sub-format srt
Converter para SRT (requer FFmpeg)
--convert-subs srt
Manter WebVTT (formato nativo do YouTube)
--sub-format vtt
Incorporar no MKV (melhor para legendas soft)
--embed-subs --merge-output-format mkv

Legendas com yt-dlp — perguntas frequentes

Nenhuma legenda encontrada — o que tentar?
Primeiro tente --write-auto-sub — a maioria dos vídeos do YouTube tem legendas geradas automaticamente. Se ainda não encontrar nada, o vídeo pode não ter legendas. Tente --all-subs para verificar todos os idiomas disponíveis. Alguns vídeos são somente áudio ou têm legendas desativadas.
SRT ou WebVTT — qual devo usar?
YouTube fornece nativamente WebVTT. SRT é mais universalmente suportado por players de mídia. Use --sub-format srt --convert-subs srt para obter SRT. A conversão requer FFmpeg na mesma pasta que yt-dlp.exe.
Legendas incorporadas não aparecem no meu player
Certifique-se de usar --merge-output-format mkv — MKV tem o melhor suporte a faixas de legenda. MP4 com legendas incorporadas pode ser problemático em alguns players. Também verifique se a exibição de legendas está habilitada no seu player de mídia.
Posso baixar apenas as legendas — sem o vídeo?
Sim. Adicione --skip-download para baixar apenas os arquivos de legenda sem salvar o vídeo: yt-dlp --write-sub --write-auto-sub --sub-langs pt --skip-download "URL"
Posso gravar as legendas permanentemente no vídeo?
yt-dlp incorpora legendas como faixas soft (selecionáveis no player). Gravar permanentemente (queimar as legendas na imagem) requer pós-processamento com FFmpeg e está fora do escopo das opções integradas do yt-dlp.