FOSFENO/docs
hacklab 8dd58bb293 Mapping in-browser (Fase 1) + trabajo en curso
Projection mapping editable desde el navegador, sin herramientas externas:
- web/stage/mapper.js (nuevo): compositor WebGL que texturiza el motor activo
  sobre superficies deformables (homografia por vertice: keystone correcto).
- Editor con raton en el escenario (crear, arrastrar esquinas, mover, borrar)
  y previsualizacion arrastrable en el panel (raton/tactil) para editar desde
  el movil sin tocar la ventana de visuales.
- Backend: estado "mapping" + evento set_mapping, persistido en data/mapping.json
  (ignorado en git). Seccion "Mapping" en el panel + texto de ayuda.
- Solo motores web (butterchurn/hydra/shaders/mixer); projectM no se mapea.
- .gitignore: excluye config de runtime (mapping.json, pm-favoritos.json).

Incluye ademas trabajo en curso previo sin commitear (server.py, stage.js,
panel.js/css, ayuda.json, hydra-sketches.json, problemas.md,
start-projectm.sh), subido junto a peticion del autor.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-27 00:19:30 +02:00
..
assets Documentacion: captura del panel y video de demostracion 2026-05-22 18:42:42 +02:00
conexion.md FOSFENO: motor de visuales audio-reactivas para Raspberry Pi 2026-05-22 14:18:19 +02:00
instalacion.md FOSFENO: motor de visuales audio-reactivas para Raspberry Pi 2026-05-22 14:18:19 +02:00
portatil.md Soporte multi-distro en portatil, titulos mas grandes, panel mas ancho y refresco de microfono 2026-05-22 18:11:01 +02:00
problemas.md Mapping in-browser (Fase 1) + trabajo en curso 2026-07-27 00:19:30 +02:00
README.md Modo portatil: ejecutar FOSFENO en un portatil Linux 2026-05-22 14:39:34 +02:00
requisitos.md Documentacion: imagenes de Raspberry Pi 5, MilkDrop y Hydra 2026-05-22 18:27:38 +02:00
uso.md Documentacion: captura del panel y video de demostracion 2026-05-22 18:42:42 +02:00

Documentación de FOSFENO

Esta carpeta reúne todo lo necesario para montar, instalar y usar FOSFENO sin tener que adivinar nada. Está pensada para leerse en orden la primera vez y para consultarse a saltos después.

  • Requisitos y hardware Qué Raspberry Pi necesitas, qué cable va al proyector y, sobre todo, qué micrófonos USB y qué cámaras funcionan sin instalar drivers.

  • Instalación Cómo se instala paso a paso y, con detalle, qué descarga y compila el script de instalación en tu Raspberry.

  • Conectarse al panel Cómo encuentra el usuario el panel de control: el código QR del proyector, la dirección fosfeno.local y qué hacer con el router.

  • FOSFENO en un portátil Linux Cómo correr FOSFENO en un portátil Debian, Ubuntu o Mint, sin Raspberry Pi.

  • Uso del panel Cómo se maneja desde el móvil, qué hace cada motor de visuales y cómo se configura cada opción.

  • Solución de problemas Qué hacer cuando algo no arranca, no se ve o no suena. Incluye cómo leer los mensajes de error que aparecen en el propio panel.

Si solo quieres empezar rápido, el archivo README.md de la raíz del proyecto tiene la versión resumida.