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 videos de alta calidad (1080p, 4K, etc.) o extraer audio MP3, debes instalar FFmpeg. Además, se recomienda encarecidamente instalar un entorno de ejecución JavaScript como Deno para evitar la limitación de velocidad y los bloqueos de bots de YouTube. A continuación se encuentra la guía completa para configurar estas herramientas en tu dispositivo.
¿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 JavaScript moderno. yt-dlp usa Deno internamente para ejecutar los algoritmos de descifrado de firma basados en JavaScript de YouTube. Instalar Deno ayuda a evitar la limitación de velocidad de descarga de YouTube y los bloqueos de detección de bots "n-challenge".
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 métodos para evitar la limitación se actualizan frecuentemente.
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.