Instalar o yt-dlp

Instale o yt-dlp e o ffmpeg no Windows, macOS ou Linux e confirme que a instalação funcionou.

Escolha seu sistema

Windows winget, Scoop ou um único .exe. macOS Homebrew ou pipx. Linux Gerenciador de pacotes, pipx ou o binário oficial.

Você quase certamente também precisa do ffmpeg

O yt-dlp baixa sem o ffmpeg, mas juntar vídeo e áudio separados, extrair MP3, embutir legendas ou capas e cortar trechos todos chamam o ffmpeg. Instalar logo evita uma primeira falha confusa.

Confira se a instalação funcionou

yt-dlp --version
ffmpeg -version

Perguntas frequentes

› Qual método de instalação devo escolher?

O do gerenciador de pacotes que você já usa. A única coisa que vale evitar é jogar o binário em qualquer lugar e esperar que o shell o encontre — é isso que produz "yt-dlp is not recognized".

› Eu realmente preciso do ffmpeg?

Para downloads simples, não. Para tudo que une vídeo e áudio, converte para MP3, embute legendas ou capas, ou corta um trecho — sim, e isso cobre a maior parte do que as pessoas querem.

› Como atualizo o yt-dlp?

Um binário independente se atualiza com yt-dlp -U. Se você instalou por um gerenciador de pacotes, atualize por ele; a autoatualização recusa modificar um arquivo que não é dela. Atualizar resolve mais problemas que qualquer flag.

› É seguro instalar o yt-dlp?

É um projeto de código aberto bem conhecido. Baixe da página oficial de releases ou de um gerenciador de pacotes em que você já confia, e desconfie de reuploads em sites de download aleatórios — é de lá que vêm os problemas.