soundgrab
SoundGrab es una herramienta de descarga de audio con interfaz web local. Utiliza FastAPI y yt-dlp para extraer pistas, listas y perfiles completos de plataformas como SoundCloud, YouTube y Bandcamp. Entrega archivos MP3 etiquetados con arte de portada sin necesidad de compilación previa.
Ficha actualizada 24 sept 2026, 21:12 · upstream 24 sept 2026, 20:59 · release v1.0.0
Qué es soundgrab
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
SoundGrab es una aplicación de escritorio ligera que permite descargar contenido multimedia desde múltiples servicios web populares a través de una interfaz web local. El motor subyacente utiliza yt-dlp, lo que garantiza compatibilidad con casi cualquier plataforma soportada por esta herramienta, incluyendo SoundCloud, YouTube, Bandcamp y Mixcloud. Los archivos se descargan como MP3 etiquetados con metadatos completos, arte de portada y organizados automáticamente en carpetas por artista y lista.
La interfaz web está construida sobre FastAPI y comunica el progreso de las descargas mediante Server-Sent Events (SSE), permitiendo una visualización en tiempo real sin recargar la página. La aplicación requiere Python 3.10 o superior e incluye detección automática de ffmpeg para la conversión de flujos HLS y ensamblaje de pistas fragmentadas, especialmente necesario para SoundCloud.
Es importante destacar que la interfaz gráfica está desarrollada en francés, aunque la funcionalidad es completa. El sistema organiza los archivos manteniendo el orden original de las listas para evitar mezclas aleatorias en software DJ. La aplicación opera localmente y puede exponerse a la red local con precauciones de seguridad específicas habilitadas en la configuración.
- Archivar música de SoundCloud, YouTube o Bandcamp en formato MP3 etiquetado.
- Descargar perfiles completos de artistas incluyendo todas sus pistas y listas.
- Gestionar descargas de contenido privado mediante lectura de cookies del navegador.
- Organizar librerías musicales automáticamente por artista y lista para software DJ.
- Monitorear el progreso de descargas en tiempo real sin recargar la interfaz web.
- Interfaz web local sin build step, compuesta solo por archivos estáticos HTML/CSS/JS.
- Soporte nativo para Server-Sent Events (SSE) para mostrar progreso en tiempo real.
- Detección automática de ffmpeg y gestión de rutas binarias en Windows y Linux.
- Organización inteligente de archivos que preserva el orden original de las playlists.
- Capacidad de leer cookies del navegador para acceder a contenido privado o suscripto.
- La interfaz web está desarrollada completamente en francés, lo que puede dificultar su uso sin conocimientos del idioma.
- Dependencia externa de yt-dlp, cuyo soporte puede verse afectado por cambios frecuentes en las plataformas objetivo.
- No incluye Dockerfile ni Compose, requiriendo instalación manual de Python y dependencias.
- El acceso a la red local (LAN) requiere configuración manual de firewall y no autentica la API.
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Requiere Python 3.10+ e instalación de ffmpeg en el PATH o carpeta bin/. La aplicación se ejecuta localmente en el puerto 8731 por defecto. Para acceso remoto, habilitar 'lan_access' con precaución, ya que la API no tiene autenticación. Se recomienda usar un entorno virtual y activar mutagen solo si se desea incrustar arte de portada en formatos originales.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.