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/requisitos.md

@@ -0,0 +1,97 @@
+# Requisitos y hardware
+
+FOSFENO funciona en una Raspberry Pi conectada a un proyector. La Raspberry
+escucha el sonido de la sala a través de un micrófono USB y dibuja visuales
+que reaccionan a la música. Todo se gobierna desde el móvil con un navegador.
+
+## Raspberry Pi
+
+Sirve una Raspberry Pi 4 o una Raspberry Pi 5. La Pi 5 va más holgada con los
+shaders y el mezclador de vídeo, así que es la recomendada si vas a usar esos
+modos a menudo. La Pi 4 cumple de sobra para Butterchurn e Hydra.
+
+Necesitas además:
+
+- La fuente de alimentación oficial. Los visuales exigen GPU y CPU; con
+  cargadores genéricos la Pi puede reiniciarse sola.
+- Una tarjeta microSD de 32 GB o más, o mejor un SSD por USB en la Pi 5.
+- Disipador o ventilador. Mantener visuales en bucle calienta la placa, y si
+  se calienta de más reduce su velocidad y las visuales van a tirones.
+- Sistema operativo Raspberry Pi OS Bookworm de 64 bits, con escritorio.
+
+## Conexión con el proyector
+
+La Pi 4 y la Pi 5 llevan salida micro-HDMI, no HDMI normal. Necesitas un cable
+micro-HDMI a HDMI, o un adaptador. Cualquier proyector con entrada HDMI vale.
+La resolución la ajusta el sistema; si el proyector es de 1280x720 las
+visuales irán más finas que a 1080p.
+
+## Red
+
+El panel de control se abre desde el móvil, así que el móvil y la Raspberry
+tienen que estar en la misma red. El cable Ethernet es más estable que el
+WiFi para un evento, pero las dos opciones funcionan. Conviene fijar la IP de
+la Raspberry en el router para que no cambie entre un día y otro.
+
+## Micrófono USB y audio
+
+La Raspberry Pi no tiene entrada de audio. El conector jack de la placa es
+solo salida. Para que FOSFENO oiga la música hay que añadir una entrada por
+USB.
+
+Funcionan sin instalar nada los dispositivos que cumplen el estándar USB
+Audio Class. En la práctica eso es casi todo lo que se vende hoy:
+
+- Tarjetas de sonido USB. Son adaptadores pequeños con un USB por un lado y
+  conectores jack por el otro. Las que traen entrada de micrófono o entrada
+  de línea sirven para enchufar el sonido desde una mesa de mezclas o desde
+  un móvil. Dan la señal más limpia.
+- Micrófonos USB. Los micrófonos de condensador tipo podcast (Fifine, Samson,
+  Blue Snowball y similares) se conectan directos y captan el sonido de la
+  sala. Es la opción más cómoda si no quieres tirar cables.
+- Interfaces de audio USB y auriculares USB con micro. También valen mientras
+  sean USB Audio Class, que es lo normal.
+
+Evita los micrófonos Bluetooth. Tienen retardo y FOSFENO no los selecciona de
+forma automática. Evita también cualquier aparato que pida un driver del
+fabricante; con audio es raro, pero los hay.
+
+FOSFENO elige la entrada automáticamente al arrancar. Busca entre las fuentes
+de audio del sistema la primera cuyo nombre contenga la palabra `usb`. Si tu
+dispositivo no se llama así, puedes cambiar esa palabra clave en `config.json`,
+en el apartado `audio.matchSource`. Desde el panel también puedes elegir a
+mano cualquier entrada detectada.
+
+Recomendación práctica: para un evento con mesa de DJ, una tarjeta USB con
+entrada de línea conectada por jack a la salida de la mesa. Para algo casero o
+una fiesta, un micrófono USB que recoja el ambiente.
+
+## Cámara USB
+
+La cámara solo hace falta para el modo Mezclador. FOSFENO está preparado para
+cámaras web USB.
+
+Funcionan sin drivers las cámaras que cumplen el estándar USB Video Class,
+conocido como UVC. Prácticamente todas las cámaras web USB modernas lo
+cumplen: las de Logitech, las genéricas, las de portátil externas. Conéctala
+antes de encender la Raspberry y el sistema la reconoce sola. El navegador la
+ve a través de V4L2, el subsistema de vídeo de Linux.
+
+Esta versión de FOSFENO no usa el módulo de cámara oficial de la Raspberry, el
+que va con cable plano al conector CSI. En Raspberry Pi OS Bookworm ese módulo
+funciona a través de libcamera y no aparece como cámara estándar para el
+navegador sin pasos extra. Si quieres cámara, usa una webcam USB UVC.
+
+Recomendación práctica: cualquier webcam USB de 720p sirve. No hace falta
+nada caro. Si la cámara permite varias resoluciones, el navegador elige una
+compatible automáticamente.
+
+## Resumen de la lista de la compra
+
+- Raspberry Pi 4 o 5 con su fuente oficial.
+- microSD de 32 GB o SSD USB.
+- Disipador o ventilador.
+- Cable micro-HDMI a HDMI.
+- Micrófono USB o tarjeta de sonido USB con entrada.
+- Webcam USB UVC, solo si vas a usar el modo Mezclador.
+- Cable de red, o WiFi.