Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/kepabilbao67-bot/musicplayer2/llms.txt

Use this file to discover all available pages before exploring further.

NEON DJ is a fully featured DJ mixer that runs entirely inside your web browser — no installation, no accounts, no build tools. The entire application ships as a single index.html file. Open it, wait a few seconds while the built-in tracks are synthesized, and you’re ready to mix. Whether you’re learning to DJ for the first time or just want to experiment with loops and effects without setting up professional software, NEON DJ gives you a real dual-deck workflow straight out of the box.

Key Features

NEON DJ packs a professional-grade feature set into one self-contained file:

Dual Decks

Two independent decks (A and B), each with a spinning vinyl simulation, waveform display, animated VU meters, and a beat LED that pulses on every quarter note.

18 Synthesized Genres

House, Hip-Hop, Techno, Synthwave, Reggaeton, Drum & Bass, Trap, Funk, Rock Español 80/90, Heavy Metal 80/90, Pop Español 80/90, Punk 80/90, Ska 80/90, Grunge 90, Salsa, Cumbia, Jungle/DnB, and Dubstep — all generated at runtime with zero copyright restrictions.

EQ & Effects Per Deck

A 3-band EQ (high shelf at 3800 Hz, peaking mid at 1000 Hz, low shelf at 200 Hz), a resonant filter sweep, echo/delay send, and convolution reverb — each controlled by rotary knobs per deck.

Crossfader & BPM Sync

A hardware-style crossfader, individual channel faders, master volume, and a SYNC button that matches BPM and beat-aligns the phrase with the other deck automatically.

Hot Cues & Loops

Three hot-cue points per deck — tap once to set, tap again to jump. A 4-beat loop button for instant repeats, plus a CUE button that returns to the last set cue point.

Scratch Mode

Drag the vinyl graphic with your mouse to simulate turntable scratching and jogging. The pitch fader adjusts playback speed ±50% independently on each deck.

FX Pads

Seven one-shot and throw effects triggered by pad buttons or number keys: Riser, Airhorn, Impact, Zap, Flanger, Tape Stop, and Echo.

Mix Recording & Export

Record your live mix by pressing ● REC and stop to download it. The app exports MP3 (128 kbps stereo via lamejs when online) or falls back to a raw WAV file — playable everywhere.

How It Works

NEON DJ is built entirely on the browser’s native Web Audio API — no third-party audio frameworks are required.

Track Synthesis

When the page loads, each of the 18 built-in genre definitions is rendered into an audio buffer using an OfflineAudioContext. The synthesis engine builds every element programmatically — kick drums with exponential pitch envelopes, snares through bandpass-filtered noise bursts, hi-hats via highpass-filtered noise, sawtooth bass lines through resonant low-pass filters, and synthesizer leads using square and sawtooth oscillators. The process runs faster than real time and completes in a few seconds before playback begins.

Per-Deck Signal Chain

Once a track is loaded, audio flows through a fixed processing chain inside each deck:
Source → EQ Low → EQ Mid → EQ High → Filter → Channel Gain → Cross Gain → Master

                                               Delay Send → Delay → Cross Gain
                                               Reverb Send → Convolver → Cross Gain
                                               Analyser (VU meter tap)
The master bus feeds a limiter node before reaching the hardware output.

Mix Recording

The master output is tapped by a ScriptProcessorNode that accumulates raw PCM samples in two float arrays (left and right channels). On stop, these are either encoded to MP3 using lamejs (loaded lazily from the internet) or packed into a standard 16-bit stereo WAV blob using a pure-JavaScript encoder built into the file.

Auto Mix & Settings Persistence

The 🤖 AUTO MIX button automates the crossfader transitions between decks. All knob positions, selected tracks, and fader values are saved automatically to localStorage every three seconds and restored on the next visit.

Browser Compatibility

NEON DJ is tested and recommended on Chrome, Edge, and Firefox (desktop). These browsers expose the full Web Audio API surface, including OfflineAudioContext, ConvolverNode, and ScriptProcessorNode. Safari may work but is not the primary target. Mobile browsers have limited Web Audio support and may struggle with the synthesis step on low-end hardware.

Android APK

NEON DJ can also be packaged as a native Android .apk via a GitHub Actions workflow (using Apache Cordova) included in the repository. The workflow triggers automatically when index.html is updated on the main branch, and the resulting debug APK is published under the Releases tab or available as a workflow artifact. See the README for full instructions.

Explore the Docs

Quickstart

Download index.html and play your first mix in under a minute.

Decks & Transport

Waveform display, vinyl scratch, pitch, CUE, LOOP, SYNC, and hot cues explained.

EQ & Effects

3-band EQ, filter sweep, echo delay, reverb, and the FX pad bank.

Recording a Mix

Capture your session and export it as MP3 or WAV.

Build docs developers (and LLMs) love