Ir para o conteúdo
yt-dlp

Instalar o yt-dlp no Windows

Instale o yt-dlp e o ffmpeg no Windows com winget, Scoop ou download direto, e resolva os erros de PATH que vêm depois.

1. Instalar o yt-dlp

O winget já vem no Windows 10 e 11 e cuida do PATH por você, que é justamente a parte que as pessoas erram ao instalar na mão.

winget install yt-dlp.yt-dlp

Se você já usa Scoop ou Chocolatey, qualquer um dos dois serve igualmente bem:

scoop install yt-dlp
choco install yt-dlp

O caminho manual é um único yt-dlp.exe da página oficial de versões. Coloque numa pasta que esteja no seu PATH — deixar na Área de Trabalho só funciona enquanto o terminal por acaso estiver naquela pasta, e essa é a causa habitual de "yt-dlp is not recognized".

2. Instalar o ffmpeg

O yt-dlp baixa sem o ffmpeg, mas tudo que é interessante precisa dele: juntar vídeo e áudio separados, extrair MP3, embutir legendas ou miniaturas, cortar trechos. Instale agora, e não depois da primeira falha confusa.

winget install Gyan.FFmpeg

3. Conferir se funcionou

Abra um terminal novo — um já aberto ainda tem o PATH antigo — e rode:

yt-dlp --version
ffmpeg -version

Dois números de versão significam que acabou.

Aspas no Windows

PowerShell e cmd não usam aspas como o bash, e um comando copiado de um tutorial voltado para Linux quebra com frequência exatamente por isso. No PowerShell, aspas simples são literais — a escolha mais segura para um seletor de formato ou um modelo de saída. No cmd, use aspas duplas. Num arquivo .bat, cada % precisa ser duplicado.

yt-dlp -o '%(title)s.%(ext)s' URL     # PowerShell
yt-dlp -o "%(title)s.%(ext)s" URL     # cmd
yt-dlp -o "%%(title)s.%%(ext)s" URL   # inside a .bat file

O seletor de shell do gerador produz a forma certa para cada um desses casos, então você pode copiar sem reescrever nada.

Atualizar

Um yt-dlp.exe independente se atualiza sozinho com yt-dlp -U. Instalado via winget, Scoop ou Chocolatey, atualize pela mesma ferramenta — a autoatualização vai recusar, porque o arquivo pertence ao gerenciador de pacotes.

Perguntas frequentes

O Windows diz que yt-dlp não é reconhecido. Por quê?
O executável não está no PATH, ou o terminal já estava aberto antes da instalação. Abra um terminal novo; se não resolver, instale por winget ou Scoop, que cuidam do PATH por você.
O yt-dlp não encontra o ffmpeg no Windows.
Instale com winget install Gyan.FFmpeg, abra um terminal novo e confira com ffmpeg -version. Colocar o ffmpeg.exe na mesma pasta do yt-dlp.exe também funciona.