Rheoson
Aplicación auto-alojada de streaming y descarga de música con interfaz tipo Spotify. Usa yt-dlp para extraer audio de YouTube Music, FastAPI como backend y React como frontend. Soporta reproducción offline, sincronización entre dispositivos y autenticación vía Clerk.
Ficha actualizada 25 sept 2026, 19:32 · upstream 25 sept 2026, 19:14 · release sin release detectada
Qué es Rheoson
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Rheoson es una aplicación open-source para streaming y descarga de música que permite tener control total sobre su experiencia de escucha sin suscripciones ni publicidad. La interfaz replica el diseño de Spotify Premium con animaciones fluidas y controles móviles, mientras el audio se obtiene desde YouTube Music mediante yt-dlp y se almacena localmente en el dispositivo del usuario.
El backend está construido con FastAPI en Python 3.13+ y el frontend con React 18 y TypeScript. La aplicación utiliza MongoDB para persistencia de cuentas, recomendaciones y análisis (opcional pero recomendado), y Redis para caché. Soporta autenticación mediante Clerk con sincronización de likes, listas de reproducción e historial entre dispositivos.
La arquitectura incluye un sistema de streaming en tiempo real vía Socket.IO que permite reproducir canciones mientras se descargan, con soporte para rangos HTTP y validación SSRF. Incluye tareas programadas para mantenimiento: escaneo de biblioteca cada 30 minutos, actualización de yt-dlp diario y limpieza de jobs.
- Escuchar música offline sin conexión a internet tras descargar las pistas
- Sincronizar listas de reproducción, likes e historial entre múltiples dispositivos
- Importar metadatos de Spotify manteniendo el audio de YouTube Music
- Auto-alojar una alternativa gratuita a servicios de streaming comerciales
- Reproducción offline real: archivos almacenados localmente sin dependencia de red
- Streaming en tiempo real con Socket.IO mientras se descargan pistas activas
- Validación SSRF integrada en todas las peticiones externas a servidores
- Sistema de jobs programados para mantenimiento automático de la biblioteca
- Soporte nativo para Android mediante Capacitor con APK compilado
- MongoDB es opcional pero recomendado; sin él se pierde persistencia de cuentas y análisis
- Requiere ffmpeg instalado en PATH para conversión de audio por yt-dlp
- Modo producción exige variables de entorno configuradas correctamente o no inicia
- Clerk es obligatorio para autenticación multi-dispositivo (modo local sin Clerk existe)
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.
Desplegar con Docker Compose incluido. Asegurar ffmpeg en PATH antes de iniciar. Para producción, configurar ENV=production y establecer CLERK_SECRET_KEY, CLERK_PUBLISHABLE_KEY y SECRET_KEY obligatorios. MongoDB debe estar disponible o la app funcionará sin persistencia de cuentas. Portos: 8000 (API), 3000 (frontend), 27017 (MongoDB). Validar CORS_ORIGINS según necesidad.
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.