beatster
Beatster es un juego de música en tiempo real autoalojado para fiestas privadas, basado en navegador. Utiliza React/Next.js para el frontend y FastAPI/Python para el backend, con persistencia en SQLite y caché JSON. Soporta dos modos: Classic (adivinar posición temporal) y Music Bingo.
Ficha actualizada 22 sept 2026, 16:16 · upstream 31 ago 2026, 12:12 · release sin release detectada
Qué es beatster
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Beatster es una aplicación web autoalojada diseñada para noches de juegos entre amigos, donde los participantes adivinan la posición cronológica de fragmentos musicales o responden preguntas simultáneas en modo Bingo. La arquitectura separa el frontend (React 19 + Vite) del backend (FastAPI), comunicándose vía WebSockets con autoridad del servidor para evitar trampas. El sistema incluye oponentes IA y un catálogo pre-sembrado de ~475 pistas curadas para evitar latencia en la carga inicial.
- Fiestas privadas en LAN donde todos se conectan a una IP local sin necesidad de cuentas.
- Eventos online con amigos remotos usando un VPS pequeño con HTTPS y reverse proxy.
- Modo 'sofá' para proyectar el juego en TV con audio solo desde el host.
- Juego contra IA para práctica individual o demostración del catálogo musical.
- Arquitectura ligera: un proceso backend maneja API, WebSockets y frontend estático.
- Persistencia robusta: rooms guardadas en snapshots JSON y estadísticas en SQLite.
- Catálogo pre-sembrado incluido para evitar llamadas a iTunes API al iniciar.
- Modo sofá para audio único desde el host, ideal para TV o altavoces compartidos.
- Dependencia de previews de iTunes API; hosting público requiere verificar licencias locales.
- WebSockets requieren conexión estable; desconexiones pueden perder estado si no se checkpointea.
- Catálogo curado en inglés/alemán; fork necesario para otros idiomas o géneros específicos.
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.
Usar Docker Compose en LAN (port 8000) o VPS con HTTPS. Respaldo obligatorio del directorio ./data (catálogo, rooms, DB SQLite). Para acceso público, configurar reverse proxy (Caddy/nginx) y evitar exposición directa de IP doméstica sin proxy.
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.