Guía de referencia rápida para los comandos y opciones más comunes de yt-dlp.
yt-dlp es una herramienta de línea de comandos de código abierto y un fork activamente mantenido de youtube-dl (con correcciones más rápidas y soporte para más de 1700 sitios) para descargar videos, audio y listas de reproducción.
Esta hoja de referencia cubre comandos comunes para descargar video 1080p/4K, extraer audio MP3, evitar detección de bots e incrustar subtítulos.
¿Nuevo en la herramienta? Visita nuestra completa Guía de descarga e instalación de yt-dlp, o simplemente ejecuta los ejemplos a continuación directamente en nuestra consola en línea sin ninguna instalación.
¿Prefiere crear su propio comando? Pruebe nuestro Generador de comandos yt-dlp interactivo — elija opciones y obtenga el comando exacto.
yt-dlp "https://www.youtube.com/watch?v=oHg5SJYRHA0"
yt-dlp -x --audio-format mp3 "https://soundcloud.com/..."
yt-dlp -F "https://vimeo.com/..."
yt-dlp -f "best[height<=1080]" "https://www..."
yt-dlp --yes-playlist "https://www.youtube/..."
yt-dlp --embed-subs "https://www..."
| Comando | Descripción | Acciones |
|---|---|---|
| yt-dlp "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Descargar el video con la mejor calidad (comportamiento predeterminado). | |
| yt-dlp -o "%(title)s.%(ext)s" "https://vimeo.com/906834164" | Guardar video con ruta de salida personalizada y plantilla de nombre de archivo. | |
| yt-dlp --limit-rate 50K "https://www.dailymotion.com/video/x8j5y9z" | Limitar velocidad de descarga para evitar limitación de ancho de banda (ej. 50K, 10M). | |
| yt-dlp -o "%(upload_date)s - %(title)s (%(id)s).%(ext)s" "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Evita conflictos de archivos incrustando la fecha de subida y el ID único del video en el nombre del archivo de salida. |
| Comando | Descripción | Acciones |
|---|---|---|
| yt-dlp -F "https://vimeo.com/906834164" | Listar todas las resoluciones, tamaños, codecs y formatos disponibles. | |
| yt-dlp -f 137 "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Seleccionar y descargar un código de formato específico (usa -F para encontrar códigos primero). | |
| yt-dlp -f "bestvideo[height<=1080]+bestaudio/best" "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Descargar la mejor calidad de video a 1080p o inferior. El mismo filtro de altura funciona para 1440p (2K) y 2160p (4K). | |
| yt-dlp -f "bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]" --merge-output-format mp4 "https://vimeo.com/906834164" | Forzar la descarga de la mejor calidad como formato MP4 combinado. | |
| yt-dlp --recode-video mp4 "https://www.dailymotion.com/video/x8j5y9z" | Descargar video y recodificarlo a MP4 estándar (útil si la plataforma usa contenedores no estándar como WebM). |
-f bestvideo+bestaudio combinado con --merge-output-format mp4 para la mejor calidad con máxima compatibilidad de dispositivos. En ytdlp.online, la combinación con ffmpeg se maneja automáticamente en nuestro servidor.
| Comando | Descripción | Acciones |
|---|---|---|
| yt-dlp -x "https://soundcloud.com/monstercat/aero-chord-surface" | Extraer solo la pista de audio (detecta automáticamente el mejor formato predeterminado). | |
| yt-dlp -x --audio-format mp3 "https://soundcloud.com/monstercat/aero-chord-surface" | Descargar audio y convertirlo específicamente al formato MP3. | |
| yt-dlp -x --audio-format mp3 --audio-quality 0 "https://soundcloud.com/monstercat/aero-chord-surface" | Descargar audio y extraerlo como MP3 de mejor calidad (VBR 0 / equivalente a 320kbps). | |
| yt-dlp -x --audio-format mp3 --embed-thumbnail --embed-metadata "https://soundcloud.com/monstercat/aero-chord-surface" | Descargar MP3 e incrustar la descripción original del video, etiquetas y portada en miniatura. |
--embed-thumbnail --embed-metadata a tu extracción de MP3 te da automáticamente la portada del álbum y las etiquetas de la canción — perfecto para apps de biblioteca musical como iTunes o Spotify Local Files.
| Comando | Descripción | Acciones |
|---|---|---|
| yt-dlp --yes-playlist "https://www.youtube.com/playlist?list=PLRBp0Fe2GpgnIh0AiYKh7o7HnYAej-5ph" | Forzar la descarga de todos los videos en un enlace de lista de reproducción. | |
| yt-dlp --no-playlist "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Descargar solo el video individual en la URL, ignorando la lista de reproducción a la que pertenece. | |
| yt-dlp --playlist-items 1-5 "https://www.youtube.com/playlist?list=PLRBp0Fe2GpgnIh0AiYKh7o7HnYAej-5ph" | Descargar un rango de índice específico de una lista de reproducción (ej. 1-5, 1,3,5). |
| Comando | Descripción | Acciones |
|---|---|---|
| yt-dlp --list-subs "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Listar todos los subtítulos subidos manualmente y autogenerados. | |
| yt-dlp --write-auto-subs --skip-download "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Extraer y guardar solo archivos de subtítulos autogenerados, omitiendo la descarga del video. | |
| yt-dlp --embed-subs --merge-output-format mp4 "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Descargar video e incrustar automáticamente subtítulos como soft-subs en el archivo MP4 combinado. | |
| yt-dlp --write-subs --sub-langs en "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Descargar subtítulos subidos manualmente en un idioma específico (ej. en, zh-Hans, ja). Usa --list-subs para ver los idiomas disponibles primero. |
--sub-langs all para descargar subtítulos en todos los idiomas disponibles, o --sub-langs "en,zh-Hans" para obtener múltiples idiomas a la vez. Para la referencia completa de subtítulos, consulta nuestra Página de ayuda de yt-dlp.
| Comando | Descripción | Acciones |
|---|---|---|
| yt-dlp --cookies-from-browser chrome "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Cargar cookies de un navegador (ej. chrome, firefox) para evitar verificaciones de inicio de sesión o bloqueo de bots. |
|
| yt-dlp --impersonate chrome "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Simular características de cliente TLS del navegador (requiere curl-cffi) para evitar bloqueos de detección de bots de Cloudflare y YouTube. | |
| yt-dlp --extractor-args youtube:player_client=default,-android_sdkless "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Evita los errores de "Inicia sesión para confirmar que no eres un bot" forzando una combinación específica de clientes del reproductor de YouTube. | |
| yt-dlp --proxy "http://proxy-ip:port" "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Enrutar el tráfico de yt-dlp a través de un proxy HTTP, HTTPS o SOCKS — útil para contenido con restricción geográfica. | |
| yt-dlp --geo-bypass-country US "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Falsificar código de país de geolocalización (ej. US, GB, JP) para evitar restricciones de contenido regional. |
| Comando | Descripción | Acciones |
|---|---|---|
| yt-dlp -a urls.txt | Descarga por lotes todas las URLs de video listadas línea por línea en un archivo de texto. |
|
| yt-dlp --split-chapters "https://www.youtube.com/watch?v=QQ7Xl79OqNY" | Dividir un video automáticamente en pistas/archivos separados según sus capítulos internos. | |
| yt-dlp --external-downloader aria2c "https://vimeo.com/906834164" | Usar descargador externo multihilo (Aria2) para acelerar significativamente tus descargas. | |
| yt-dlp --sleep-interval 5 --max-sleep-interval 15 "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Aplicar retrasos aleatorios (5 a 15s) entre descargas para prevenir bloqueos de dirección IP. | |
| yt-dlp --download-sections "*00:01:00-00:02:30" "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Descargar un clip de video específico o rango de tiempo (ej. 1m0s a 2m30s) en lugar del video completo. | |
| yt-dlp --download-archive archive.txt "https://www.youtube.com/watch?v=oHg5SJYRHA0" | Rastrear historial de descargas en archive.txt y omitir automáticamente videos descargados previamente. |
|
yt-dlp --cookies-from-browser chrome "https://www.youtube.com/watch?v=oHg5SJYRHA0"
yt-dlp -U
.exe independiente como falso positivo debido al empaquetado de PyInstaller. Instala mediante winget install yt-dlp para evitar esto. Para una opción sin instalación, usa nuestra consola en línea. Lee más en nuestra guía de seguridad.
winget install yt-dlp. También puedes usar Scoop, Chocolatey, pip, o descargar el yt-dlp.exe independiente directamente de GitHub.
Ejecuta cualquier comando de yt-dlp en nuestro servidor. No se requiere instalación.