FOSFENO/docs/README.md
hacklab 5d5223db9f Docs del mapping (Fase 1+2) + gitignore de runtime
- docs/mapping.md: guia del projection mapping (activar, superficies con malla
  para curvar, mascaras, editar arrastrando desde el panel, dónde se guarda,
  limitaciones). Enlazada desde docs/README.md y el README principal.
- .gitignore: ignora data/pm-fijado/ (runtime de projectM).

El mapper funcional (esquinas + malla + mascaras, para Butterchurn/Hydra/
Shaders/Mezclador) ya estaba en main (Fase 1 y 2). La via de captura para
projectM nativo se retira por ahora; se retoma mas adelante.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-27 01:16:37 +02:00

1.4 KiB

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.

  • Projection mapping Cómo deformar las visuales para encajarlas en superficies físicas: malla, máscaras y edición desde el panel arrastrando con el ratón o el dedo.

  • 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.