Solução de problemas do yt-dlp (Windows)
Corrija problemas comuns no Windows: mesclagens do FFmpeg, erros de análise, login/cookies, velocidades lentas, SSL, SmartScreen, PATH e mais. Comece com Atualizar e verificar abaixo.
1) Atualizar e verificar
- ‘Unable to extract …’ geralmente significa que você precisa dos extratores mais recentes. Execute
yt-dlp -Ue tente novamente. - Liste os formatos para verificar disponibilidade: yt-dlp -F "URL"
2) FFmpeg e erros de mesclagem
- ffmpeg não encontrado / sem mesclagem: Coloque o ffmpeg.exe ao lado do yt-dlp.exe ou adicione o FFmpeg ao PATH.
- Use streams separados: -f "bestvideo+bestaudio/best"
- Teste a mesclagem: ffmpeg -version
3) Formatos e compatibilidade
- Prefira MP4/H.264: -f "bestvideo[ext=mp4][vcodec*=h264]+bestaudio[ext=m4a]/best[ext=mp4]"
- Limite a 1080p: -f "bestvideo[height<=1080]+bestaudio/best"
4) Autenticação e vídeos restritos
- Login necessário: --cookies-from-browser chrome (ou edge/firefox)
- Use apenas para conteúdo ao qual você tem permissão de acesso.
5) Velocidade lenta ou instável
- Concorrência: -N 4 (tente 4–8)
- Estabilize: --limit-rate 5M
- Novas tentativas: --retries 10 --fragment-retries 10
6) Problemas específicos do Windows
- ‘yt-dlp’ não reconhecido: Execute a partir da pasta dele ou adicione ao PATH.
- SmartScreen: Mais informações → Executar assim mesmo (lançamento oficial do GitHub vinculado).
- Acesso negado / bloqueado: Propriedades do arquivo → Desbloquear; verifique o antivírus.
7) Erros de SSL e certificado
- Atualize os certificados do Windows e tente novamente.
- Em último caso: --nocheck-certificate (não recomendado a longo prazo).
Diagnóstico avançado
Verifique os logs para mensagens de erro exatas. Atualize o yt-dlp e confirme o FFmpeg antes de depurar mais a fundo.
Perguntas frequentes (FAQ)
403/410 após muitas tentativas?
Espere e tente mais tarde, evite novas tentativas agressivas e considere usar sua própria conexão sem proxies/VPNs que possam estar limitando.
“URL não suportada”?
O site pode não ser suportado ou exigir atualização. Execute yt-dlp -U e verifique -F para os formatos.
Somente áudio e sem vídeo?
Use bestvideo+bestaudio e certifique-se de que o FFmpeg está presente para a mesclagem.
Legalidade e segurança
O yt-dlp é open source e seguro. Baixe apenas conteúdo ao qual você tenha direitos e siga os Termos de Serviço de cada site. Nós apontamos para o lançamento oficial no GitHub.
Próximos passos: Resumo de comandos • Configuração do FFmpeg • Guia 4K/8K