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 designed to have zero friction between you and your first mix. There is nothing to install, no package manager to run, and no account to create. Everything lives in a single index.html file — download it, open it, and the app is ready. This guide walks you through the complete onboarding flow, from download to your first crossfade, and covers loading your own music files and using keyboard shortcuts.
Plug in headphones or external speakers before you start. NEON DJ’s built-in limiter keeps levels safe, but you’ll hear far more detail in the low-end and stereo field than laptop speakers can reproduce — essential for dialing in EQ and timing your crossfades.
1

Download the File

Go to the NEON DJ GitHub repository and download index.html:https://github.com/kepabilbao67-bot/musicplayer2On the repository page, click the index.html filename, then click the Download raw file button (the downward-arrow icon near the top-right of the file viewer). Save the file anywhere on your computer — your Desktop or Downloads folder works perfectly.Alternatively, if you have Git installed, clone the repository:
git clone https://github.com/kepabilbao67-bot/musicplayer2.git
cd musicplayer2
The only file you need to open is index.html. No npm install, no build step.
2

Open in Your Browser

Double-click index.html. It will open in your default browser.For best results, open it in Chrome, Edge, or Firefox. These browsers implement the full Web Audio API that NEON DJ depends on.
Chrome and Edge enforce a user-gesture policy for the AudioContext: audio cannot start until you interact with the page (click a button, drag a knob, etc.). If you see a loading screen that appears to finish but no sound plays when you press PLAY, click anywhere on the page first to unlock the audio context. This is a browser security requirement, not a bug in NEON DJ.
You will see a loading overlay with a progress bar and a status message like “Creando: House · 124 BPM” as each track is synthesized.
3

Wait for Track Synthesis

NEON DJ generates all 18 built-in genre tracks procedurally at startup using an OfflineAudioContext — no audio files are downloaded. Each track is rendered faster than real time; the full set typically takes 5–15 seconds depending on your device.The 18 synthesized genres and their tempos are:
GenreBPM
House124
Hip-Hop88
Techno130
Synthwave110
Reggaeton96
Drum & Bass174
Trap140
Funk108
Rock Español 80/90132
Heavy Metal 80/90160
Pop Español 80/90118
Punk 80/90172
Ska 80/90150
Grunge 90115
Salsa95
Cumbia92
Jungle / DnB165
Dubstep140
When synthesis is complete the loading overlay disappears and House is automatically loaded on Deck A and Techno on Deck B.
4

Play Your First Mix

With both decks pre-loaded, you’re ready to mix:
  1. Press PLAY on Deck A. The vinyl graphic begins rotating, the waveform playhead advances, and the beat LED pulses on every quarter note.
  2. Listen to the BPM display on Deck B. Press the SYNC button on Deck B — it will match Techno’s tempo to House’s and align the beat grid automatically.
  3. Press PLAY on Deck B.
  4. Drag the crossfader (the horizontal slider between the two decks) from the center toward the B side to bring Techno in, or toward A to return to House.
That’s it — you’re mixing.
Double-click any EQ knob (AGUDOS / MEDIOS / GRAVES) to reset it to 0 dB. A common technique is to cut the lows on the incoming deck while you blend, then restore them once the crossfader is fully across.
5

Load a Custom MP3 or WAV

You can replace either deck’s built-in track with any audio file from your computer:
  1. Click the 📁 button in the top-left corner of the deck you want to load into.
  2. Choose any MP3, WAV, OGG, or other browser-supported audio file.
  3. The file is decoded in-memory by the Web Audio API — nothing is uploaded anywhere.
  4. Once loaded, the track name updates in the deck header and the waveform is redrawn.
Deck A  ──►  📁 button  ──►  File picker  ──►  Track loads instantly
Deck B  ──►  📁 button  ──►  File picker  ──►  Track loads instantly
NEON DJ does not auto-detect the BPM of custom files. After loading your own track, you can manually align it with the other deck using the pitch fader (±50%) and listening for the beats to lock. The beat LED on each deck helps you find the downbeat visually.

​
Keyboard Shortcuts

Every major transport control has a keyboard shortcut so you can keep your hands on the mouse for knobs and the crossfader while triggering cues and loops from the keyboard.
KeyAction
QPlay / Pause — Deck A
PPlay / Pause — Deck B
ACUE — Deck A
LCUE — Deck B
ZLOOP 4 — Deck A
MLOOP 4 — Deck B
SSYNC — Deck A
KSYNC — Deck B
←Move crossfader left (toward A)
→Move crossfader right (toward B)
1FX Pad — ⬆ Riser
2FX Pad — 📢 Airhorn
3FX Pad — 💥 Impact
4FX Pad — ⚡ Zap

​
What’s Next

Decks & Transport

Deep dive into the waveform display, scratch mode, hot cues, loops, and the pitch fader.

EQ & Effects

Learn how the 3-band EQ, filter sweep, echo delay, reverb, and FX pads work.

Recording a Mix

Capture your session and download it as an MP3 or WAV file.

Introduction

Read the full feature overview and technical architecture.

Build docs developers (and LLMs) love

Get started for freeTalk to us