Guía de configuración paso a paso para Windows, macOS y Linux.
yt-dlp es un potente descargador de medios por línea de comandos (un fork activamente mantenido de youtube-dl) que te permite descargar video y audio de miles de sitios web. Como se ejecuta en la terminal, no tiene interfaz gráfica nativa.
Para descargar vídeos de alta calidad (1080p, 4K, etc.) o extraer audio MP3, debes instalar FFmpeg. Se recomienda encarecidamente instalar un entorno de JavaScript como Deno. A continuación encontrarás la guía completa.
¿No quieres instalar software? Puedes ejecutar cualquier comando directamente en nuestra consola en línea sin ninguna configuración.
Windows 10 (1809+) y Windows 11 incluyen el Administrador de paquetes de Windows (winget) por defecto. Gestiona la instalación, rutas y actualizaciones automáticamente.
winget install yt-dlpPara usuarios avanzados que usan gestores de paquetes de línea de comandos en Windows.
scoop install yt-dlpchoco install yt-dlpDescargar el binario ejecutable independiente directamente.
C:\yt-dlp\, y mueve el yt-dlp.exe descargado dentro de ella.
C:\yt-dlp, luego haz clic en Aceptar en todas las ventanas de diálogo.Homebrew es el gestor de paquetes estándar para macOS. Resuelve todas las dependencias, incluyendo Python y FFmpeg, automáticamente.
brew install yt-dlpAlternativamente, puedes instalar yt-dlp usando el gestor de paquetes MacPorts.
sudo port install yt-dlpDescargar el binario compilado directamente en tu ruta de ejecución local.
sudo curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/local/bin/yt-dlp && sudo chmod a+rx /usr/local/bin/yt-dlpUsar el gestor pip de Python asegura que obtengas las últimas actualizaciones de scripts de extracción de video directamente.
python3 -m pip install -U yt-dlpInstalar yt-dlp mediante el gestor de paquetes de tu distribución Linux.
sudo apt update && sudo apt install yt-dlpsudo pacman -S yt-dlpsudo dnf install yt-dlpDescargar el binario independiente de Linux directamente en tu ruta de binarios ejecutables local.
sudo wget https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -O /usr/local/bin/yt-dlp && sudo chmod a+rx /usr/local/bin/yt-dlpFFmpeg es una biblioteca de medios de código abierto que yt-dlp usa internamente para combinar descargas separadas de pistas de video de alta definición (1080p, 4K) y pistas de audio, o para extraer audio como MP3. Sin FFmpeg, yt-dlp solo descargará streams de 720p o menor calidad con audio incorporado.
Usa winget para instalar FFmpeg con un comando:
winget install Gyan.FFmpegAlternativamente, descargue compilaciones de Gyan.dev, descomprima y agregue el directorio bin a su variable de entorno PATH.
Si usas Homebrew, se instala automáticamente. Instala manualmente con:
brew install ffmpegInstalar mediante tu gestor de paquetes del sistema:
Debian / Ubuntu:sudo apt install ffmpegsudo pacman -S ffmpegDeno es un entorno de ejecución de JavaScript moderno. yt-dlp usa Deno para ejecutar los algoritmos de firma basados en JavaScript de YouTube. Instalar Deno ayuda a yt-dlp a superar estos desafíos y mantener la máxima velocidad de descarga.
Usa winget para instalar Deno con un comando:
winget install DenoLand.DenoAlternativamente, usa Scoop: scoop install deno
Instalar Deno mediante Homebrew:
brew install denoInstalar Deno usando el script de shell oficial:
curl -fsSL https://deno.land/install.sh | shAsegúrate de que unzip y curl estén instalados antes de ejecutar este script.
Una vez instalado, abre tu terminal (PowerShell, Símbolo del sistema o Terminal.app) y verifica que todo funcione ejecutando el comando de verificación de versión.
Ejecuta el comando de consulta de versión en tu terminal:
yt-dlp --versionSi se instaló correctamente, mostrará un número de versión con fecha de lanzamiento como:
2026.06.18Si obtienes "Comando no encontrado", asegúrate de reiniciar tu terminal o verifica que la carpeta que contiene yt-dlp esté correctamente agregada a tu PATH de entorno del sistema.
¿Tienes problemas? Aquí están las soluciones para los errores más comunes de yt-dlp en Windows, macOS y Linux.
yt-dlp no está en tu PATH del sistema. Si instalaste mediante winget, Homebrew o pip, simplemente cierra y vuelve a abrir tu terminal — el PATH se actualiza solo para nuevas sesiones.
yt-dlp.exe manualmente, necesitas agregar su carpeta a tu variable de entorno PATH. Consulta los pasos detallados de configuración de PATH arriba.
yt-dlp --cookies-from-browser chrome "URL"winget install ffmpegyt-dlp -Uwinget upgrade yt-dlp o brew upgrade yt-dlp).
yt-dlp -U), ya que los desafíos de JavaScript de YouTube se actualizan con frecuencia.
yt-dlp.exe independiente se construye usando PyInstaller, que empaqueta un intérprete de Python en un solo ejecutable. El software antivirus a menudo marca los paquetes de PyInstaller porque la misma técnica de empaquetado es usada por algunos malware — pero yt-dlp en sí es completamente seguro.
winget install yt-dlp (los paquetes verificados por Microsoft no se marcan).
YouTube y otras plataformas de video actualizan sus protocolos de streaming frecuentemente, lo que puede causar que versiones anteriores de yt-dlp dejen de funcionar. Mantén tu instalación local actualizada para resolver errores de extracción automáticamente.
Si descargaste el binario directamente o instalaste mediante pip, ejecuta el comando de actualización integrado en tu terminal:
yt-dlp -UWindows (winget): winget upgrade yt-dlp
macOS (Homebrew): brew upgrade yt-dlp
Python (pip): python3 -m pip install --upgrade yt-dlp
Comienza con estos comandos básicos en tu terminal:
| Objetivo | Comando | Acciones |
|---|---|---|
| Descargar video (mejor calidad) | yt-dlp "https://www.youtube.com/watch?v=oHg5SJYRHA0" |
|
| Extraer audio MP3 | yt-dlp -x --audio-format mp3 "https://www.youtube.com/watch?v=oHg5SJYRHA0" |
|
Sí, yt-dlp es seguro. Es un proyecto 100% de código abierto bajo la licencia Unlicense, alojado en GitHub con más de 100,000 estrellas y cientos de contribuidores activos. Cada línea de código es auditable públicamente.
winget para evitar esto.Si prefieres no ejecutar archivos ejecutables localmente, nuestra consola en línea ejecuta yt-dlp en nuestros servidores — no se instala nada en tu dispositivo.
100K+ ⭐
Código abierto en GitHub
Ejecuta tus comandos de yt-dlp directamente en nuestro servidor. Usa nuestra interfaz web para descargar listas, grabar streams y extraer audio al instante.