Skip to content

Repository files navigation

Fri3d-scratcher

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.

Features

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

Requirements

  • A Chromium-based browser (Web MIDI is required for the controller; Web Audio for playback). The app must run over localhost or 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.

Getting started

npm install
npm run dev      # start the dev server (http://localhost:5173)

Then:

  1. Open the app and click Connect controller to grant Web MIDI access (skip this if you only want to use the mouse).
  2. Click Load track on each deck to choose an audio file.
  3. 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.
  4. Hit Play, ride the EQ and faders, and work the crossfader.

Other scripts

npm run build    # type-check and build for production
npm run preview  # preview the production build
npm run lint     # run ESLint

Used by

Contributors

Languages