Initial commit: DJ Visualizer

Electron app with audio-reactive fractal/abstract visuals on an external
display. Dual-window setup (control panel + fullscreen output), 8 WebGL
scenes, audio from file/live input/system audio, image and scrolling-text
overlays.

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

README.md

@@ -0,0 +1,75 @@
+# DJ Visualizer
+
+App desktop (Electron) per Mac che mostra **frattali e visual astratti reattivi all'audio** su uno schermo esterno. L'audio può arrivare da un **file caricato**, da un **input live** (microfono / line-in) o dall'**audio di sistema** (il tuo set DJ) tramite un device virtuale tipo BlackHole. Puoi sovrapporre **immagini** e **scritte scorrevoli**.
+
+## Due finestre
+
+All'avvio si aprono **due finestre**:
+
+- **Controlli** — il pannello con tutte le funzioni (sorgente audio, scene, slider, immagini, testo, scelta monitor). Sta sul tuo schermo principale.
+- **Output** — solo la visualizzazione, senza interfaccia. Va automaticamente a schermo intero sul monitor esterno se presente.
+
+Comandi e tasti agiscono sul pannello Controlli e si riflettono sull'Output. Chiudendo la finestra Controlli si chiude tutta l'app.
+
+## Avvio
+
+```bash
+npm install      # solo la prima volta
+npm start
+```
+
+## Controlli rapidi (tastiera)
+
+| Tasto | Azione |
+|-------|--------|
+| `1` `2` `3` | Cambia scena (Frattale · Plasma · Tunnel) |
+| `F` | Schermo intero |
+| `H` | Mostra/nascondi pannello |
+| `O` | Apri file audio |
+| `I` | Usa input live selezionato |
+| `G` | Carica immagini |
+| `T` | Mostra/nascondi testo scorrevole |
+| `← →` | Cambia immagine |
+| `Spazio` | Play/pausa del file |
+
+Puoi anche **trascinare** un brano (mp3/wav) o delle immagini direttamente sulla finestra.
+
+## Schermo esterno
+
+Nel pannello, sezione **Schermo**: scegli il monitor (di default seleziona quello esterno) e premi **Vai** → la finestra si sposta e va a schermo intero su quel display. `F` per uscire.
+
+## Sorgenti audio
+
+- **File**: pulsante 📂 o trascina il file. L'audio si sente dalle casse del Mac.
+- **Input live (mic / line-in)**: seleziona il device dal menu e premi *Usa input*. Utile con una scheda audio/mixer collegato all'ingresso.
+- **Audio di sistema (il tuo set)**: serve un device virtuale, vedi sotto.
+
+### Catturare l'audio di sistema con BlackHole
+
+macOS non permette di catturare direttamente l'audio in uscita. Soluzione gratuita: **BlackHole**.
+
+1. Installa BlackHole (2ch):
+   ```bash
+   brew install blackhole-2ch
+   ```
+   (oppure scaricalo da https://existential.audio/blackhole/)
+
+2. Per **sentire l'audio E inviarlo al visualizer** allo stesso tempo, crea un **Multi-Output Device** in *Audio MIDI Setup* (Configurazione MIDI Audio):
+   - `+` in basso a sinistra → **Create Multi-Output Device**
+   - spunta sia le tue **casse/cuffie** sia **BlackHole 2ch**
+   - imposta questo Multi-Output come uscita del Mac (o del software DJ)
+
+3. In DJ Visualizer scegli **BlackHole 2ch** come input live e premi *Usa input*.
+
+> In alternativa, manda direttamente l'uscita del software DJ a BlackHole se preferisci non sentire nulla dalle casse del Mac.
+
+## Personalizzare i visual
+
+Le scene sono shader GLSL in `src/shaders.js` (array `SHADERS.scenes`). Ognuna riceve uniform audio: `uBass`, `uMid`, `uTreble`, `uLevel`, `uBeat`, più `uTime` e `uRes`. Aggiungere una scena = aggiungere uno shader all'array e un bottone in `index.html`.
+
+## Build di un .app/.dmg
+
+```bash
+npm run dist
+```
+Genera un `.dmg` in `dist/` (richiede electron-builder, già incluso).