Solução de Problemas yt-dlp no Windows — Erros Comuns e Correções

Causa: O site atualizou sua estrutura e o extractor do yt-dlp está desatualizado.

Correção: Execute yt-dlp -U para obter os extractors mais recentes. Essa é a correção mais comum para esse erro. Se persistir após atualizar, o site pode ter feito uma mudança maior — verifique a página de issues do GitHub por relatos.

Causa: FFmpeg não está instalado ou não está no lugar certo.

Correção: Coloque ffmpeg.exe na mesma pasta que yt-dlp.exe. yt-dlp procura lá primeiro. Verifique com ffmpeg -version no PowerShell. Veja o guia de configuração do FFmpeg.

Causa: PowerShell não consegue encontrar yt-dlp.exe porque a pasta não está no PATH.

Correção — opção 1: Navegue até a pasta com yt-dlp.exe no Explorer, clique na barra de endereço, digite powershell e pressione Enter. Execute yt-dlp a partir daí.

Correção — opção 2: Adicione a pasta do yt-dlp ao PATH. Veja o guia de instalação para instruções passo a passo.

Causa: O vídeo requer autenticação ou o YouTube está limitando a requisição.

Correção: Primeiro atualize o yt-dlp: yt-dlp -U. Se o vídeo requer login, passe os cookies do navegador: --cookies-from-browser chrome Substitua chrome por edge ou firefox conforme necessário. Se estiver usando VPN, tente sem ela — alguns nós de saída de VPN são bloqueados pelo YouTube.

Causa: Throttling de rede, conexão instável ou limitação de taxa do YouTube.

Correção: -N 4 --retries 10 --fragment-retries 10 --limit-rate 5M -N 4 habilita downloads de fragmentos paralelos. --limit-rate 5M limita a velocidade para evitar resets de conexão. Tente baixar em outro horário se o YouTube estiver limitando.

Causa: FFmpeg está faltando ou desatualizado.

Correção: Certifique-se que ffmpeg.exe está na mesma pasta que yt-dlp.exe e é um build recente. Atualize yt-dlp com yt-dlp -U. Em seguida tente novamente com: yt-dlp -f "bestvideo+bestaudio/best" "URL"

Causa: SmartScreen sinaliza executáveis portáteis não assinados por padrão — isso é um falso positivo.

Correção: Clique em Mais informações → Executar mesmo assim. O arquivo é o release oficial não modificado do GitHub. Você também pode clicar com botão direito em yt-dlp.exe → Propriedades → marcar Desbloquear na parte inferior → OK.

Causa: Windows ou antivírus bloqueou o arquivo baixado da internet.

Correção: Clique com botão direito em yt-dlp.exe → Propriedades → marque Desbloquear → OK. Se o antivírus estiver bloqueando, adicione uma exceção para o arquivo. Sempre baixe da página oficial de releases do GitHub.

Causa: O repositório de certificados do Windows está desatualizado, ou um proxy/VPN está interceptando HTTPS.

Correção: Atualize o Windows (Configurações → Windows Update), em seguida tente novamente. Se estiver atrás de um proxy corporativo, contate o suporte de TI. Como último recurso apenas: --no-check-certificate — não recomendado a longo prazo pois desabilita a validação de certificado.

Causa: O site não é suportado pelo yt-dlp, ou o formato da URL mudou.

Correção: Atualize o yt-dlp com yt-dlp -U. Verifique a lista de sites suportados. Certifique-se de usar a URL correta do vídeo — URLs de playlist e canal têm formatos diferentes.