Guia de configuração passo a passo para Windows, macOS e Linux.
yt-dlp é um poderoso downloader de mídia de linha de comando (um fork do youtube-dl mantido ativamente) que permite baixar vídeo e áudio de milhares de sites. Como roda no terminal, não possui interface gráfica nativa.
Para baixar vídeos de alta qualidade (1080p, 4K etc.) ou extrair áudio MP3, você precisa instalar o FFmpeg. Além disso, instalar um runtime JavaScript como o Deno é altamente recomendado para contornar a limitação de velocidade e os bloqueios de bots do YouTube. Abaixo está o guia completo para configurar essas ferramentas no seu dispositivo.
Não quer instalar software? Você pode executar qualquer comando diretamente no nosso console online sem nenhuma configuração.
O Windows 10 (1809+) e o Windows 11 incluem o Gerenciador de Pacotes do Windows (winget) por padrão. Ele gerencia instalação, caminhos e atualizações automaticamente.
winget install yt-dlpPara usuários avançados que usam gerenciadores de pacotes de linha de comando no Windows.
scoop install yt-dlpchoco install yt-dlpBaixe diretamente o binário executável independente.
C:\yt-dlp\, e mova o yt-dlp.exe baixado para dentro dela.
C:\yt-dlp, depois clique em OK em todas as janelas de diálogo.O Homebrew é o gerenciador de pacotes padrão do macOS. Ele resolve todas as dependências, incluindo Python e FFmpeg, automaticamente.
brew install yt-dlpComo alternativa, você pode instalar o yt-dlp usando o gerenciador de pacotes MacPorts.
sudo port install yt-dlpBaixe o binário compilado diretamente no seu caminho de execução local.
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-dlpUsar o gerenciador pip do Python garante que você obtenha as atualizações mais recentes dos scripts extratores de vídeo diretamente.
python3 -m pip install -U yt-dlpInstale o yt-dlp através do gerenciador de pacotes da sua distribuição Linux.
sudo apt update && sudo apt install yt-dlpsudo pacman -S yt-dlpsudo dnf install yt-dlpBaixe o binário independente do Linux diretamente no seu caminho local de binários executáveis.
sudo wget 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-dlpO FFmpeg é uma biblioteca de mídia de código aberto que o yt-dlp usa internamente para mesclar downloads separados de faixa de vídeo em alta definição (1080p, 4K) e faixa de áudio, ou para extrair áudio como MP3. Sem o FFmpeg, o yt-dlp só baixará streams de 720p ou qualidade inferior com áudio embutido.
Use o winget para instalar o FFmpeg com um único comando:
winget install Gyan.FFmpegAlternativamente, baixe builds em Gyan.dev, descompacte e adicione a pasta bin à sua variável de ambiente PATH.
Se você usa o Homebrew, ele é instalado automaticamente. Instale manualmente com:
brew install ffmpegInstale por meio do gerenciador de pacotes do seu sistema:
Debian / Ubuntu:sudo apt install ffmpegsudo pacman -S ffmpegO Deno é um runtime JavaScript moderno. O yt-dlp usa o Deno internamente para executar os algoritmos de descriptografia de assinatura baseados em JavaScript do YouTube. Instalar o Deno ajuda a contornar a limitação de velocidade de download e os bloqueios de detecção de bots "n-challenge" do YouTube.
Use o winget para instalar o Deno com um único comando:
winget install DenoLand.DenoAlternativamente, use Scoop: scoop install deno
Instalar o Deno via Homebrew:
brew install denoInstale o Deno usando o script de shell oficial:
curl -fsSL https://deno.land/install.sh | shCertifique-se de que unzip e curl estén instalados antes de executar este script.
Após a instalação, abra seu terminal (PowerShell, Prompt de Comando ou Terminal.app) e verifique se tudo está funcionando executando o comando de verificação de versão.
Execute o comando de consulta de versão no seu terminal:
yt-dlp --versionSe instalado com sucesso, ele exibirá um número de versão com data de lançamento, como:
2026.06.18Se aparecer "Comando não encontrado", reinicie o terminal ou verifique se a pasta foi adicionada corretamente ao PATH.
Está com problemas? Aqui estão as correções para os erros mais comuns do yt-dlp no Windows, macOS e Linux.
yt-dlp não está no PATH do sistema. Se você instalou via winget, Homebrew ou pip, basta fechar e reabrir o terminal — o PATH é atualizado apenas para novas sessões.
yt-dlp.exe manualmente, precisa adicionar a pasta dele à variável de ambiente PATH. Veja os passos detalhados de configuração do PATH acima.
yt-dlp --cookies-from-browser chrome "URL"winget install ffmpegyt-dlp -Uwinget upgrade yt-dlp ou brew upgrade yt-dlp).
yt-dlp -U), pois os métodos de contorno da limitação são atualizados com frequência.
yt-dlp.exe independente é construído com o PyInstaller, que empacota um interpretador Python em um único executável. Softwares antivírus costumam sinalizar pacotes PyInstaller porque a mesma técnica de empacotamento é usada por alguns malwares — mas o yt-dlp em si é completamente seguro.
winget install yt-dlp (pacotes verificados pela Microsoft não são sinalizados).
O YouTube e outras plataformas de vídeo atualizam seus protocolos de streaming com frequência, o que pode fazer versões antigas do yt-dlp pararem de funcionar. Mantenha sua instalação local atualizada para resolver erros de extração automaticamente.
Se você baixou o binário diretamente ou instalou via pip, execute o comando de atualização integrado no seu terminal:
yt-dlp -UWindows (winget): winget upgrade yt-dlp
macOS (Homebrew): brew upgrade yt-dlp
Python (pip): python3 -m pip install --upgrade yt-dlp
Comece com estes comandos básicos no seu terminal:
| Objetivo | Comando | Ações |
|---|---|---|
| Baixar vídeo (melhor qualidade) | yt-dlp "https://www.youtube.com/watch?v=oHg5SJYRHA0" |
|
| Extrair áudio MP3 | yt-dlp -x --audio-format mp3 "https://www.youtube.com/watch?v=oHg5SJYRHA0" |
|
Sim, o yt-dlp é seguro. É um projeto 100% de código aberto sob a licença Unlicense, hospedado no GitHub com 100.000+ estrelas e centenas de contribuidores ativos. Cada linha de código é auditável publicamente.
winget para evitar isso.Si prefieres no executar arquivos ejecutables localmente, nossa console online executa yt-dlp em nossos servidores — nada é instalado no seu dispositivo.
100K+ ⭐
Código aberto no GitHub
Ejecuta seus comandos de yt-dlp directamente en nosso servidor. Use nossa interfaz web para baixar listas, grabar streams e extraer audio al instante.