Ir para o conteúdo
yt-dlp

Gravar transmissões ao vivo — Gerador de comandos yt-dlp

Monte um comando do yt-dlp para gravar uma transmissão ao vivo, desde o início quando a plataforma permitir.

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

Seu comando

yt-dlp --merge-output-format mkv --no-playlist -N 4 --live-from-start --wait-for-video 60-300 'https://www.youtube.com/watch?v=live_stream_id'
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

Gravando ao vivo com segurança

Gravar-desde-o-início captura do começo em vez do momento em que você rodou o comando, desde que a plataforma ainda tenha a parte anterior. Esperar-a-transmissão consulta uma live agendada e começa no instante em que ela entra no ar.

Escolha MKV. Uma gravação que para de forma inesperada — e as de live param — normalmente deixa um MKV reproduzível, enquanto um MP4 cortado no meio da escrita muitas vezes não abre. Não existe retomar uma live, então a escolha do container é toda a rede de segurança.

Esperar uma transmissão agendada é um modo diferente de gravar uma em andamento: esperar-a-transmissão consulta a URL até que a live abra, e então começa a gravar — deixe o terminal rodando e ele captura desde o primeiro minuto. O intervalo de consulta é de minutos, não de segundos, então lance o comando cedo; chegar tarde à consulta custa minutos de transmissão, e nenhuma opção recupera minutos que nunca foram gravados.

Gravar-desde-o-início tem um limite de plataforma: o YouTube guarda o começo de uma transmissão e o serve sob demanda, então a opção o alcança de verdade; a Twitch igualmente dentro da janela de retenção dela. Outras plataformas não guardam nada antes do momento em que você entrou. É por isso que a opção não é um interruptor mágico — ela busca o que a plataforma armazenou, e as plataformas diferem no que armazenam. Se a plataforma oferece uma repetição depois, a repetição é fonte melhor que qualquer captura ao vivo.

Lives são HLS por definição: centenas de segmentos curtos chegando em tempo real, unidos pelo ffmpeg no container conforme chegam. É por isso que gravação ao vivo é o caso em que MKV mais importa — um MP4 precisa do índice escrito no fim, e uma gravação morta no minuto três de uma transmissão de duas horas não tem índice nenhum. Espaço em disco é o outro limite real: uma gravação ao vivo cresce no bitrate da transmissão enquanto dura, e um limite de tamanho protege o disco numa transmissão que roda doze horas porque quem transmitiu esqueceu de parar.

Depois do fato, duas coisas merecem ser nomeadas. Uma gravação com silêncio é normal — o silêncio entre segmentos do evento está na fonte —, e cortá-lo depois é uma edição, não um download falhado. E transmissões que terminaram há horas são VODs comuns quando você as encontra: use as opções de vídeo normais da plataforma — as que este formulário mostra por padrão —, e as específicas de live só enquanto a transmissão está realmente ao vivo.

Perguntas frequentes

Posso gravar uma transmissão ao vivo desde o início?
Ligue gravar-desde-o-início. Só funciona onde a plataforma ainda mantém a parte anterior da transmissão.
Como gravo uma transmissão que ainda não começou?
Use esperar-a-transmissão com um intervalo MIN-MAX. O yt-dlp consulta e começa no instante em que a live entra no ar.
Qual container é melhor para live?
MKV. Ele tolera uma escrita interrompida, enquanto um MP4 cortado no meio da gravação pode ficar irreproduzível.
O que acontece se minha gravação for interrompida?
Com MKV você normalmente mantém tudo que foi gravado até ali. Retomar a gravação de uma live não é possível — a parte que falta se perdeu.