Qual a diferença entre legendas automáticas e manuais?

Legendas automáticas são geradas por máquina (write-auto-sub); legendas manuais são fornecidas pelo criador (write-sub). A disponibilidade depende do vídeo.

Como escolho idiomas?

Use --sub-langs com códigos como en, pt ou padrões como en.*. Você pode solicitar vários, ex.: --sub-langs "en,pt" ou tudo com --all-subs.

Muitas plataformas fornecem WebVTT (vtt). Use --sub-format srt para preferir SRT e --convert-subs srt para converter quando possível.

Embutir ou salvar como arquivo externo?

--embed-subs insere as legendas no arquivo de saída (MKV recomendado para várias faixas). Sem essa opção, os arquivos .srt/.vtt são salvos ao lado do vídeo.

Baixar legendas e closed captions (Windows)

Q: Playlists com legendas?

Sim. Combine --write-sub/--write-auto-sub com --yes-playlist e modelos -o para manter tudo organizado.

Use o yt-dlp para obter legendas automáticas ou fornecidas pelo criador, escolher idiomas, gerar SRT/WebVTT e embutir faixas no vídeo. Para playlists, combine com modelos.

⬇️ Download do yt-dlp.exe Configuração do FFmpeg

Dica: Embutir legendas (--embed-subs) funciona melhor com MKV. Para MP4, o suporte pode ser limitado dependendo dos formatos.

• Funciona no Windows 11/10

Legendas automáticas vs manuais

Automáticas (geradas por máquina)

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

Captura legendas automáticas quando disponíveis.
en,* = inglês preferido, caso contrário qualquer idioma.

Manuais (fornecidas pelo criador)

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

Baixa apenas legendas humanas nos idiomas escolhidos.

Embutir vs arquivos externos

Embutir faixas no contêiner do vídeo (recomendado MKV):

yt-dlp -f "bv+ba/best" --embed-subs --merge-output-format mkv "URL"

Sem --embed-subs, os arquivos de legendas (.srt/.vtt) são salvos ao lado do vídeo.

Converter para SRT

Prefira SRT e converta quando possível:

yt-dlp --write-sub --sub-langs en --sub-format srt --convert-subs srt "URL"

Playlists com legendas

yt-dlp --write-sub --sub-langs "en.*" --yes-playlist -o "%(playlist)s/%(playlist_index)02d-%(title)s.%(ext)s" "PLAYLIST_URL"

en.* corresponde a variantes de inglês (ex.: en-GB).
Use --download-archive para evitar duplicados em listas grandes.

Padrões de idioma

Vários idiomas: --sub-langs "en,es,de"
Todos os disponíveis: --all-subs
Preferir inglês, senão qualquer: --sub-langs "en,*"

Onde os arquivos são salvos

Por padrão, na pasta atual. Controle caminhos com -o, por exemplo:

-o "C:/Videos/%(title)s.%(ext)s"

FAQ

Nenhuma legenda encontrada?

Nem todos os vídeos oferecem legendas. Tente --write-auto-sub ou verifique outros idiomas com --all-subs.

Legendas embutidas não aparecem?

Use MKV com --merge-output-format mkv e garanta que o seu player suporte faixas de legenda.

Posso queimar (hardcode) as legendas?

O yt-dlp embute legendas como faixas. Queimar no vídeo exige reencode com filtros do FFmpeg; está fora do escopo deste guia.

Legalidade e segurança

Baixe e use legendas apenas quando você tiver direitos. Algumas legendas automáticas podem ser imprecisas; verifique antes de reutilizar.

Próximos passos: Folha de comandos • Solução de problemas