O yt-dlp é o sucessor espiritual e tecnicamente superior do antigo youtube-dl. A ferramenta definitiva para baixar vídeos e áudios de quase qualquer plataforma (YouTube, Vimeo, Twitch, Twitter, etc.), oferecendo maior velocidade e correções constantes para contornar restrições das plataformas.
Aqui está o roteiro definitivo para instalar, configurar e dominar o yt-dlp no seu sistema Debian.
1 – Instalação: O jeito certo
Embora o Debian possua o yt-dlp nos repositórios oficiais (apt install yt-dlp), as versões do repositório costumam ficar datadas rapidamente. Como as plataformas de vídeo mudam o código com frequência, recomenda-se a instalação manual do binário para garantir atualizações imediatas.
Passo 1: Instalar Dependências
O yt-dlp precisa do FFmpeg para fundir vídeo e áudio em alta qualidade e do curl para o download.
sudo apt update && sudo apt install ffmpeg curl python3 nodejs -yPasso 2: Baixar o Binário
sudo curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/local/bin/yt-dlp
sudo chmod a+rx /usr/local/bin/yt-dlpPasso 3: Testar a Instalação
yt-dlp --version2 – Comandos Essenciais (Uso Prático)
Aqui estão os cenários mais comuns do dia a dia:
Baixar o vídeo na melhor qualidade disponível:
yt-dlp "URL_DO_VÍDEO"Extrair apenas o Áudio (MP3)
O comando abaixo extrai o áudio e converte para MP3 com qualidade alta.
yt-dlp -x --audio-format mp3 --audio-quality 0 "URL_DO_VÍDEO"Escolher formato específico
Às vezes você quer um arquivo leve (ex: 720p) em vez de um 4K pesado. Use o -F para listar e o -f para baixar:
- Listar formatos: yt-dlp -F “URL”
- Baixar pelo ID: yt-dlp -f 22 “URL” (onde 22 é o código visto na lista).
Baixar Playlists Inteiras
O yt-dlp faz isso automaticamente ao receber o link da playlist, mas você pode organizar melhor:
yt-dlp -o "%(playlist_index)s - %(title)s.%(ext)s" "URL_DA_PLAYLIST"
yt-dlp -x --audio-format mp3 --download-archive arquivos_baixados.txt "URL_DA_PLAYLIST"3 – Automatizando com Arquivo de Configuração
Em vez de digitar comandos gigantes toda vez, você pode criar um arquivo de configuração no Debian em ~/.config/yt-dlp/config.
Exemplo de configuração recomendada:
# Salvar sempre na pasta Downloads
-o ~/Downloads/%(title)s.%(ext)s
# Sempre baixar legendas em português (se disponíveis)
--write-subs
--sub-langs "pt.*"
# Mesclar no formato mkv ou mp4
--merge-output-format mkv4 – Dicas Avançadas para Debian
Como você instalou manualmente em /usr/local/bin, basta rodar:
sudo yt-dlp -USites como YouTube e Instagram podem bloquear downloads excessivos ou exigir login para vídeos com restrição de idade. Você pode passar seus cookies do navegador para o yt-dlp:
- Instale a extensão “Get cookies.txt” no seu Chrome/Firefox.
- Exporte o arquivo como cookies.txt.
- Use no comando: yt-dlp –cookies ./cookies.txt “URL”
Limitar a velocidade
Se você não quer que o download “mate” a internet da sua casa:
yt-dlp --rate-limit 1M "URL"Resumo de Flags Úteis
| Flag | Descrição |
| -U | Atualiza o programa para a última versão. |
| –list-subs | Lista todas as legendas disponíveis para o vídeo. |
| –embed-subs | Embutir a legenda dentro do arquivo de vídeo. |
| –thumbnail | Baixa a imagem de capa do vídeo. |
| -i | Ignora erros (útil para não parar o download de uma playlist se um vídeo cair). |
Nota:
Lembre-se sempre de respeitar os direitos autorais e os termos de serviço das plataformas ao utilizar esta ferramenta. No Debian, o yt-dlp é uma faca suíça: poderosa, mas exige responsabilidade!
Ilustrações
SVG REPO
Disponível em: https://www.svgrepo.com/svg/373383/video-opened
Acesso em: 04 abr. 2026.
Referências
GITHUB – Fonte Oficial do Projeto (Principal)
Disponível em: https://github.com/yt-dlp/yt-dlp
Acesso em: 04 abr. 2026.