Solución de Problemas yt-dlp en Windows — Errores Comunes y Soluciones

Causa: El sitio ha actualizado su estructura y el extractor de yt-dlp está desactualizado.

Solución: Ejecuta yt-dlp -U para obtener los últimos extractores. Esta es la solución más habitual para este error. Si persiste tras la actualización, el sitio puede haber hecho un cambio importante — consulta la página de issues de GitHub para ver informes.

Causa: FFmpeg no está instalado o no está en el lugar correcto.

Solución: Coloca ffmpeg.exe en la misma carpeta que yt-dlp.exe. yt-dlp busca allí primero. Verifica con ffmpeg -version en PowerShell. Consulta la guía de configuración de FFmpeg.

Causa: PowerShell no puede encontrar yt-dlp.exe porque la carpeta no está en el PATH.

Solución — opción 1: Navega hasta la carpeta con yt-dlp.exe en el Explorador, haz clic en la barra de direcciones, escribe powershell y pulsa Enter. Ejecuta yt-dlp desde allí.

Solución — opción 2: Añade la carpeta de yt-dlp al PATH. Consulta la guía de instalación para instrucciones paso a paso.

Causa: El vídeo requiere autenticación o YouTube está limitando la solicitud.

Solución: Primero actualiza yt-dlp: yt-dlp -U. Si el vídeo requiere inicio de sesión, pasa las cookies del navegador: --cookies-from-browser chrome Sustituye chrome por edge o firefox según sea necesario. Si usas una VPN, prueba sin ella — algunos nodos de salida de VPN son bloqueados por YouTube.

Causa: Throttling de red, conexión inestable o limitación de velocidad de YouTube.

Solución: -N 4 --retries 10 --fragment-retries 10 --limit-rate 5M -N 4 activa las descargas de fragmentos paralelas. --limit-rate 5M limita la velocidad para evitar reinicios de conexión. Intenta descargar en otro momento si YouTube está limitando.

Causa: FFmpeg no está instalado o está desactualizado.

Solución: Asegúrate de que ffmpeg.exe está en la misma carpeta que yt-dlp.exe y es un build reciente. Actualiza yt-dlp con yt-dlp -U. Luego vuelve a intentarlo con: yt-dlp -f "bestvideo+bestaudio/best" "URL"

Causa: SmartScreen señala ejecutables portátiles no firmados por defecto — es un falso positivo.

Solución: Haz clic en Más información → Ejecutar de todos modos. El archivo es el release oficial no modificado de GitHub. También puedes hacer clic derecho en yt-dlp.exe → Propiedades → marcar Desbloquear en la parte inferior → Aceptar.

Causa: Windows o el antivirus ha bloqueado el archivo descargado de internet.

Solución: Haz clic derecho en yt-dlp.exe → Propiedades → marca Desbloquear → Aceptar. Si el antivirus lo bloquea, añade una excepción para el archivo. Descarga siempre desde la página oficial de releases de GitHub.

Causa: El almacén de certificados de Windows está desactualizado, o un proxy/VPN está interceptando HTTPS.

Solución: Actualiza Windows (Configuración → Windows Update), luego vuelve a intentarlo. Si estás detrás de un proxy corporativo, contacta con tu equipo de IT. Como último recurso únicamente: --no-check-certificate — no recomendado a largo plazo ya que deshabilita la validación de certificados.

Causa: El sitio no está soportado por yt-dlp, o el formato de URL ha cambiado.

Solución: Actualiza yt-dlp con yt-dlp -U. Comprueba la lista de sitios compatibles. Asegúrate de usar la URL correcta del vídeo — las URLs de playlist y canal tienen formatos distintos.