Generador de comandos yt-dlp para SoundCloud

Crea un comando de yt-dlp para pistas y sets de SoundCloud, etiquetados y listos para una biblioteca musical.

URL del vídeo, la lista o el canal

Opcional. Si lo dejas vacío, el comando termina en URL para que la rellenes tú.

Tu comando

yt-dlp -x --audio-format mp3 --audio-quality 0 --embed-thumbnail --embed-metadata -o '%(uploader)s - %(title)s.%(ext)s' https://soundcloud.com/artist/track

Básico

Qué quieres

Vídeo Solo audio

Solo audio extrae la pista sonora y descarta el vídeo.

Vídeo y calidad

Calidad máxima -f

Limita la altura. yt-dlp sigue eligiendo la mejor pista igual o por debajo.

Contenedor --merge-output-format necesita ffmpeg

El tipo de archivo en el que se fusionan las pistas de vídeo y audio separadas.

Opciones avanzadas (3)

Selector de formato propio -f

Sustituye a la lista de calidad. Para quien ya conoce la sintaxis de formatos.

Remux a --remux-video necesita ffmpeg

Reempaqueta las pistas sin recodificar. Rápido y sin pérdida.

Recodificar a --recode-video necesita ffmpeg

Recodifica el vídeo. Lento y con pérdida: solo cuando remux no sirva.

Audio

Formato de audio --audio-format necesita ffmpeg

El archivo al que se convierte el audio.

Calidad de audio --audio-quality necesita ffmpeg

VBR da la mejor relación tamaño-calidad; los bitrates fijos son más previsibles.

Subtítulos

Incrustar los mete dentro del vídeo; guardar escribe un .srt aparte junto a él.

Idiomas de los subtítulos --sub-langs

Separados por comas. Usa all para todos los idiomas disponibles.

Subtítulos automáticos --write-auto-subs 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.

Qué elementos -I

Funcionan rangos y listas, por ejemplo 1-10,15 o -5::2 para uno de cada dos desde el final.

Opciones avanzadas (1)

Archivo de registro --download-archive

Anota lo ya descargado para que una nueva ejecución lo omita. Es la forma de mantener un canal sincronizado.

Fragmentos y capítulos

Opciones avanzadas (2)

Descargar solo un fragmento --download-sections necesita ffmpeg

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.

Dividir por capítulos --split-chapters necesita ffmpeg Escribe un archivo por capítulo en lugar de uno largo.

Metadatos y portada

Incrustar miniatura --embed-thumbnail necesita ffmpeg Usa la miniatura del vídeo como portada.

Incrustar metadatos --embed-metadata necesita ffmpeg Escribe título, autor y fecha dentro del propio archivo.

Incrustar capítulos --embed-chapters necesita ffmpeg Añade marcas de capítulo entre las que tu reproductor puede saltar.

Opciones avanzadas (3)

Guardar la miniatura --write-thumbnail Escribe la imagen de portada junto al vídeo.

Guardar la descripción --write-description Escribe la descripción en un archivo .description.

Guardar metadatos en JSON --write-info-json Escribe todo lo que yt-dlp sabe del vídeo en un archivo .info.json.

SponsorBlock

Eliminar fragmentos --sponsorblock-remove necesita ffmpeg

Corta del archivo los fragmentos marcados por la comunidad, según los datos de SponsorBlock.

Opciones avanzadas (1)

Marcar fragmentos como capítulos --sponsorblock-mark

Conserva los fragmentos pero los marca, para que los saltes tú.

Archivos y carpetas

Plantilla del nombre de archivo -o

Los campos van en %(...)s. Las barras crean carpetas.

Nombres seguros (solo ASCII) --restrict-filenames Quita acentos, espacios y cualquier carácter que un sistema de archivos quisquilloso pueda rechazar.

Sobrescribir archivos existentes --force-overwrites Reemplaza los archivos que ya estén ahí.

Reanudar descargas parciales -c Continúa donde se interrumpió la descarga.

Opciones avanzadas (4)

Carpeta de descarga -P

Dónde se escriben los archivos. Combínalo con la plantilla de arriba para crear subcarpetas.

