yt-dlp: A versão moderna do youtube-dl para baixar vídeos

Em 23 de outubro de 2020, a Recording Industry Association of America (RIAA) entrou com um pedido de remoção por violação de direitos autorais (DMCA) contra o youtube-dl no GitHub. Três dias depois, em 26 de outubro, um novo repositório surgiu discretamente em github.com/yt-dlp/yt-dlp. Quando o GitHub restaurou o projeto original em 16 de novembro — juntamente com um novo fundo de defesa de desenvolvedores de US$ 1 milhão — o novo fork já havia começado a absorver os colaboradores do youtube-dl.

Essa versão modificada é agora a principal. Em maio de 2026, o yt-dlp registrava mais de 12 milhões de downloads mensais no PyPI. Seu repositório no GitHub tinha 160.766 estrelas. O projeto lançava uma nova versão aproximadamente a cada duas semanas. A versão mais recente, no momento da escrita deste texto, era `2026.03.17`. Ele suporta mais de 1.800 sites de vídeo e áudio por meio de seu sistema de plugins extratores. A seguir, uma análise honesta do que é o yt-dlp e como usá-lo. Além disso, abordaremos sua situação legal em 2026 e por que uma instalação que funcionava perfeitamente pode parar de funcionar repentinamente em meados de 2025.

De onde veio o yt-dlp: a cadeia bifurcada do youtube-dl

A linhagem é importante aqui porque explica uma discrepância de comportamento. O yt-dlp implementa correções poucas horas após uma interrupção do YouTube; o youtube-dl pode levar semanas. Três projetos compõem essa árvore genealógica, e cada passo foi impulsionado pela frustração com o anterior.

O youtube-dl foi o original. Ricardo García o escreveu em agosto de 2006, e Philipp Hagemeister o liderou posteriormente com um grupo coeso sob o nome de `ytdl-org/youtube-dl`. Em 2020, tornou-se a ferramenta de arquivamento padrão, mas as solicitações de pull estavam se acumulando e as correções do YouTube estavam sendo implementadas com atraso.

Essa lacuna foi o que deu origem ao youtube-dlc, onde o "c" significava "comunidade". O usuário `blackjack4494` fez um fork do repositório em 2020 e a fila de merges foi esvaziada em poucos dias. O próprio fork ficou semi-inativo no final do mesmo ano — um dos mantenedores é instável.

O yt-dlp é um refork do youtube-dlc. O repositório foi criado em 26 de outubro de 2020, três dias após a RIAA remover o youtube-dl original do repositório. O yt-dlp é uma ferramenta de linha de comando que permite baixar vídeos e áudios de sites compatíveis. O "p" refere-se a um dos primeiros mantenedores principais (`pukkandan`). O projeto agora é gerenciado por uma organização com múltiplos mantenedores, incluindo `coletdjnz`, `dirkf`, `Grub4K`, `bashonly` e `seproDev`. Em janeiro de 2021, o yt-dlp já havia absorvido a base de colaboradores do youtube-dlc, tornando-se o fork dominante. O foco passou a ser em recursos e melhorias que o projeto original não havia incorporado.

Algumas informações sobre o projeto merecem destaque. O yt-dlp usa versionamento por calendário, então uma tag como `2026.03.17` é literalmente a data do lançamento. A licença é a Unlicense, uma declaração explícita de domínio público que nem mesmo a maioria dos projetos FOSS utiliza. O repositório tem 13.348 forks e 2.507 problemas em aberto. O Ubuntu 22.04 substituiu o youtube-dl pelo yt-dlp como seu programa padrão para baixar vídeos, e o Debian seguiu o exemplo com o bookworm. A lista de sites suportados em `supportedsites.md` atualmente lista mais de 1.500 entradas nomeadas; o próprio código-fonte inclui cerca de 1.800 módulos extratores com carregamento lento. Arch, Fedora, NixOS, Homebrew, Chocolatey, Scoop e Winget o incluem em seus pacotes. Vinte a trinta lançamentos por ano é o que impediu que as distribuições se adaptassem ao desenvolvimento mais lento do projeto original.

Como a remoção do yt-dlp pela RIAA em 2020 tornou o inevitável

A notificação DMCA da RIAA, datada de 23 de outubro de 2020, foi emitida com base no artigo 1201 do Título 17 do Código dos Estados Unidos, a cláusula anticircunvenção. A tese da RIAA era de que o youtube-dl burlava o mecanismo de assinatura "rolling cipher" do YouTube, que a RIAA considerou uma medida tecnológica para proteger o acesso a obras protegidas por direitos autorais. Inicialmente, o GitHub acatou a notificação e removeu o repositório juntamente com dezessete forks.

