Qué quieres
Solo audio extrae la pista sonora y descarta el vídeo.
Referencia de opciones de yt-dlp
Escrito para yt-dlp 2026.07.21. Entre versiones se añaden y renombran opciones, así que comprueba la tuya con yt-dlp --version.
Básico
Vídeo y calidad
-f FORMAT
--format
Calidad máxima
Limita la altura. yt-dlp sigue eligiendo la mejor pista igual o por debajo.
-f FORMAT
--format
Selector de formato propio
Sustituye a la lista de calidad. Para quien ya conoce la sintaxis de formatos.
Ejemplos
-f "bv*[vcodec^=av01]+ba"-f "b[filesize<50M]"
--merge-output-format FORMAT
necesita ffmpeg
Contenedor
El tipo de archivo en el que se fusionan las pistas de vídeo y audio separadas.
--remux-video FORMAT
necesita ffmpeg
Remux a
Reempaqueta las pistas sin recodificar. Rápido y sin pérdida.
--recode-video FORMAT
necesita ffmpeg
Recodificar a
Recodifica el vídeo. Lento y con pérdida: solo cuando remux no sirva.
Audio
--audio-format FORMAT
necesita ffmpeg
Formato de audio
El archivo al que se convierte el audio.
--audio-quality QUALITY
necesita ffmpeg
Calidad de audio
VBR da la mejor relación tamaño-calidad; los bitrates fijos son más previsibles.
Subtítulos
Subtítulos
Incrustar los mete dentro del vídeo; guardar escribe un .srt aparte junto a él.
Idiomas de los subtítulos
Separados por comas. Usa all para todos los idiomas disponibles.
Ejemplos
--sub-langs "en,vi"--sub-langs "en.*,ja"--sub-langs all
Subtítulos automáticos
Incluye los subtítulos generados por máquina cuando no hay ninguno humano.
Listas y canales
Listas de reproducción
Qué hacer cuando la URL pertenece a la vez a un vídeo y a una lista.
-I ITEM_SPEC
--playlist-items
Qué elementos
Funcionan rangos y listas, por ejemplo 1-10,15 o -5::2 para uno de cada dos desde el final.
Ejemplos
-I 1:5-I "1,3,7-10"-I "-5::2"
Archivo de registro
Anota lo ya descargado para que una nueva ejecución lo omita. Es la forma de mantener un canal sincronizado.
Fragmentos y capítulos
--download-sections REGEX
necesita ffmpeg
Descargar solo un fragmento
Un rango como *00:01:30-00:03:00, o el nombre de un capítulo. El asterisco inicial indica que es una marca de tiempo.
Ejemplos
--download-sections "*00:01:30-00:03:00"--download-sections "intro"
--split-chapters
necesita ffmpeg
Dividir por capítulos
Escribe un archivo por capítulo en lugar de uno largo.
Metadatos y portada
--embed-thumbnail
necesita ffmpeg
Incrustar miniatura
Usa la miniatura del vídeo como portada.
--embed-metadata
necesita ffmpeg
Incrustar metadatos
Escribe título, autor y fecha dentro del propio archivo.
--embed-chapters
necesita ffmpeg
Incrustar capítulos
Añade marcas de capítulo entre las que tu reproductor puede saltar.
Guardar la miniatura
Escribe la imagen de portada junto al vídeo.
Guardar la descripción
Escribe la descripción en un archivo .description.
Guardar metadatos en JSON
Escribe todo lo que yt-dlp sabe del vídeo en un archivo .info.json.
SponsorBlock
--sponsorblock-remove CATS
necesita ffmpeg
Eliminar fragmentos
Corta del archivo los fragmentos marcados por la comunidad, según los datos de SponsorBlock.
Marcar fragmentos como capítulos
Conserva los fragmentos pero los marca, para que los saltes tú.
Archivos y carpetas
-o [TYPES:]TEMPLATE
--output
Plantilla del nombre de archivo
Los campos van en %(...)s. Las barras crean carpetas.
Ejemplos
-o "%(title)s.%(ext)s"-o "%(playlist_index)02d - %(title)s.%(ext)s"
-P [TYPES:]PATH
--paths
Carpeta de descarga
Dónde se escriben los archivos. Combínalo con la plantilla de arriba para crear subcarpetas.
Nombres seguros (solo ASCII)
Quita acentos, espacios y cualquier carácter que un sistema de archivos quisquilloso pueda rechazar.
Nombres compatibles con Windows
Elimina los caracteres que Windows rechaza, aunque estés en otro sistema.
Recortar nombres a
Longitud máxima del nombre de archivo, en caracteres.
Sobrescribir archivos existentes
Reemplaza los archivos que ya estén ahí.
-w
--no-overwrites
No sobrescribir nunca
Omite todo lo ya descargado.
-c
--continue
Reanudar descargas parciales
Continúa donde se interrumpió la descarga.
Filtros
Subido después de
AAAAMMDD, o una fecha relativa como now-1month.
Ejemplos
--dateafter 20240101--dateafter now-1month
Subido antes de
AAAAMMDD, o una fecha relativa.
Tamaño mínimo
Omite lo más pequeño. Acepta 5M, 500K y similares.
Tamaño máximo
Omite lo más grande.
Parar después de
Número de archivos a descargar antes de detenerse.
Red
-r RATE
--limit-rate
Límite de velocidad
Por ejemplo 2M o 500K. Útil cuando necesitas el resto del ancho de banda.
-N N
--concurrent-fragments
Fragmentos en paralelo
Acelera las pistas fragmentadas. Cuatro es un punto de partida razonable.
-R RETRIES
--retries
Reintentos
Cuántas veces reintentar una parte fallida. Se admite infinite.
Proxy
URL de proxy HTTP, HTTPS o SOCKS.
Saltar bloqueo geográfico
Finge el origen de la petición. Funciona en algunos sitios, no en todos.
Suplantar un navegador
Hace que las peticiones parezcan de un navegador real. Es la solución habitual a un 403 repentino.
Sesión y cookies
Cookies del navegador
Lee directamente tu sesión. Necesario para contenido privado, con restricción de edad o solo para miembros.
Archivo de cookies
Un cookies.txt en formato Netscape exportado desde tu navegador.
Directos
Grabar desde el principio
Empieza un directo desde el inicio en lugar del momento actual.
Esperar el directo
Consulta hasta que empiece un directo programado. MIN-MAX segundos entre comprobaciones.
Soluciones alternativas
--user-agent UA
obsoleto — --add-headers
User agent
Obsoleto en favor de --add-headers. Se mantiene porque muchas guías antiguas siguen usándolo.
--referer URL
obsoleto — --add-headers
Referer
Obsoleto en favor de --add-headers.
Argumentos del extractor
Opciones específicas de cada sitio, por ejemplo youtube:player_client=web.
Ejemplos
--extractor-args "youtube:player_client=web,android"