# 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](requisitos.md)
  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](instalacion.md)
  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](conexion.md)
  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](portatil.md)
  Cómo correr FOSFENO en un portátil Debian, Ubuntu o Mint, sin Raspberry Pi.

- [Uso del panel](uso.md)
  Cómo se maneja desde el móvil, las dos pestañas (MOTORES y MAPPING), qué
  hace cada motor de visuales y cómo se configura cada opción.

- [El Mezclador VJ](mezclador.md)
  Las mezclas a fondo: las dos capas, cómo poner visuales de MilkDrop de
  fondo, los modos de mezcla y los efectos de color.

- [La galería de visuales](visuales.md)
  El catálogo de clips: cómo se generan las fichas, cómo distingue una silueta
  de un trozo de película y por qué unos clips salen marcados como flojos.

- [Projection mapping](mapping.md)
  Cómo deformar las visuales para encajarlas en superficies físicas, y cómo
  poner **un visual distinto en cada zona**: capas, fuentes, malla y máscaras.

- [Solución de problemas](problemas.md)
  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.

- [Seguridad](seguridad.md)
  Qué asume el diseño, qué pasa si pinchas en una wifi pública y cómo cerrar
  el panel con una clave compartida (el QR ya la lleva dentro).

- [Arquitectura](arquitectura.md)
  Para quien vaya a tocar el código: las tres piezas, el estado, los eventos
  de WebSocket, cómo se añade un motor y los criterios que sigue el proyecto.

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