¿Qué es yt-dlp?
yt-dlp es un descargador de audio y vídeo por línea de comandos que soporta bastante más de mil sitios. Nació como un fork de youtube-dl (pasando por el ya inactivo youtube-dlc) y hoy es el proyecto que se mantiene activamente de los dos, con un selector de formatos mucho más potente, integración con SponsorBlock, soporte nativo para incrustar subtítulos, capítulos y metadatos, y un sistema de plugins para extractores propios.
⚡ Funciones clave de yt-dlp
🌐 Miles de sitios
Más de 1.700 extractores que cubren plataformas de vídeo, cadenas de televisión, servicios de podcasts y medios de noticias, además de un extractor genérico que encuentra medios en páginas para las que nadie escribió uno.
🎚️ Selección precisa de formato
-f y -S ofrecen todo un lenguaje de expresiones sobre resolución, códec, tasa de bits y contenedor, para pedir exactamente el flujo que quieres en lugar del que venga por defecto.
🎧 Extracción de audio
-x --audio-format mp3 extrae la pista de audio y la recodifica; con --embed-thumbnail y --embed-metadata obtienes archivos etiquetados que cualquier reproductor entiende.
💬 Subtítulos y capítulos
Descarga o incrusta subtítulos en cualquier idioma disponible, conserva los automáticos y escribe las marcas de capítulo en el archivo de salida, o divídelo por ellas.
⏭️ SponsorBlock
Marca o elimina segmentos patrocinados, intros y autopromoción durante la descarga usando la base de datos de SponsorBlock, sin tocar después un editor.
🍪 Cookies y sesiones
--cookies-from-browser lee una sesión iniciada directamente de Firefox o Chromium, para que funcione el contenido privado, con restricción de edad o solo para miembros.
apt upgrade te mantiene en la última versión.
📦 Instalación desde deb.griffo.io
Paso 1: Añadir el repositorio
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
sudo apt updateinstall -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
apt updatePaso 2: Instalar yt-dlp
# Instalar la última versión de yt-dlp
sudo apt install yt-dlp
# Verificar la instalación
yt-dlp --version# Instalar la última versión de yt-dlp
apt install yt-dlp
# Verificar la instalación
yt-dlp --versionPaso 3: Instalar ffmpeg (muy recomendable)
# yt-dlp necesita ffmpeg para unir flujos de vídeo y audio separados,
# extraer audio e incrustar subtítulos o miniaturas
sudo apt install ffmpeg
# Las autocompletados para bash, zsh y fish vienen con el paquete:
# no hay nada que configurar. Abre una shell nueva y pulsa Tab:
yt-dlp --embed-<Tab>
# La página de manual también se instala
man yt-dlp# yt-dlp necesita ffmpeg para unir flujos de vídeo y audio separados,
# extraer audio e incrustar subtítulos o miniaturas
apt install ffmpeg
# Las autocompletados para bash, zsh y fish vienen con el paquete:
# no hay nada que configurar. Abre una shell nueva y pulsa Tab:
yt-dlp --embed-<Tab>
# La página de manual también se instala
man yt-dlp🎯 Ejemplos básicos de uso
Descargas del día a día:
# Descargar un vídeo con la mejor calidad disponible
yt-dlp 'https://example.com/watch?v=...'
# El mejor MP4 hasta 1080p
yt-dlp -S 'res:1080,ext:mp4' 'URL'
# Solo audio, como MP3 etiquetado
yt-dlp -x --audio-format mp3 --embed-thumbnail --embed-metadata 'URL'
# Ver todos los formatos disponibles antes de elegir
yt-dlp -F 'URL'Subtítulos, capítulos y patrocinios:
# Incrustar subtítulos en inglés, incluidos los automáticos
yt-dlp --embed-subs --sub-langs en --write-auto-subs 'URL'
# Escribir las marcas de capítulo en el archivo
yt-dlp --embed-chapters 'URL'
# Quitar segmentos patrocinados e intros durante la descarga
yt-dlp --sponsorblock-remove sponsor,intro 'URL'
# Bajar solo un fragmento en lugar del vídeo entero
yt-dlp --download-sections '*00:01:30-00:04:00' 'URL'Listas de reproducción, archivos y automatización:
# Una lista entera, en carpetas ordenadas por autor
yt-dlp -o '%(uploader)s/%(title)s.%(ext)s' 'PLAYLIST_URL'
# Mantener un canal sincronizado sin volver a descargar lo antiguo
yt-dlp --download-archive seen.txt 'CHANNEL_URL'
# Contenido privado o con restricción de edad, usando una sesión del navegador
yt-dlp --cookies-from-browser firefox 'URL'
# Descargas más rápidas mediante aria2c
yt-dlp --downloader aria2c --downloader-args aria2c:'-x 8 -s 8' 'URL'🔧 Integraciones con otras herramientas
yt-dlp es el motor de descarga que espera mucho otro software:
- ffmpeg: unir, remuxar, extraer audio e incrustar dependen de él
- mpv: reproduce una URL directamente pasándosela a yt-dlp al vuelo
- aria2: descargador externo opcional para transferencias paralelas y segmentadas
- Servidores multimedia: las bibliotecas de Jellyfin, Kodi y Navidrome se llenan a menudo con plantillas de salida de yt-dlp
- Archivos de configuración: pon tus opciones habituales en
~/.config/yt-dlp/configy deja de reescribirlas
🚀 ¿Por qué elegir deb.griffo.io?
- Debian oficial: disponible, pero congelado en la versión con la que se publicó la release, con meses de arreglos de extractores de retraso
- pip / pipx: actualizado, pero fuera de apt, y PEP 668 hace incómodo un
pip installa nivel de sistema en Debian - deb.griffo.io: última versión con actualizaciones automáticas
- ✅ Extractores que funcionan: la versión más reciente, que es lo que hace que las descargas sigan funcionando
- ✅ Sin configuración manual: sin pip, sin virtualenv, sin autoactualizaciones escribiendo en
/usr/local/bin - ✅ Actualizaciones automáticas: paquetes actualizados pocas horas después de cada release upstream
- ✅ Paquete completo: la compilación oficial upstream, la página de manual
yt-dlp.1y autocompletados para bash, zsh y fish - ✅ Todas las arquitecturas: se publica como
Architecture: all, así que amd64, arm64, armhf, riscv64 y el resto instalan el mismo paquete - ✅ Multidistribución: funciona en Bookworm, Trixie, Forky y Sid
- ✅ Mantenimiento sencillo: comandos apt de siempre para actualizar
📦 Repositorio de compilación del paquete
Los paquetes de Debian se compilan y mantienen automáticamente en este repositorio de GitHub:
- 📺 yt-dlp-debian - Compilaciones de las últimas versiones
🔗 Paquetes relacionados
También disponibles en deb.griffo.io:
- termusic - Reproductor de música en terminal para todo lo que descargues
- lowfi - Reproductor minimalista de radio lofi
- viu - Ver miniaturas e imágenes en la terminal
- Yazi - Gestor de archivos en terminal para navegar tu colección