A professional, enterprise-grade 3D audio visualizer built for live DJ environments, festivals, and personal entertainment. Powered by Three.js and the Web Audio API, this application delivers real-time, high-fidelity WebGL graphics reacting directly to audio frequencies (Bass, Mid, High).
- Live Microphone Input: Hook up your microphone and let the visuals react to ambient sound or live music instantly.
- Audio File Upload: Upload local audio files (
.mp3,.wav) with a built-in interactive progress bar and play/pause controls. - Photo to Particles (Pixel Dancer): Upload any image or photo, and the visualizer will instantly translate it into a vibrant 3D point-cloud that dances and ripples to the music's frequencies.
- 10 Professional Visual Modes:
- Core Reactor: A massive, pulsing star-like core surrounded by an audio-reactive wireframe shell and swirling debris.
- Liquid Ocean: A retro-synthwave style rolling wireframe terrain with a pulsing glowing sun/moon in the background.
- Hyperspace: A warp-speed tunnel of stars that accelerates and swirls heavily to the bass.
- Stage Spectrogram: A circular array of towering EQ bars that mimic a massive festival stage setup.
- Pixel Dancer: (Triggered via Image Upload) Converts a 2D image into 3D particles.
- Neon Sphere: A clean, wireframe sphere that scales violently to the bass.
- Equalizer Grid: A classic, smooth floor grid of pulsing EQ cubes.
- Particle Tunnel: A multi-layered torus-based particle tunnel.
- Cyber Ring: Geometric glowing rings and audio-reactive spikes.
- Fractal Wave: A rolling plane of waves accompanied by floating light orbs.
- Neon Post-Processing: Integrated Unreal Bloom Pass for a stunning, glowing aesthetic on the hardcore visual modes.
- Extensive UI Control: A sleek, dark-mode glassmorphism interface with a collapsible
lil-guisettings panel to tweak colors, intensity, and rotation speed on the fly.
- Three.js (WebGL 3D Engine)
- Web Audio API (AnalyserNode, MediaStreamSource for frequency mapping)
- Vite (Next Generation Frontend Tooling)
- Vanilla JavaScript, HTML, & CSS
- lil-gui (Control interface)
Make sure you have Node.js installed on your machine.
- Clone the repository:
git clone https://github.com/sundown111/audio-visualizer.git
- Navigate into the project directory:
cd audio-visualizer - Install dependencies:
npm install
- Start the development server:
npm run dev
- Open your browser and go to
http://localhost:5174(or the port provided by Vite).
To generate a production-ready bundle, run:
npm run buildThe compiled files will be located in the dist folder.
- Audio Source: Click "CHOOSE TRACK" to upload an audio file, or click "USE MIC" to enable live microphone reactivity.
- Settings: Click the ⚙ (Gear) icon in the top right to open the control panel.
- Modes: Switch between the 10 available visual modes in the control panel.
- Custom Image: Click "UPLOAD PHOTO" to try out the unique Pixel Dancer mode with your own picture.
- Fullscreen: Hit the ⛶ (Fullscreen) icon for an immersive experience.
This project is licensed under the MIT License. See the LICENSE file for details. It is completely free to use, modify, and distribute.
Enjoy the show! 🎧