Nombres compatibles con Windows --windows-filenames Elimina los caracteres que Windows rechaza, aunque estés en otro sistema.

Recortar nombres a --trim-filenames

Longitud máxima del nombre de archivo, en caracteres.

No sobrescribir nunca -w Omite todo lo ya descargado.

Filtros

Opciones avanzadas (5)

Subido después de --dateafter

AAAAMMDD, o una fecha relativa como now-1month.

Subido antes de --datebefore

AAAAMMDD, o una fecha relativa.

Tamaño mínimo --min-filesize

Omite lo más pequeño. Acepta 5M, 500K y similares.

Tamaño máximo --max-filesize

Omite lo más grande.

Parar después de --max-downloads

Número de archivos a descargar antes de detenerse.

Red

Límite de velocidad -r

Por ejemplo 2M o 500K. Útil cuando necesitas el resto del ancho de banda.

Opciones avanzadas (5)

Fragmentos en paralelo -N

Acelera las pistas fragmentadas. Cuatro es un punto de partida razonable.

Reintentos -R

Cuántas veces reintentar una parte fallida. Se admite infinite.

Proxy --proxy

URL de proxy HTTP, HTTPS o SOCKS.

Saltar bloqueo geográfico --geo-bypass Finge el origen de la petición. Funciona en algunos sitios, no en todos.

Suplantar un navegador --impersonate

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 --cookies-from-browser

Lee directamente tu sesión. Necesario para contenido privado, con restricción de edad o solo para miembros.

Opciones avanzadas (1)

Archivo de cookies --cookies

Un cookies.txt en formato Netscape exportado desde tu navegador.

Directos

Opciones avanzadas (2)

Grabar desde el principio --live-from-start Empieza un directo desde el inicio en lugar del momento actual.

Esperar el directo --wait-for-video

Consulta hasta que empiece un directo programado. MIN-MAX segundos entre comprobaciones.

Soluciones alternativas

Opciones avanzadas (3)

User agent --user-agent obsoleto

Obsoleto en favor de --add-headers. Se mantiene porque muchas guías antiguas siguen usándolo.

Referer --referer obsoleto

Obsoleto en favor de --add-headers.

Argumentos del extractor --extractor-args

Opciones específicas de cada sitio, por ejemplo youtube:player_client=web.

Salida y depuración

Solo listar formatos -F Imprime los formatos disponibles y termina sin descargar.

Opciones avanzadas (2)

Continuar aunque haya errores -i Omite los elementos que fallan en lugar de detenerse. Imprescindible en listas grandes.

Simular -s Hace todo excepto escribir el archivo.

Restablecer

Las opciones que importan aquí

Formato de audio --audio-format El archivo al que se convierte el audio.
Calidad de audio --audio-quality VBR da la mejor relación tamaño-calidad; los bitrates fijos son más previsibles.
Incrustar miniatura --embed-thumbnail Usa la miniatura del vídeo como portada.

Páginas relacionadas

Elegir un formato de audio

SoundCloud suele servir MP3 a 128 kbps, a veces Opus. Convertir una fuente de 128 kbps a 320 kbps produce un archivo más grande que no suena mejor: «la mejor disponible» conserva el original y es el ajuste correcto.

Merece la pena activar portada y etiquetas: sin ellas, un set descargado llega como una carpeta de archivos sin título. Los sets y las listas funcionan con el modo de lista completa.

Preguntas frecuentes

› ¿Qué calidad de audio ofrece SoundCloud?

Normalmente MP3 a 128 kbps, a veces Opus. Convertir una fuente de 128 kbps a MP3 de 320 kbps agranda el archivo sin mejorarlo: elige «la mejor disponible» para conservar el original.

› ¿Puedo descargar una lista de SoundCloud?

Sí. Usa la URL del set o de la lista con el modo de lista completa, más un archivo de registro para ejecuciones repetidas.

› ¿Funcionan las pistas privadas o no listadas?

Las de enlace secreto suelen funcionar si pasas la URL completa. Las realmente privadas necesitan cookies de una cuenta con acceso.