> ## Documentation Index
> Fetch the complete documentation index at: https://dub-3ccc829c.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Dub

> Timecode vinyl for scratch DJs and sound systems. Two turntables, your own mixer, real records through the software.

![Dub's Performance surface: two decks with vertical colour waveforms and a phase meter between them, hot cues, loops, echo, the sampler, the dub siren and the library](https://mintcdn.com/dub-3ccc829c/yjsJ2nZv-7OeAFUs/images/performance.png?fit=max\&auto=format\&n=yjsJ2nZv-7OeAFUs\&q=85\&s=24ab8962ba63da59ddcb23bf699b9c60)

Dub is a timecode-vinyl DJ app for macOS, built for hip hop, reggae, dub,
drum'n'bass and dubstep, and for never failing on stage. It is open source
(MIT or Apache-2.0) with a Rust audio engine underneath.

> [!WARNING]
>
> **Dub is in alpha.** It plays, scratches, loops, rips and dubs on real
> hardware today, and it is still being proven on the rig one session at a
> time. Try it at home, in the studio, at a practice session. Don't take it to a
> paying gig yet, and please [tell us what breaks](https://github.com/kLOsk/dub/issues).

## What makes it different

Most DJ software wants to be the whole booth. Dub wants to be the part
between your turntables and your mixer, and to be very good at it.

* **Your mixer is the mixer.** There is no software crossfader, EQ or gain.
  Each deck leaves on its own output pair and you mix with your hands.
* **Real records are first-class.** Flip a deck to **THRU** and the record on
  the platter runs through Dub, with a live waveform, a live tempo and the
  effects on it.
* **Reliability is the feature.** The audio engine never allocates memory,
  waits on a lock or blocks while it plays, and every change is tested for it.
* **Yours to leave.** Dub imports from Serato, Traktor, rekordbox, Apple Music
  and Lexicon, and exports back to rekordbox XML and M3U8.

## Two surfaces

* **Performance** is the two-deck surface for the set. It needs an audio
  interface with at least 4 inputs and 4 outputs, control vinyl and an
  external mixer.
* **Prep** is one deck on your Mac's own output, for beat grids, cues and
  samples before the gig. Dub opens in Prep when no interface is plugged in.

## Start here

> [card] [Install Dub](https://dub-3ccc829c.mintlify.site/install.md)
>
> Download the alpha and get it past macOS's first-run check.

> [card] [Hardware](https://dub-3ccc829c.mintlify.site/hardware.md)
>
> Interfaces, control vinyl, and setting up an interface Dub doesn't know.

> [card] [Your first set](https://dub-3ccc829c.mintlify.site/first-set.md)
>
> Wire it up, drop the needle, read the signal panel.

> [card] [Bring your library](https://dub-3ccc829c.mintlify.site/library/import.md)
>
> Serato, Traktor, rekordbox, Apple Music and Lexicon.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.