Files
djaudiovisualizer/README.md
T
lucianoandClaude Opus 4.8 b32ea47ae5 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>
2026-06-19 12:44:17 +02:00

3.1 KiB

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

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):

    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

npm run dist

Genera un .dmg in dist/ (richiede electron-builder, già incluso).