O que se seguiu foi um típico efeito Streisand. Os desenvolvedores republicaram o código-fonte de maneiras cada vez mais criativas, incluindo uma imagem no Twitter cujas cores em pixel codificavam toda a base de código. A Electronic Frontier Foundation enviou uma carta ao GitHub em 16 de novembro de 2020. Seu argumento técnico era simples: uma assinatura que qualquer navegador compatível com os padrões pode executar não é uma "medida tecnológica que efetivamente controla o acesso" nos termos do § 1201. O youtube-dl usa a assinatura; ele não a viola.

O GitHub restaurou o repositório no mesmo dia. Também prometeu um fundo de defesa de desenvolvedores de US$ 1 milhão e se comprometeu a realizar uma revisão técnica e jurídica manual de todas as remoções com base na Seção 1201 daqui para frente. O episódio catalisou a criação do yt-dlp. O repositório do novo fork aparece no histórico de commits três dias após a remoção. Ninguém sabia ainda se o GitHub voltaria atrás. Os desenvolvedores queriam uma garantia.

Instale o yt-dlp no Windows, macOS e Linux.

As pessoas se esquecem da segunda metade da instalação e depois se perguntam por que a etapa de mesclagem falha. O yt-dlp sozinho consegue extrair um único fluxo de qualquer um dos sites suportados, claro. Mas e o melhor vídeo com o melhor áudio? Capítulos incorporados? Uma remixagem de MP4? Tudo isso é silenciosamente delegado ao `ffmpeg` e ao `ffprobe`. Ignore esses dois e sua primeira tentativa com `bv*+ba/b` exibirá algo enigmático e falhará. Portanto: instale ambos, sempre.

Para Windows, eu escolho o winget. `winget install yt-dlp.yt-dlp`, depois `winget install Gyan.FFmpeg`. O Scoop funciona se você já o utiliza; o Chocolatey também. Se um gerenciador de pacotes parecer excessivo, o arquivo `yt-dlp.exe` independente está disponível no GitHub Releases — basta colocá-lo em uma pasta, adicionar a pasta ao PATH e pronto.

Usuários de Mac têm a versão fácil. `brew install yt-dlp ffmpeg`. Uma linha. Pronto.

A distribuição Linux varia. O repositório principal do Debian inclui o pacote. O Arch Linux o mantém no diretório `extra`. O Fedora o instala pelos canais padrão. O problema é o tempo: quando uma correção no YouTube é lançada, as versões das distribuições tendem a ficar defasadas em alguns dias. A solução é instalar o pacote via Python, que é a melhor maneira de baixar vídeos no mesmo dia após a correção: `python -m pip install -U yt-dlp` em qualquer sistema com Python 3.9 ou superior. Essa linha também atualiza o pacote no mesmo dia. A opção de usar curl e chmod ainda está na documentação (`sudo curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/local/bin/yt-dlp && sudo chmod +x /usr/local/bin/yt-dlp`), mas use-a apenas quando não houver uma opção no gerenciador de pacotes.

Após a instalação, o comando `yt-dlp -U` atualiza as cópias do pip e dos binários; ele ignora as cópias do gerenciador de pacotes propositalmente. Escolha um método de instalação e mantenha-se fiel a ele. O uso conjunto do ffmpeg e do ffprobe é imprescindível.

Comandos básicos do yt-dlp que você realmente usará.

O guia de referência mínimo é curto. O comando básico, `yt-dlp URL`, funciona para o caso mais comum. Tudo além disso requer uma ou duas opções.

Antes de baixar um vídeo do YouTube, execute `yt-dlp -F URL` para ver o que está disponível. A saída lista todos os formatos de vídeo, todos os fluxos de áudio e todos os fluxos pré-combinados encontrados pelo extrator, juntamente com os codecs e tamanhos dos arquivos. A maioria das pessoas então usa diretamente `yt-dlp -f "bv*+ba/b" URL`. Esse seletor significa "melhor vídeo mais melhor áudio; caso contrário, use o melhor fluxo combinado". Essa é a sintaxe principal de seleção de formato do yt-dlp e vale a pena memorizá-la. Adicione `--merge-output-format mp4` para forçar o formato do contêiner; adicione `-x --audio-format mp3` para áudio somente. Para legendas, `--write-subs --sub-langs en` utiliza as legendas oficiais, e `--write-auto-subs` utiliza a faixa gerada automaticamente quando não há legenda humana.

