yt-dlp: descargar vídeos y audio desde YouTube y otras plataformas
yt-dlp es una herramienta gratuita y de código abierto que permite descargar vídeos, audio y listas de reproducción desde YouTube y numerosas plataformas de Internet. Funciona principalmente mediante la línea de comandos y ofrece opciones avanzadas para seleccionar la calidad, elegir formatos, extraer audio y gestionar descargas.
Desarrollado como una evolución de youtube-dl, yt-dlp incorpora mejoras en la selección de formatos, el procesamiento multimedia y la compatibilidad con distintos servicios. Está disponible para Windows, Linux y macOS, y puede utilizarse tanto de forma independiente como integrado en otras aplicaciones.
¿Qué es yt-dlp y para qué sirve?
yt-dlp es un descargador multimedia escrito en Python que utiliza extractores específicos para obtener información y localizar los archivos de vídeo o audio disponibles en diferentes sitios web.
A diferencia de los descargadores convencionales con interfaz gráfica, yt-dlp se controla mediante comandos. Esto permite automatizar tareas, personalizar las descargas y utilizarlo en scripts o aplicaciones externas.
Entre sus principales aplicaciones destacan:
- Descargar vídeos en distintas resoluciones y formatos.
- Extraer audio de vídeos y convertirlo a formatos como MP3.
- Descargar listas de reproducción completas o elementos seleccionados.
- Obtener subtítulos, miniaturas y metadatos.
- Seleccionar pistas de vídeo y audio por separado.
- Reanudar descargas interrumpidas cuando el servidor lo permite.
- Automatizar descargas mediante scripts.
Aunque su nombre está relacionado con YouTube, no se limita a esta plataforma. Incluye extractores para numerosos servicios de vídeo, audio y retransmisiones, aunque su funcionamiento depende de las características y restricciones de cada sitio.
Características principales de yt-dlp
Descarga de vídeos en diferentes calidades
yt-dlp permite consultar los formatos disponibles para un vídeo y seleccionar la resolución, el códec o la combinación de audio y vídeo que se desea descargar.
Cuando una plataforma proporciona las pistas de audio y vídeo por separado, el programa puede descargarlas individualmente y combinarlas mediante FFmpeg.
Esto resulta especialmente útil para obtener vídeos de alta resolución cuando no existe un archivo único que incluya imagen y sonido.
Extracción y conversión de audio
El programa permite descargar únicamente la pista de audio, evitando obtener el vídeo completo cuando no es necesario.
También puede convertir el audio a formatos como MP3, AAC, FLAC, WAV u Opus mediante FFmpeg.
La conversión no mejora la calidad del archivo original: únicamente modifica su formato de almacenamiento y, dependiendo de la configuración, puede implicar una pérdida adicional de calidad.
Descarga de listas de reproducción
yt-dlp puede procesar listas de reproducción completas, descargar determinados elementos o excluir vídeos que ya se hayan descargado anteriormente.
Además, permite utilizar plantillas para organizar automáticamente los archivos por título, canal, identificador u otros metadatos disponibles.
Subtítulos, miniaturas y metadatos
Otra característica es la posibilidad de descargar información adicional asociada a los vídeos.
Entre las opciones disponibles se encuentran:
- Subtítulos originales y, cuando existan, subtítulos generados automáticamente.
- Miniaturas publicadas por la plataforma.
- Títulos, descripciones y otros metadatos.
- Información sobre capítulos.
- Integración de metadatos en archivos multimedia compatibles.
La disponibilidad de estos elementos depende del contenido y del servicio utilizado.
Integración con FFmpeg
FFmpeg es una de las herramientas complementarias más importantes para yt-dlp.
Se utiliza para combinar pistas independientes de vídeo y audio, convertir formatos, extraer sonido y realizar determinadas operaciones de posprocesamiento.
Aunque yt-dlp puede realizar algunas descargas sin FFmpeg, instalarlo amplía considerablemente sus posibilidades.
Automatización de descargas
Al funcionar mediante comandos, yt-dlp puede integrarse en archivos por lotes de Windows, scripts de PowerShell y scripts de shell en Linux o macOS.
También permite utilizar archivos de configuración para establecer preferencias habituales sin tener que escribir las mismas opciones en cada ejecución.
Diferencias entre yt-dlp y youtube-dl
yt-dlp nació como una bifurcación de youtube-dl, uno de los proyectos más conocidos para descargar contenido multimedia desde Internet.
Ambos comparten una filosofía similar, pero yt-dlp incorpora numerosas ampliaciones.
| Característica | yt-dlp | youtube-dl |
|---|---|---|
| Código abierto | Sí | Sí |
| Uso mediante comandos | Sí | Sí |
| Descarga de vídeo y audio | Sí | Sí |
| Selección avanzada de formatos | Ampliada | Más limitada |
| Integración con FFmpeg | Sí | Sí |
| Opciones de posprocesamiento | Ampliadas | Más limitadas |
| Integración con SponsorBlock | Sí | No integrada de forma equivalente |
Una de las diferencias más importantes es la evolución de los extractores y las opciones de selección de formatos.
No obstante, ninguna de las dos herramientas garantiza que todos los vídeos de una plataforma puedan descargarse. Los servicios modifican sus sistemas con frecuencia y pueden provocar errores temporales.
Descargar e instalar yt-dlp
yt-dlp se distribuye gratuitamente desde su repositorio oficial en GitHub.
Información del programa:
- Desarrollo: comunidad de colaboradores de yt-dlp.
- Licencia: Unlicense para el código principal; determinados ejecutables incluyen componentes sujetos a otras licencias.
- Sistemas operativos: Windows, Linux y macOS.
- Versión estable verificada: 2026.10.26.
- Fecha de publicación: 26 de octubre de 2026.
- Distribución: ejecutables independientes, paquete Python y gestores de paquetes.
La versión indicada corresponde a la última publicación estable verificada al preparar este artículo. Puede existir una versión posterior.
Descarga oficial: yt-dlp en GitHub
Instalación en Windows
Para utilizar yt-dlp en Windows existen dos procedimientos habituales.
Opción 1: descargar el ejecutable
- Accede al repositorio oficial.
- Descarga
yt-dlp.exepara Windows de 64 bits. - Guarda el archivo en una carpeta, por ejemplo
C:\yt-dlp. - Abre PowerShell o el Símbolo del sistema.
- Accede a la carpeta y ejecuta el programa.
En PowerShell:
cd C:\yt-dlp
.\yt-dlp.exe --version
El comando mostrará la versión instalada.
El ejecutable oficial de 64 bits está preparado para Windows 10 y versiones posteriores y no requiere instalar Python por separado.
Opción 2: instalar mediante Winget
En Windows 10 y Windows 11 también puede instalarse mediante el Administrador de paquetes de Windows:
winget install --id yt-dlp.yt-dlp --source winget
Una vez instalado, abre una nueva terminal y comprueba su funcionamiento:
yt-dlp --version
Este procedimiento facilita la gestión de futuras actualizaciones.
Instalación en Linux y macOS
En sistemas con Python compatible, yt-dlp puede instalarse mediante pip:
python3 -m pip install -U "yt-dlp[default]"
También existen paquetes para diferentes distribuciones Linux y gestores como Homebrew.
En macOS, por ejemplo:
brew install yt-dlp
La instalación mediante pip requiere Python 3.11 o posterior en las versiones actuales.
Los paquetes de terceros pueden no coincidir con la última versión publicada por el proyecto.
Dependencias recomendadas
Para aprovechar todas sus funciones, el proyecto recomienda disponer de FFmpeg y FFprobe.
Además, las versiones actuales utilizan componentes JavaScript para determinadas operaciones de extracción, especialmente en YouTube. Para disponer de compatibilidad completa se recomiendan yt-dlp-ejs y un entorno de ejecución JavaScript compatible, como Deno.
Estas dependencias no son necesarias para todas las descargas, pero su ausencia puede limitar los formatos disponibles o provocar errores en determinados servicios.
Cómo utilizar yt-dlp
El funcionamiento básico consiste en abrir una terminal, escribir el comando correspondiente e indicar la dirección del vídeo.
Los siguientes ejemplos utilizan una URL ficticia que debe sustituirse por la dirección real del contenido.
Descargar un vídeo
Para descargar un vídeo con la selección de formato predeterminada:
yt-dlp "https://www.youtube.com/watch?v=ID_DEL_VIDEO"
El programa analiza los formatos disponibles y comienza la descarga.
Cuando es necesario combinar pistas independientes, utiliza FFmpeg si está instalado.
Consultar las calidades disponibles
Antes de descargar un vídeo es posible consultar las resoluciones y formatos ofrecidos por la plataforma:
yt-dlp -F "URL_DEL_VIDEO"
El resultado muestra una relación de formatos identificados mediante códigos.
Para seleccionar uno concreto:
yt-dlp -f CODIGO_FORMATO "URL_DEL_VIDEO"
El código debe corresponder a uno de los formatos disponibles para ese vídeo.
Descargar vídeo y audio con la mejor calidad disponible
Para seleccionar las mejores pistas de vídeo y audio y combinarlas cuando sea necesario:
yt-dlp -f "bv*+ba/b" "URL_DEL_VIDEO"
Esta opción prioriza la mejor pista de vídeo disponible y una pista de audio independiente, utilizando un formato combinado como alternativa.
La combinación de pistas requiere FFmpeg.
Descargar únicamente el audio
Para extraer el audio y convertirlo a MP3:
yt-dlp -x --audio-format mp3 "URL_DEL_VIDEO"
Este comando requiere FFmpeg para realizar la extracción o conversión correspondiente.
Si únicamente se necesita descargar un formato que contenga audio, sin solicitar una conversión:
yt-dlp -f ba "URL_DEL_VIDEO"
En este caso se conserva el formato de audio proporcionado por la plataforma.
Descargar una lista de reproducción
Para descargar los elementos disponibles de una lista:
yt-dlp "URL_DE_LA_LISTA"
También pueden seleccionarse posiciones concretas:
yt-dlp --playlist-items 1:5 "URL_DE_LA_LISTA"
Este ejemplo selecciona los cinco primeros elementos de la lista.
Descargar subtítulos
Para descargar subtítulos en español, cuando estén disponibles:
yt-dlp --write-subs --sub-langs es "URL_DEL_VIDEO"
Si se desean subtítulos automáticos, puede utilizarse:
yt-dlp --write-auto-subs --sub-langs es "URL_DEL_VIDEO"
La existencia de subtítulos automáticos depende de cada plataforma y vídeo.
Elegir la carpeta de destino
La opción -P permite indicar dónde guardar los archivos descargados.
Por ejemplo, en Windows:
yt-dlp -P "C:\Videos" "URL_DEL_VIDEO"
También pueden utilizarse plantillas de nombres mediante la opción -o.
Cómo actualizar yt-dlp
Las plataformas de vídeo cambian con frecuencia sus mecanismos de reproducción, por lo que mantener yt-dlp actualizado resulta especialmente importante.
Si utilizas el ejecutable oficial, puedes comprobar y aplicar actualizaciones con:
yt-dlp -U
Si lo instalaste mediante Winget:
winget upgrade --id yt-dlp.yt-dlp --source winget
Para instalaciones realizadas con pip:
python3 -m pip install -U "yt-dlp[default]"
El proyecto también dispone de canales de desarrollo denominados nightly y master, que incorporan modificaciones con mayor frecuencia.
El canal nightly puede resultar útil cuando una plataforma deja de funcionar con la versión estable. Sin embargo, estas compilaciones pueden introducir cambios todavía no suficientemente probados.
Ventajas y limitaciones de yt-dlp
Entre sus principales ventajas se encuentran la amplia compatibilidad con servicios multimedia, las opciones avanzadas de descarga, la automatización y la posibilidad de utilizarlo sin una interfaz gráfica.
Su naturaleza de código abierto permite examinar el código y contribuir al desarrollo del proyecto.
Sin embargo, también presenta algunas limitaciones:
- Curva de aprendizaje: requiere familiarizarse con comandos y parámetros.
- Dependencias externas: determinadas funciones necesitan FFmpeg u otros componentes.
- Cambios en las plataformas: algunos extractores pueden dejar de funcionar temporalmente.
- Restricciones de acceso: no permite descargar automáticamente cualquier contenido privado o protegido.
- Ausencia de interfaz gráfica oficial integrada: quienes prefieran utilizar ventanas y botones deberán recurrir a aplicaciones de terceros.
También conviene recordar que yt-dlp no es una herramienta destinada a eliminar sistemas DRM. Los contenidos protegidos mediante estos mecanismos pueden quedar fuera de sus posibilidades.
¿Es seguro utilizar yt-dlp?
yt-dlp es un proyecto de código abierto cuyo desarrollo y código fuente pueden consultarse públicamente en GitHub.
Para reducir riesgos, es recomendable descargarlo desde su repositorio oficial y mantenerlo actualizado.
También deben tenerse en cuenta algunas precauciones:
- Evitar ejecutables distribuidos desde páginas desconocidas.
- No compartir archivos de cookies ni credenciales de acceso.
- Revisar los comandos antes de ejecutarlos.
- Mantener actualizadas las dependencias utilizadas.
- Descargar únicamente contenido para el que se disponga de autorización o derechos suficientes.
La posibilidad técnica de descargar un vídeo no implica necesariamente que su descarga o posterior distribución estén permitidas.
Los derechos de autor, las licencias y las condiciones de cada plataforma pueden establecer restricciones.
Preguntas frecuentes sobre yt-dlp
¿yt-dlp es gratuito?
Sí. El programa es gratuito y su código principal se distribuye bajo la licencia Unlicense. Algunos ejecutables incluyen componentes adicionales sujetos a otras licencias.
¿Funciona en Windows 11?
Sí. yt-dlp dispone de ejecutables compatibles con Windows 10 y Windows 11, incluidas variantes para distintas arquitecturas.
¿Es necesario instalar Python?
No si se utiliza uno de los ejecutables independientes oficiales compatibles con el sistema operativo. Python sí es necesario para determinadas modalidades de instalación, como pip.
¿Se puede utilizar sin FFmpeg?
Sí, pero algunas operaciones estarán limitadas. FFmpeg es necesario para combinar determinadas pistas de audio y vídeo y realizar conversiones de formato.
¿Por qué yt-dlp deja de descargar algunos vídeos?
Las plataformas modifican sus reproductores, interfaces y mecanismos de acceso. Estos cambios pueden provocar fallos hasta que los desarrolladores actualicen los extractores correspondientes.
También pueden existir restricciones regionales, requisitos de autenticación o formatos no compatibles.
¿yt-dlp tiene interfaz gráfica?
El proyecto principal funciona mediante comandos. Existen interfaces gráficas desarrolladas por terceros que utilizan yt-dlp como motor de descarga.
Estas aplicaciones deben evaluarse individualmente, ya que no todas tienen el mismo mantenimiento ni las mismas características de seguridad.
¿Merece la pena utilizar yt-dlp?
yt-dlp es una opción especialmente interesante para quienes necesitan descargar contenido multimedia con control sobre la calidad, los formatos y la organización de los archivos.
Su integración con FFmpeg, la automatización mediante scripts y el desarrollo activo lo convierten en una herramienta versátil para usuarios con conocimientos informáticos.
Su principal inconveniente es la ausencia de una interfaz gráfica integrada, aunque el uso básico requiere pocos comandos. Para descargas habituales y tareas automatizadas, ofrece posibilidades que van más allá de las herramientas de descarga convencionales.