Preciso de direitos de administrador para instalar yt-dlp no Windows?

Não. yt-dlp.exe é totalmente portátil. Administrador só é necessário para adicionar a pasta ao PATH do sistema para todos os usuários.

Como adiciono yt-dlp ao PATH no Windows?

Abra o menu Iniciar, pesquise Variáveis de Ambiente, clique em Editar variáveis de ambiente do sistema, abra Path em Variáveis do usuário, clique em Novo e cole o caminho da pasta (ex.: C:\Tools\yt-dlp), depois clique em OK. Reinicie o terminal.

Como atualizo o yt-dlp no Windows?

Execute yt-dlp -U no PowerShell. Isso baixa e substitui o executável pelo último release automaticamente.

Por que preciso de FFmpeg com yt-dlp?

O YouTube entrega vídeo 4K e 8K como streams separados de vídeo e áudio. O FFmpeg os mescla em um único arquivo. Também é necessário para conversões de MP3 e outros formatos de áudio.

PowerShell diz que yt-dlp não é reconhecido?

Execute yt-dlp da mesma pasta onde está yt-dlp.exe, ou adicione essa pasta ao PATH. Após adicionar ao PATH, feche e reabra o terminal.

Como Instalar yt-dlp no Windows — Guia Passo a Passo 2026

Instalação passo a passo

Como instalar yt-dlp no Windows em 6 passos

Funciona no Windows 11 e Windows 10 (64-bit). Sem assistente de instalação, sem direitos de administrador.

Passo 01

Baixar yt-dlp.exe

Vá à página de download e salve yt-dlp.exe do release oficial do GitHub.

Passo 02

Salvar em uma pasta dedicada

Mova o arquivo para um local permanente, ex.: C:\Tools\yt-dlp\. Evite Downloads — arquivos ali podem ser limpos automaticamente.

Passo 03

Abrir PowerShell nessa pasta

No Explorer, clique na barra de endereço, digite powershell e pressione Enter. O PowerShell abre já na pasta correta.

Passo 04

Verificar se funciona

Execute yt-dlp --version. Deve aparecer um número de versão como 2025.xx.xx. Se sim, está funcionando.

Passo 05

Atualizar para a versão mais recente

Execute yt-dlp -U. Ele baixa e se substitui pelo release mais novo. Faça isso regularmente.

Passo 06

Instalar FFmpeg (recomendado)

Baixe ffmpeg.exe e coloque na mesma pasta. Necessário para mesclar 4K/8K e MP3. Guia completo →

Opcional mas recomendado

Como adicionar yt-dlp ao PATH no Windows

Adicionar yt-dlp ao PATH permite executar yt-dlp de qualquer pasta no PowerShell ou CMD — sem precisar navegar até a pasta do yt-dlp toda vez.

Método pela interface gráfica (recomendado)

Pressione Win e pesquise Variáveis de Ambiente
Clique em Editar as variáveis de ambiente do sistema
Em Variáveis do usuário, selecione Path → Editar
Clique em Novo e cole o caminho da pasta, ex.: C:\Tools\yt-dlp
Clique OK em todos os diálogos, depois reinicie o terminal

Método pelo PowerShell

Execute isso uma vez no PowerShell — define o PATH só para seu usuário, sem precisar de administrador:

setx PATH "%PATH%;C:\Tools\yt-dlp"

Feche e reabra o PowerShell após executar. Depois teste com yt-dlp --version de qualquer diretório.

Observação: Se aparecer "yt-dlp não é reconhecido" após adicionar ao PATH, feche todas as janelas do terminal e reabra — alterações no PATH só têm efeito em novas sessões.

Verificações pós-instalação

Verificar instalação e manter yt-dlp atualizado

Execute estes comandos após a configuração para confirmar que tudo funciona.

Verificar versão instalada

yt-dlp --version

Atualizar para o último release

yt-dlp -U

Testar com um download real (melhor qualidade)

yt-dlp "https://www.youtube.com/watch?v=VIDEO_ID"

Se yt-dlp não estiver no PATH — execute direto da pasta

C:\Tools\yt-dlp\yt-dlp.exe --version

Altamente recomendado

Configurar FFmpeg para yt-dlp no Windows

FFmpeg é uma ferramenta gratuita que o yt-dlp usa para mesclar streams de vídeo e áudio. Sem ele, downloads em 4K/8K e conversão para MP3 não funcionarão.

O que FFmpeg habilita

Downloads de vídeo em 4K e 8K (streams separados mesclados)
Extração de áudio MP3, AAC, FLAC, Opus
Processamento de formato de vídeo HDR
Incorporar legendas em arquivos MKV

Configuração rápida

Baixe ffmpeg.exe pelo guia do FFmpeg
Coloque ffmpeg.exe na mesma pasta que yt-dlp.exe
yt-dlp detecta automaticamente — sem configuração necessária

Guia completo de configuração do FFmpeg para Windows →

Problemas comuns

Solução de problemas na instalação do yt-dlp no Windows

Aviso do SmartScreen do Windows ao executar yt-dlp.exe

Clique em Mais informações → Executar mesmo assim. O SmartScreen sinaliza novos executáveis por padrão. yt-dlp.exe é o release oficial open source do GitHub sem modificações.

"yt-dlp não é reconhecido" no PowerShell

Duas opções: execute yt-dlp diretamente da sua pasta, ou adicione a pasta ao PATH (veja a seção acima). Após adicionar ao PATH, feche todas as janelas do terminal e reabra.

"Acesso negado" ou arquivo bloqueado

Clique com botão direito em yt-dlp.exe → Propriedades → na parte inferior marque Desbloquear se a caixa aparecer → clique OK. Isso remove a restrição "baixado da internet" do Windows.

Download 4K/8K retorna só vídeo ou só áudio

FFmpeg não está instalado ou não foi encontrado. Coloque ffmpeg.exe na mesma pasta que yt-dlp.exe. yt-dlp o detectará automaticamente e mesclará os streams.

yt-dlp -U diz "already up to date" mas estou em uma versão antiga

Execute o PowerShell como administrador e tente novamente. Ou baixe o último yt-dlp.exe manualmente da página de download e substitua o arquivo antigo.

Mais problemas? Guia completo de solução de problemas do yt-dlp →

Como Baixar e Instalar yt-dlp no Windows — Guia Passo a Passo 2026