Para listas, `-a urls.txt` lê um URL por linha e é a maneira padrão de baixar vários vídeos de uma só vez. A opção `--playlist-items 1-10,15,20-` divide uma lista de reprodução. E `--download-archive seen.txt` mantém um registro dos downloads concluídos, para que novas execuções ignorem o que você já baixou. O arquivo de download é a maneira mais limpa de baixar listas de reprodução e canais inteiros incrementalmente, sem precisar baixá-los novamente. A nomenclatura dos arquivos de saída segue um modelo. A string `-o "%(channel)s/%(upload_date>%Y-%m-%d)s — %(title)s.%(ext)s"` gera nomes de arquivo com data e agrupados por canal na pasta escolhida. O resultado é compatível com as bibliotecas do Plex e do Jellyfin. A opção `-P` altera o diretório de destino. A opção `--restrict-filenames` mantém os nomes em ASCII para garantir a compatibilidade entre diferentes sistemas de arquivos. E `--print filename` exibe uma prévia do que o yt-dlp escreveria antes do início do processo de download.

Se um download "reproduz em vez de baixar", significa que seu navegador abriu o link antes que o yt-dlp o detectasse. Passe a URL como um argumento literal ou coloque-a entre aspas e execute o yt-dlp a partir do terminal.

Funcionalidades avançadas: pós-processadores, SponsorBlock, cookies

Além do básico, o yt-dlp possui uma superfície de recursos surpreendentemente ampla. As opções abaixo são as mais importantes na prática.

A integração com o SponsorBlock é útil. Essa opção utiliza o banco de dados da comunidade SponsorBlock, sinalizando marcadores de capítulo ou removendo completamente as seções de patrocinadores em vídeos do YouTube. A opção `--cookies-from-browser` lê cookies de perfis de navegador, incluindo contêineres do Firefox, sendo a maneira mais segura de baixar qualquer conteúdo protegido por assinatura ou paywall. Para arquivos de longa duração com terabytes, a transferência do downloader externo para o aria2c aumenta consideravelmente a velocidade de download em redes onde o gargalo é o processamento em janelas TCP. Além disso, a opção `--split-chapters` divide o conteúdo do vídeo por capítulo em arquivos separados, o que é prático quando um único upload agrupa várias palestras. O yt-dlp também suporta a opção `--video-multistreams` para combinar faixas de vídeo quando o site oferece múltiplas, embora isso seja raro na prática.

O sistema de plugins merece uma linha à parte. O yt-dlp detectará automaticamente os módulos Python localizados em `~/.yt-dlp/plugins/` (ou instalados via `pip` com o ponto de entrada `yt-dlp-plugins`) e os carregará como extratores ou pós-processadores. É assim que sites incomuns são suportados sem a necessidade de esperar por uma correção upstream. É também assim que os plugins do provedor PoToken, discutidos abaixo, se integram.

Situação do PoToken e do SABR em 2025-2026

O YouTube passou o ano de 2025 dificultando a vida do yt-dlp. Duas mudanças são o motivo pelo qual uma instalação perfeitamente funcional pode repentinamente começar a falhar em 2026.

O PoToken é o mais importante. Agora, cada solicitação de vídeo precisa de um Token de Prova de Origem (PoO). O token está vinculado ao vídeo, expira rapidamente e também está vinculado à sessão. A extração manual parou de funcionar há meses. O que funciona é um pequeno auxiliar chamado `bgutil-ytdlp-pot-provider` que roda em segundo plano; ele gera tokens sob demanda e a chamada principal do yt-dlp os captura automaticamente. O wiki do yt-dlp tem um guia chamado Guia do Token PO que explica a configuração passo a passo. Sem o auxiliar, as solicitações retornam com qualidade inferior ou simplesmente são bloqueadas, e o yt-dlp pode não funcionar corretamente mesmo em vídeos que foram reproduzidos no seu navegador trinta segundos antes.

SABR é a segunda parte. SABR é o sistema de taxa de bits adaptável do lado do servidor do YouTube e, a partir de 2025, o extrator `web` começou a retornar formatos exclusivos para SABR, o que quebra o caminho de download normal. A solução geralmente envolve uma dica no extractor-args e cookies de um navegador com sessão iniciada. Os tópicos que valem a pena acompanhar enquanto a correção é aprimorada são as issues #12482, #14307, #14390, #16082 e #13968. Resultado final: o yt-dlp ainda funciona na grande maioria do conteúdo público do YouTube, mas em 2026 um comando que "simplesmente funciona" muitas vezes se transformará em um comando que exige "provedor PoToken, cookies atualizados e um pouco de paciência".

Situação legal do yt-dlp em 2026: EUA, Alemanha, UE

A resposta jurídica é jurisdicional, e a principal conclusão é que nada foi definitivamente resolvido.

