Por que os downloads do YouTube param perto de 360p
O YouTube só serve um MP4 completo — imagem e som num único arquivo — em resoluções modestas. Tudo acima disso é guardado como fluxos separados que precisariam ser unidos, e esta ferramenta não faz essa união.
Esta é a surpresa mais comum na página do YouTube, então vale dizê-la logo de cara: o teto normalmente é 360p, às vezes 240p, e não é uma configuração que se possa aumentar. O baixador oferece o MP4 progressivo que o YouTube publica como um único arquivo. Uma versão em 1080p existe do lado do YouTube, mas não como um único arquivo.
Multiplexado e adaptativo são duas coisas diferentes
O YouTube guarda cada vídeo em dois formatos. Os formatos multiplexados carregam imagem e som juntos num único MP4 — um arquivo que você pode salvar e reproduzir em qualquer lugar. Os formatos adaptativos os separam: um fluxo só de vídeo e um fluxo separado só de áudio, cada um codificado na taxa de bits que o YouTube escolheu para aquela resolução.
Reproduzir 1080p no navegador é fácil, porque o player busca os dois fluxos e os une na hora. Salvar 1080p como um único arquivo é outra tarefa: algo precisa unir as faixas. Este baixador não carrega um multiplexador, então lista apenas os formatos multiplexados — e, cada vez mais, o YouTube serve esses em 360p e abaixo. O formato multiplexado de 720p que costumava existir não é mais entregue a clientes anônimos.
O que o resolvedor faz
- Ele consulta o endpoint do player do YouTube com uma escada de identidades de clientes oficiais, do cliente Android ao player web incorporado.
- Ele mantém apenas as entradas MP4 multiplexadas, sem duplicatas pelo id de formato.
- Ele rotula cada linha com o próprio rótulo de qualidade do YouTube, recorrendo à altura do quadro quando não há um.
- Se o player recusar, uma sondagem oEmbed ainda informa se o vídeo existe, para que um vídeo excluído não seja confundido com um bloqueado.
A escada de clientes é o motivo pelo qual um vídeo que falha numa tentativa pode funcionar na seguinte: clientes diferentes recebem formatos diferentes, e o YouTube muda quais estão disponíveis com o tempo.
Por que o link abre numa nova aba
Os bytes do vídeo vêm de googlevideo.com, que não envia cabeçalhos CORS. A página não consegue lê-los, então o botão de download navega até o link — seu navegador salva o arquivo direto da CDN do Google. Dois detalhes fazem essa navegação se comportar: o resolvedor acrescenta um parâmetro de título à URL, o que faz o servidor do Google responder com content-disposition: attachment, de modo que o arquivo é salvo em vez de reproduzido na aba.
Por que nada fica em cache
O resultado de todas as outras plataformas fica em cache por alguns minutos ou mais. O do YouTube nunca fica, de propósito: os links de googlevideo.com são atrelados ao endereço que os pediu e expiram rápido. Um link em cache pareceria um botão de download e falharia como um link morto, então o resolvedor consulta o YouTube do zero a cada vez.
O que não é suportado
| Caso | Resultado |
|---|---|
| Vídeo público | Resolvido; os formatos MP4 multiplexados que o YouTube oferece. |
| Privado, só para membros, com restrição de idade | private — o resolvedor nunca faz login. |
| Vídeo excluído ou removido | not_found. |
| Transmissão ao vivo em andamento | Não existe arquivo multiplexado enquanto a transmissão está rodando. |
| Shorts | Funcionam como qualquer outro vídeo, com o mesmo teto de resolução. |
A versão curta
- Só o MP4 multiplexado é oferecido, que normalmente é 360p.
- Resoluções maiores exigem fluxos separados de vídeo e áudio unidos; esta ferramenta não os une.
- Nada é recodificado, marcado com marca d'água ou guardado.
- Os links nunca ficam em cache, porque são atrelados ao seu endereço e expiram.
- Só vídeos públicos — vídeos privados e com restrição de idade continuam bloqueados.
Perguntas
Isto consegue baixar 1080p do YouTube?
Não. O YouTube mantém o 1080p como fluxos separados só de vídeo e só de áudio, e esta ferramenta não os une. Ela oferece o MP4 multiplexado que o YouTube publica como um único arquivo, que normalmente é 360p.
Por que o vídeo abre numa nova aba em vez de baixar na página?
Porque `googlevideo.com` não envia cabeçalhos CORS, então a página não consegue ler os bytes. O link carrega um parâmetro de título que faz o Google responder com `content-disposition: attachment`, então seu navegador salva o arquivo em vez de reproduzi-lo.
Por que o mesmo link às vezes lista qualidades diferentes?
O resolvedor consulta o YouTube por várias identidades de clientes oficiais, e elas não recebem os mesmos formatos. Puxar o link de novo depois de um momento pode mudar a lista.