A browser-based, two-deck DJ mixer that works with the Fri3d DJ addon over Web MIDI, which loads local music files. It also works just with mouse controls.
Built with Vite + React + TypeScript + Tailwind CSS v4.
- Two decks with independent playback, loaded from your own audio files.
- 3-band EQ (low / mid / high), volume fader and an equal-power crossfader, all powered by the Web Audio API.
- Waveform per deck with a played/unplayed split, a playhead, and click-to-seek.
- Scratch platters that spin while playing and respond to the hardware scratch encoders or mouse drag.
- Transport pads: Play/Pause, Cue (to start) and two hot cues per deck.
- Web MIDI integration mapping every control on the Fri3d DJ addon, with LED feedback sent back to the controller and a console debug log of all MIDI traffic.
- BLOOPPAD-MAXX support: built-in synthesized drum kit, 8-step sequencer, two Launchpad-style User sample modes with 64 one-shot pads each, hardware grid input, drag/drop sample assignment, and full 8×8 RGB LED state.
- A Chromium-based browser (Web MIDI is required for the controller; Web Audio
for playback). The app must run over
localhostor HTTPS, Web MIDI needs a secure context. - A Fri3d DJ addon and BLOOPPAD-MAXX are optional: decks, samples, and sequencer are fully usable with a mouse.
npm install
npm run dev # start the dev server (http://localhost:5173)Then:
- Open the app and click Connect controller to grant Web MIDI access (skip this if you only want to use the mouse).
- Click Load track on each deck to choose an audio file.
- Use the built-in drum kit immediately, or replace any sound with your own audio file. Click grid steps (or press hardware pads) to build a sequence. Switch to User 1 or User 2 for two independent 64-pad sample banks.
- Hit Play, ride the EQ and faders, and work the crossfader.
npm run build # type-check and build for production
npm run preview # preview the production build
npm run lint # run ESLint