Nos Estados Unidos , nenhum tribunal se pronunciou especificamente sobre o yt-dlp. O episódio da RIAA em 2020 é o precedente mais próximo e terminou em uma reversão extrajudicial. A 9ª Regra Trienal Final da Seção 1201 do Escritório de Direitos Autorais dos EUA entrou em vigor em 28 de outubro de 2024 e vigora até 28 de outubro de 2027. Ela renovou isenções anteriores e adicionou uma para pesquisa de confiabilidade de IA, mas não criou uma isenção geral de evasão para arquivamento pessoal de vídeos. O problema estrutural da Seção 1201, que criminaliza ferramentas que acessam DRM independentemente da intenção, permanece.

Na Alemanha , a ação judicial girou em torno da responsabilidade dos provedores de hospedagem, e não do próprio software. O Tribunal Regional Superior de Hamburgo rejeitou o recurso da Uberspace, provedora de hospedagem do site `youtube-dl.org` em Mainz, em 27 de novembro de 2024. A decisão finalizou uma sentença de 2023 de um tribunal inferior, que estabeleceu a responsabilidade dos provedores de hospedagem por sites que anunciam ferramentas de burla. A doutrina não proíbe diretamente o yt-dlp, mas torna a hospedagem na Alemanha arriscada para qualquer projeto que anuncie abertamente recursos para burlar o sistema.

A nível da UE , a Lei dos Serviços Digitais padroniza os procedimentos de notificação e remoção de conteúdo (artigos 16-17), mas não regulamenta softwares de download. Não existe nenhuma norma em toda a UE que obrigue os provedores de hospedagem a bloquear o yt-dlp. O uso pessoal do yt-dlp em conteúdo próprio não é o ponto de pressão legal em nenhuma dessas jurisdições. O mesmo se aplica a conteúdo para o qual o criador concedeu permissão. O problema reside na distribuição e na interação com a proteção de streaming.

Interfaces gráficas de usuário (GUI) e o ecossistema de download em geral

Nem todos querem um terminal, e a linha de comando do yt-dlp não é um ponto forte de marketing. O yt-dlp é um dos muitos programas para baixar vídeos, mas ele funciona como o mecanismo subjacente da maioria das interfaces gráficas modernas para baixar vídeos. O Stacher é a interface gráfica multiplataforma mais refinada. O Tartube é uma alternativa em Python/GTK. O yt-dlg é um fork da comunidade específico para o yt-dlp. O Tube-Archivist é um servidor Docker auto-hospedado para arquivamento de canais; ele pode baixar vídeos de vários sites de acordo com uma programação. O YTDL-Material é um frontend web auto-hospedado. O ytdl-sub é uma ferramenta de configuração YAML declarativa popular entre os usuários que hospedam o Plex e o Jellyfin. O JDownloader 2 integra o yt-dlp por meio de um plugin. Cada ferramenta expõe sua própria interface de seleção de vídeo e painel de opções de download, mas o processamento pesado é feito pelo yt-dlp.

A regra básica: yt-dlp para downloads de arquivos, streamlink para transmissões ao vivo em um player e gallery-dl para sites com muitas imagens.

Segurança: onde baixar o yt-dlp e como identificar versões falsas

As únicas fontes seguras são as versões do GitHub, o PyPI (`pip install yt-dlp`), os pacotes de distribuição oficiais e os principais gerenciadores de pacotes do Windows (Winget, Scoop, Chocolatey). Sites de terceiros que baixam o yt-dlp incluem adware, mineradores ou binários modificados. O Windows Defender historicamente sinalizou o arquivo `yt-dlp.exe` empacotado pelo PyInstaller como `Trojan:Win32/Wacatac.B!ml` (problemas nº 7532 e nº 15415). Esses são falsos positivos heurísticos. Os bancos de dados de assinaturas geralmente são limpos em poucos dias. Pequenos projetos de código aberto como o yt-dlp sobrevivem graças a mantenedores voluntários. Doações em criptomoedas por meio de gateways como o Plisio são uma forma de apoio a colaboradores internacionais que não é bancarizada.

Um exemplo prático. Digamos que você queira baixar um vídeo do YouTube para o seu computador para uma apresentação. O comando é `yt-dlp -f "bv*+ba/b" --merge-output-format mp4 URL`, que retorna o formato de download correto. O yt-dlp é um fork com mais extratores que o youtube-dl, e muitos deles permitem baixar vídeos mesmo quando o original não funciona. O sistema de plugins do yt-dlp abrange fontes específicas e permite o uso do parâmetro `-a urls.txt` para baixar vídeos de diversos sites. Tudo o que é suportado pelo yt-dlp está listado em `supportedsites.md`.

Elisabeth McGowan

A freelance writer passionate about celebrities, net worth stories, athletes, and political figures. She transforms facts into engaging narratives. A true cheese lover and cycling enthusiast, she finds inspiration in motion and flavor.