lumora

tu música, hecha luz.

probar en el navegador · página del producto · ver el promo (67 s)

lyric videos en vivo para lo que suena en tu mac. le das play en apple music o spotify y lumora arma el video solo: letra sincronizada, escenas ilustradas a mano en risografía, tipografía cinética y subtítulos traducidos. el guion lo escribe un director local que no necesita internet ni suscripción; claude es opcional.

qué tiene

• videoclip en risografía: 31 escenas, más de 80 objetos que se dibujan solos y cortes con movimiento que siguen la energía de cada estrofa.
• fábula: motor independiente de risografía, con pintura procedural, tipografía de novela y marcos ornamentales; la letra dirige escenarios, personajes articulados, acciones y cinco tipos de plano. comparte el catálogo de 810 dibujos y la dirección narrativa con risografía, con escenas también durante estribillos repetitivos e instrumentales. se elige en ajustes > tipo de animación. también adapta la interfaz y las exportaciones.
• continuidad narrativa local: personajes que esperan, se marchan y regresan; escenarios y símbolos que persisten entre versos y vuelven con el estribillo. 71 perfiles de artistas y 12 nuevos objetos para contar la historia (capturas y validación).
• la letra se escribe a mano, palabra por palabra, con la palabra clave subrayada y la traducción debajo (en↔es, pt→es con el traductor de apple en el dispositivo).
• modo carátula: composición editorial, centrada o inmersiva; letra y traducción ajustables en tamaño, fuente, ancho, interlineado, espaciado y posición. incluye estilos guardados, concentración, letra completa navegable y exportación de una composición limpia. detalles y captura real.
• capturar un verso (tecla v): foto PNG o video MP4 en 9:16, 4:5, 1:1 o 16:9 para compartir.
• grabar clips en mp4 en horizontal o vertical, y modo de grabación para obs.
• modo autor: edita a mano el video de cualquier canción, escena por escena y verso por verso.
• luces govee por red local que siguen el color y el pulso de la canción.
• sin cuentas ni apis de pago para lo esencial; todo corre en tu mac.

el detalle completo está en docs/FUNCIONES.md.

instalación

descarga Lumora.dmg (en las releases del repositorio), arrastra Lumora.app a Aplicaciones y ábrela. aparece un icono en la barra de menú, arranca el puente sola y abre lumora en su propia ventana; detecta lo que suena en Música o Spotify. la primera vez macOS pide permiso de Automatización para Música y Spotify (y Grabación de pantalla para el audio del sistema). mientras la app no esté notarizada, ábrela con clic derecho > abrir. cómo construirla y firmarla: docs/DISTRIBUCION.md.

si prefieres el código:

git clone https://github.com/kisnner26/lumora.git
cd lumora
./build.sh
python3 bridge.py

abre http://127.0.0.1:8888/index.html y dale play a cualquier canción. , abre los ajustes. para construir la app tú mismo: tools/empaquetar.sh.

letras propias

si prefieres no depender de un servicio, pon tus letras en ~/Library/Application Support/Lumora/letras/ con el nombre artista - título.lrc (con tiempos) o .txt (sin tiempos). la letra propia tiene prioridad sobre lrclib.

versión web (github pages)

https://kisnner26.github.io/lumora/app/ corre lumora en el navegador, sin instalar nada: conectas spotify (login oficial de spotify, el token se queda en tu navegador) y al darle play a una canción lumora la detecta, trae la letra de lrclib y arma el video. no incluye lo que necesita la mac: traducción en el dispositivo, guion de claude, luces govee ni el análisis de audio del sistema. js/app/web-bridge.js reemplaza al puente de python; tools/build_pages.sh copia la app a docs/app. el client id de spotify va en js/app/config-web.js y, mientras la app de spotify esté en modo desarrollo, cada persona que la pruebe debe estar agregada por correo en el panel de spotify (hasta 25).

cómo funciona

apple music / spotify ─► bridge.py (osascript) ─► http://127.0.0.1:8888
                               │                        │
          lrclib, deezer ◄─────┤                        ▼
     traductor de apple ◄──────┤                  index.html (canvas)
      claude (guion.py) ◄──────┤                        │
     luces govee (lan) ◄───────┘◄───────────────────────┘

bridge.py es un servidor local en python: vigila qué suena, trae la letra, pide el guion a claude y controla las luces. la página es html + canvas 2d, sin frameworks.

requisitos

• macos 26 o más nuevo (el traductor en el dispositivo lo necesita)
• apple music o spotify de escritorio
• opcional: claude para el guion con ia, con tu suscripción vía claude code (claude en el terminal, con sesión iniciada) o una clave de api en ~/.config/lumora/anthropic_key
• opcional: ffmpeg, para convertir clips webm a mp4 (la ventana propia ya graba mp4)
• para compilar desde el código: xcode command line tools

documentación

• funciones en detalle · catálogo de dibujos
• decisiones de la app de mac · distribución, firma y notarización
• cómo contribuir · historial de cambios · seguridad

licencia

polyform noncommercial 1.0.0: puedes usarlo, estudiarlo y modificarlo para uso personal y sin fines comerciales. para uso comercial (streams monetizados, eventos, integrarlo en un producto) hace falta una licencia comercial: pídela aquí.

las letras, carátulas, logos y fotos que muestra la app pertenecen a sus dueños; lumora no las incluye, las consulta en vivo.