O que é o yt-dlp?
O yt-dlp é um baixador de áudio e vídeo por linha de comando que dá conta de bem mais de mil sites. Começou como um fork do youtube-dl (passando pelo já inativo youtube-dlc) e hoje é o projeto de fato mantido entre os dois, com um seletor de formatos muito mais rico, integração com o SponsorBlock, suporte nativo para embutir legendas, capítulos e metadados, e um sistema de plugins para extratores próprios.
⚡ Principais recursos do yt-dlp
🌐 Milhares de sites
Mais de 1.700 extratores cobrindo plataformas de vídeo, emissoras, hospedagens de podcast e sites de notícias, além de um extrator genérico que encontra mídia em páginas para as quais ninguém escreveu um extrator.
🎚️ Seleção precisa de formato
-f e -S oferecem toda uma linguagem de expressões sobre resolução, codec, taxa de bits e contêiner, para pedir exatamente o fluxo que você quer em vez do padrão.
🎧 Extração de áudio
-x --audio-format mp3 retira a trilha de áudio e a recodifica; com --embed-thumbnail e --embed-metadata você obtém arquivos com tags que qualquer player entende.
💬 Legendas e capítulos
Baixe ou embuta legendas em qualquer idioma disponível, mantenha as automáticas e grave marcadores de capítulo direto no arquivo de saída — ou divida o arquivo por eles.
⏭️ SponsorBlock
Marque ou remova trechos patrocinados, aberturas e autopromoção já no download, usando a base do SponsorBlock, sem precisar de um editor depois.
🍪 Cookies e sessões
--cookies-from-browser lê uma sessão autenticada direto do Firefox ou do Chromium, para que conteúdo privado, com restrição de idade ou exclusivo para membros funcione.
apt upgrade mantém você na versão mais recente.
📦 Instalação a partir do deb.griffo.io
Passo 1: Adicionar o repositório
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
sudo apt updateinstall -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
apt updatePasso 2: Instalar o yt-dlp
# Instalar o yt-dlp mais recente
sudo apt install yt-dlp
# Verificar a instalação
yt-dlp --version# Instalar o yt-dlp mais recente
apt install yt-dlp
# Verificar a instalação
yt-dlp --versionPasso 3: Instalar o ffmpeg (fortemente recomendado)
# O yt-dlp precisa do ffmpeg para juntar fluxos separados de vídeo e áudio,
# extrair áudio e embutir legendas ou miniaturas
sudo apt install ffmpeg
# Os autocompletes de bash, zsh e fish vêm com o pacote —
# nada a configurar. Abra um novo shell e aperte Tab:
yt-dlp --embed-<Tab>
# A página de manual também é instalada
man yt-dlp# O yt-dlp precisa do ffmpeg para juntar fluxos separados de vídeo e áudio,
# extrair áudio e embutir legendas ou miniaturas
apt install ffmpeg
# Os autocompletes de bash, zsh e fish vêm com o pacote —
# nada a configurar. Abra um novo shell e aperte Tab:
yt-dlp --embed-<Tab>
# A página de manual também é instalada
man yt-dlp🎯 Exemplos básicos de uso
Downloads do dia a dia:
# Baixar um vídeo na melhor qualidade disponível
yt-dlp 'https://example.com/watch?v=...'
# O melhor MP4 até 1080p
yt-dlp -S 'res:1080,ext:mp4' 'URL'
# Somente áudio, como MP3 com tags
yt-dlp -x --audio-format mp3 --embed-thumbnail --embed-metadata 'URL'
# Ver todos os formatos oferecidos antes de escolher
yt-dlp -F 'URL'Legendas, capítulos e patrocínios:
# Embutir legendas em inglês, incluindo as automáticas
yt-dlp --embed-subs --sub-langs en --write-auto-subs 'URL'
# Gravar marcadores de capítulo no arquivo
yt-dlp --embed-chapters 'URL'
# Remover trechos patrocinados e aberturas já no download
yt-dlp --sponsorblock-remove sponsor,intro 'URL'
# Pegar apenas um trecho em vez do vídeo inteiro
yt-dlp --download-sections '*00:01:30-00:04:00' 'URL'Playlists, arquivos e automação:
# Uma playlist inteira, em pastas organizadas por autor
yt-dlp -o '%(uploader)s/%(title)s.%(ext)s' 'PLAYLIST_URL'
# Manter um canal sincronizado sem rebaixar o que já veio
yt-dlp --download-archive seen.txt 'CHANNEL_URL'
# Conteúdo privado ou com restrição de idade, usando a sessão do navegador
yt-dlp --cookies-from-browser firefox 'URL'
# Downloads mais rápidos via aria2c
yt-dlp --downloader aria2c --downloader-args aria2c:'-x 8 -s 8' 'URL'🔧 Integrações com outras ferramentas
O yt-dlp é o backend de download que muitos outros softwares esperam encontrar:
- ffmpeg: junção, remux, extração de áudio e embutimento dependem dele
- mpv: reproduz uma URL direto, entregando-a ao yt-dlp na hora
- aria2: baixador externo opcional para transferências paralelas e segmentadas
- Servidores de mídia: bibliotecas do Jellyfin, Kodi e Navidrome costumam ser preenchidas com modelos de saída do yt-dlp
- Arquivos de configuração: coloque suas opções habituais em
~/.config/yt-dlp/confige pare de redigitá-las
🚀 Por que escolher o deb.griffo.io?
- Ubuntu oficial: disponível, mas congelado na versão que veio com a release — meses atrás em correções de extratores
- pip / pipx: atualizado, mas fora do apt, e a PEP 668 torna o
pip installde sistema desconfortável no Ubuntu - deb.griffo.io: versão mais recente com atualizações automáticas
- ✅ Extratores funcionando: a versão mais nova, que é o que faz os downloads continuarem dando certo
- ✅ Sem configuração manual: sem pip, sem virtualenv, sem autoatualização escrevendo em
/usr/local/bin - ✅ Atualizações automáticas: pacotes atualizados poucas horas após cada release upstream
- ✅ Pacote completo: a build oficial do upstream, a página de manual
yt-dlp.1e autocompletes de bash, zsh e fish - ✅ Todas as arquiteturas: publicado como
Architecture: all, então amd64, arm64, armhf, riscv64 e as demais instalam o mesmo pacote - ✅ Multi-distribuição: funciona em Ubuntu 22.04, 24.04, 25.10 e 26.04
- ✅ Manutenção simples: comandos apt de sempre para atualizar
📦 Repositório de build do pacote
Os pacotes Ubuntu são construídos e mantidos automaticamente neste repositório do GitHub:
- 📺 yt-dlp-debian - Builds das versões mais recentes
🔗 Pacotes relacionados
Também disponíveis no deb.griffo.io:
- termusic - Player de música no terminal para tudo o que você baixar
- lowfi - Player minimalista de rádio lofi
- viu - Ver miniaturas e imagens no terminal
- Yazi - Gerenciador de arquivos no terminal para navegar sua coleção