FOSFENO: motor de visuales audio-reactivas para Raspberry Pi

Primera version. Cinco motores (projectM, Butterchurn, Hydra, Shaders GLSL y mezclador VJ con camara y video), panel de control web, deteccion de BPM propia, pantalla de conexion con codigo QR, instalador robusto para Raspberry Pi 4 y 5 y documentacion completa en docs/.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

docs/README.md

@@ -0,0 +1,28 @@
+# 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.
+
+- [Uso del panel](uso.md)
+  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](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.
+
+Si solo quieres empezar rápido, el archivo `README.md` de la raíz del
+proyecto tiene la versión resumida.