video-download
Descarga video y audio desde URLs usando yt-dlp directamente. Sin envoltorios de scripts necesarios.
Requisitos previos
- yt-dlp:
brew install yt-dlpopip install yt-dlp - ffmpeg:
brew install ffmpegoapt install ffmpeg(necesario para fusionar flujos de video+audio)
Actualiza yt-dlp periódicamente para mantenerlo al día con los cambios de los sitios: yt-dlp -U o pip install -U yt-dlp.
Comandos
Descargar la mejor calidad
yt-dlp "URL" -o "%(title)s.%(ext)s" --merge-output-format mp4
Descargar resolución específica
# 720p
yt-dlp "URL" -f "bestvideo[height<=720]+bestaudio/best[height<=720]" --merge-output-format mp4
# 1080p
yt-dlp "URL" -f "bestvideo[height<=1080]+bestaudio/best[height<=1080]" --merge-output-format mp4
Solo audio
yt-dlp "URL" -x --audio-format mp3 --audio-quality 0
Descargar subtítulos
# Descargar video con subtítulos en inglés
yt-dlp "URL" --write-subs --sub-langs en --merge-output-format mp4
# Descargar video con subtítulos en varios idiomas
yt-dlp "URL" --write-subs --sub-langs "en,es,fr" --merge-output-format mp4
# Descargar solo subtítulos (sin video)
yt-dlp "URL" --write-subs --sub-langs en --skip-download
Obtener metadatos (sin descargar)
yt-dlp "URL" --dump-json --no-download
Listar formatos disponibles
yt-dlp "URL" -F
Especificar directorio de salida
yt-dlp "URL" -o "./downloads/%(title)s.%(ext)s" --merge-output-format mp4
Preajustes de calidad
| Calidad | Indicador de formato |
|---|---|
| Mejor | -f "bestvideo+bestaudio/best" (predeterminado) |
| 1080p | -f "bestvideo[height<=1080]+bestaudio/best[height<=1080]" |
| 720p | -f "bestvideo[height<=720]+bestaudio/best[height<=720]" |
| 480p | -f "bestvideo[height<=480]+bestaudio/best[height<=480]" |
| Peor | -f "worstvideo+worstaudio/worst" |
Variables de plantilla de salida
Variables comunes para las plantillas de -o:
| Variable | Descripción |
|---|---|
%(title)s | Título del video |
%(ext)s | Extensión del archivo |
%(id)s | ID del video |
%(uploader)s | Nombre del canal/subidor |
%(upload_date)s | Fecha de subida (AAAAMMDD) |
%(duration)s | Duración en segundos |
%(resolution)s | Resolución del video |
Consejos
- Siempre usa
--merge-output-format mp4para no terminar con archivos.webmo.mkv. - Usa
--no-downloadcon--dump-jsonpara consultas solo de metadatos: no se escriben archivos en disco. - Si una descarga falla con errores HTTP, actualiza yt-dlp primero (
yt-dlp -U). - Usa
-f "bestvideo[height<=720]+bestaudio"para ahorrar ancho de banda cuando no se necesita resolución completa. - yt-dlp maneja automáticamente la limitación de velocidad y los reintentos.
- La salida de
--dump-jsonincluyetitle,duration,uploader,view_count,description,formats,subtitlesy mucho más.
Solución de problemas
- "yt-dlp: command not found": Instálalo (
pip install yt-dlp) y asegúrate de que tu PATH incluya el directorio bin de pip. - "ffmpeg: command not found": Instala ffmpeg. Sin él, las descargas fallan cuando el video y el audio están en flujos separados (común en YouTube para HD).
- Las descargas fallan o devuelven errores: Ejecuta
yt-dlp -Upara actualizar. Los sitios cambian con frecuencia y yt-dlp publica correcciones regularmente.