Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

Repository files navigation

Audio Visualizer 🎵✨

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

Features 🚀

  • 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-gui settings panel to tweak colors, intensity, and rotation speed on the fly.

Tech Stack 🛠

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

Quick Start 💻

Prerequisites

Make sure you have Node.js installed on your machine.

Installation

  1. Clone the repository:
    git clone https://github.com/sundown111/audio-visualizer.git
  2. Navigate into the project directory:
    cd audio-visualizer
  3. Install dependencies:
    npm install
  4. Start the development server:
    npm run dev
  5. Open your browser and go to http://localhost:5174 (or the port provided by Vite).

Building for Production

To generate a production-ready bundle, run:

npm run build

The compiled files will be located in the dist folder.

How to Use 🎛

  1. Audio Source: Click "CHOOSE TRACK" to upload an audio file, or click "USE MIC" to enable live microphone reactivity.
  2. Settings: Click the ⚙ (Gear) icon in the top right to open the control panel.
  3. Modes: Switch between the 10 available visual modes in the control panel.
  4. Custom Image: Click "UPLOAD PHOTO" to try out the unique Pixel Dancer mode with your own picture.
  5. Fullscreen: Hit the ⛶ (Fullscreen) icon for an immersive experience.

License 📄

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! 🎧

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages