Gerador de comandos yt-dlp para Facebook

Monte um comando do yt-dlp para vídeos do Facebook, com as opções de cookies que a maioria deles precisa.

URL do vídeo, playlist ou canal

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

Seu comando

yt-dlp -f 'bv*[height<=1080]+ba/b[height<=1080]' --merge-output-format mp4 --no-playlist --cookies-from-browser chrome 'https://www.facebook.com/watch/?v=1234567890'

Básico

O que você quer

Vídeo Só áudio

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

Vídeo e qualidade

Qualidade máxima -f

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

Container --merge-output-format precisa de ffmpeg

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

Opções avançadas (3)

Selector de formato próprio -f

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

Remux para --remux-video precisa de ffmpeg

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

Recodificar para --recode-video precisa de ffmpeg

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

Áudio

Formato de áudio --audio-format precisa de ffmpeg

O arquivo para o qual o áudio é convertido.

Qualidade do áudio --audio-quality precisa de ffmpeg

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.

Idiomas das legendas --sub-langs

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

Legendas automáticas --write-auto-subs Inclui as legendas geradas por máquina quando não existem legendas humanas.

Playlists e canais

Playlists

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

Quais itens -I

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)

Arquivo de registro --download-archive

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)

Baixar só um trecho --download-sections precisa de ffmpeg

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.

Dividir por capítulos --split-chapters precisa de ffmpeg Grava um arquivo por capítulo em vez de um só, longo.

Metadados e capa

Embutir thumbnail --embed-thumbnail precisa de ffmpeg Usa a thumbnail do vídeo como capa.

Embutir metadados --embed-metadata precisa de ffmpeg Grava título, autor e data dentro do próprio arquivo.

Embutir capítulos --embed-chapters precisa de ffmpeg Adiciona marcadores de capítulo que seu player consegue pular.

Opções avançadas (3)

Salvar a thumbnail --write-thumbnail Grava a imagem de capa ao lado do vídeo.

Salvar a descrição --write-description Grava a descrição num arquivo .description.

Salvar metadados em JSON --write-info-json Grava tudo que o yt-dlp sabe sobre o vídeo num arquivo .info.json.

SponsorBlock

Remover trechos --sponsorblock-remove precisa de ffmpeg

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

Opções avançadas (1)

Marcar trechos como capítulos --sponsorblock-mark

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

Arquivos e pastas

Modelo do nome do arquivo -o

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

Nomes seguros (só ASCII) --restrict-filenames Remove acentos, espaços e qualquer caractere que um sistema de arquivos exigente possa rejeitar.

Sobrescrever arquivos existentes --force-overwrites Substitui os arquivos que já estiverem lá.

Continuar downloads parciais -c Retoma de onde o download foi interrompido.

Opções avançadas (4)

Pasta de download -P

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

Nomes compatíveis com Windows --windows-filenames Remove os caracteres que o Windows recusa, mesmo rodando em outro sistema.

Cortar nomes em --trim-filenames

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

Nunca sobrescrever -w Pula tudo que já foi baixado.

Filtros

Opções avançadas (5)

Publicado depois de --dateafter

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

Publicado antes de --datebefore

AAAAMMDD, ou uma data relativa.

Tamanho mínimo --min-filesize

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

Tamanho máximo --max-filesize

Pula o que for maior.

Parar depois de --max-downloads

Quantidade de arquivos a baixar antes de parar.

Rede

Limite de velocidade -r

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

Opções avançadas (5)

Fragmentos em paralelo -N

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

Tentativas -R

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

Proxy --proxy

URL de proxy HTTP, HTTPS ou SOCKS.

Contornar bloqueio regional --geo-bypass Finge a origem da requisição. Funciona em alguns sites, não em todos.

Simular um navegador --impersonate

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

Cookies do navegador --cookies-from-browser

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)

Arquivo de cookies --cookies

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

Transmissões ao vivo

Opções avançadas (2)

Gravar desde o início --live-from-start Começa uma transmissão ao vivo do início em vez do momento atual.

Esperar a transmissão --wait-for-video

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

Contornos

Opções avançadas (3)

User agent --user-agent obsoleto

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

Referer --referer obsoleto

Obsoleto em favor de --add-headers.

Argumentos do extractor --extractor-args

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

Saída e depuração

Só listar formatos -F Imprime os formatos disponíveis e encerra sem baixar.

Opções avançadas (2)

Continuar apesar dos erros -i Pula os itens que falham em vez de parar. Indispensável em playlists grandes.

Simular -s Faz tudo, menos gravar o arquivo.

Redefinir

As opções que importam aqui

Cookies do navegador --cookies-from-browser Lê sua sessão logada diretamente. Necessário para conteúdo privado, com restrição de idade ou só para membros.
Qualidade máxima -f Limita a altura. O yt-dlp ainda escolhe a melhor faixa nesse limite ou abaixo.

Observações sobre o Facebook

Boa parte do Facebook não está disponível sem login, e as versões de qualidade mais alta muitas vezes só são oferecidas a uma sessão autenticada. Fornecer cookies resolve as duas coisas de uma vez.

Se o resultado parecer de qualidade menor que o que você via no navegador, liste os formatos primeiro — a escala disponível para a sua sessão costuma ser mais curta que a usada pelo player web.

URLs do Facebook chegam em mais formas que em qualquer outra plataforma que o yt-dlp trate: /watch/?v=…, /reel/…, posts de grupo, vídeos de página e links curtos de fb.watch. Todos caem no mesmo extrator, mas os embrulhados numa página às vezes precisam desembrar o vídeo primeiro. O permalink é a forma confiável — clique com o botão direito no horário do post e copie esse endereço; ele aponta direto para a página do mídia em vez de um feed que por acaso o contém.

O mesmo vídeo pode existir numa página, num grupo e num perfil como três itens separados, e a escala de qualidade difere entre eles: uploads de página costumam carregar a versão mais alta, recompartilhamentos a mais baixa. Vídeos de grupo precisam de cookies de uma conta que seja membro do grupo — uma sessão que não pode ver o post não pode baixá-lo, e nenhuma opção muda isso. Anúncios do Marketplace são um sistema diferente que o yt-dlp não suporta de modo algum.

Repasses de live se comportam como vídeos comuns depois que a transmissão termina, então baixe com as opções normais — com uma ressalva: uma repetição não é uma live, então gravar-desde-o-início não se aplica, e o começo do arquivo é o que o Facebook guardou. Se uma repetição começa no meio do evento, a parte anterior nunca foi retida como vídeo, e nenhum ajuste alcança mídia que a plataforma nunca armazenou.

Duas coisas de fato não funcionam, e dizer isso sai mais barato que deixar alguém passar uma noite nelas: anúncios do Marketplace, e stories que já expiraram. Todo o resto que falha normalmente falha por acesso e não por formato — por isso cookies são a primeira coisa a checar e -F a segunda. Se formatos aparecem mas cada degrau é baixo, essa é a escala oferecida à sua sessão; outra conta às vezes vê mais, mas nenhuma flag inventa uma versão mais alta que a que a plataforma serve.

Perguntas frequentes

› O yt-dlp baixa vídeos privados do Facebook?

Só os que sua conta já consegue ver, usando --cookies-from-browser. Não há como contornar uma permissão que você não tem.

› O Facebook retorna erro sem cookies.

Boa parte do Facebook não está disponível sem login. Forneça sua sessão com --cookies-from-browser chrome, com o navegador fechado.

› Por que a qualidade é menor que no navegador?

O Facebook oferece as versões altas só a algumas sessões. Rode -F para ver o que está disponível naquela URL e forneça cookies se a lista estiver curta.