Ir para o conteúdo
yt-dlp

Gerador de comandos yt-dlp para Bilibili

Monte um comando do yt-dlp para o Bilibili, começando pela simulação de navegador que evita a maioria dos erros 403.

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 --impersonate chrome --cookies-from-browser chrome https://www.bilibili.com/video/BV1xx411c7mD
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

Erros 403 e limites de qualidade

O Bilibili recusa requisições que não parecem de um navegador, e é por isso que um comando simples costuma retornar 403. A simulação vem ligada neste preset porque é a solução na maioria dos casos.

1080p e acima geralmente são reservados a contas autenticadas e às vezes pagas, então aqui os cookies importam por qualidade e não só por acesso. Vídeos em várias partes aparecem como itens de playlist.

O Bilibili é a plataforma onde um yt-dlp desatualizado quebra mais rápido — o site refaz a API dele mais vezes que qualquer plataforma ocidental, e atualizações do extrator chegam às versões do yt-dlp em dias de cada mudança. Quando um download que funcionava no mês passado começa a falhar, atualize primeiro: yt-dlp -U. A simulação de navegador (ligada por padrão neste preset) cobre a parte do problema 403 dos headers de navegador; o resto costuma ser uma sessão ausente ou expirada.

Uploads em várias partes — a estrutura P1/P2/P3 comum em séries — chegam como itens de playlist, então o modo playlist inteira busca cada parte, e o índice da playlist no modelo de saída mantém as partes em ordem. Danmaku (os comentários rolando) são para o yt-dlp uma trilha de legenda: --write-subs os salva como arquivo .ass, o único formato em que existem. Se não os quer, não faça nada — eles não são unidos a menos que pedidos.

Qualidades de interação — as escalas "dolby" e premium — existem só para contas que as têm, e nenhuma flag as alcança sem cookies de uma conta assim. Conteúdo bloqueado por região é a outra parede: alguns uploads só são visíveis da China continental, e um proxy dentro da região é a única rota quando o bloqueio é aplicado na CDN e não na página. Contorno geográfico às vezes funciona para o bloqueio de nível de página e nunca para o de nível de CDN.

O Bilibili entrega as qualidades mais altas como DASH com áudio separado, então o ffmpeg une igual que o YouTube — a etapa de merge já está neste preset. Extração só áudio com -x funciona e é o caminho mais rápido de levar só o som de um upload longo em várias partes. Para repetições de lives, a repetição vira um VOD comum depois que a transmissão termina, então baixe como qualquer vídeo; as opções de gravação ao vivo deste site são para a transmissão enquanto ela acontece.

Perguntas frequentes

Por que o Bilibili retorna 403?
O Bilibili recusa requisições que não parecem de um navegador. --impersonate chrome resolve na maioria das vezes; adicione cookies para conteúdo só de membros.
Como baixo 1080p ou mais do Bilibili?
Resoluções mais altas são reservadas a contas autenticadas e às vezes pagas. Use --cookies-from-browser com uma dessas.
Como pego todas as partes de um vídeo em várias partes?
Coloque o modo de playlist em playlist inteira — as partes são expostas como itens da playlist.