video-download
Descarga video y audio desde URLs usando yt-dlp directamente. No necesita scripts envoltorio.
Prerrequisitos
- yt-dlp:
brew install yt-dlpopip install yt-dlp - ffmpeg:
brew install ffmpegoapt install ffmpeg(necesario para combinar flujos de video y audio)
Actualice yt-dlp periódicamente para mantenerse 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 varios idiomas de subtítulos
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 descarga)
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
Presets 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 -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
- Use siempre
--merge-output-format mp4para evitar terminar con archivos.webmo.mkv. - Use
--no-downloadcon--dump-jsonpara consultas solo de metadatos: no se escribe ningún archivo en disco. - Si una descarga falla con errores HTTP, primero actualice yt-dlp (
yt-dlp -U). - Use
-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álelo (
pip install yt-dlp) y asegúrese de que su PATH incluya el directorio bin de pip. - "ffmpeg: command not found": Instale ffmpeg. Sin él, las descargas fallan cuando el video y el audio son flujos separados (común en YouTube para HD).
- Las descargas fallan o devuelven errores: Ejecute
yt-dlp -Upara actualizar. Los sitios cambian con frecuencia y yt-dlp envía correcciones regularmente.