open source · macOS 15 · Apple silicon

beats-btw-dj

A native DJ app that doesn't play files. It performs music: each deck runs a live Petri net, composed from a genre and a seed, and you mix two of them with real hardware, or let the app walk and hand off the set by itself.

Get the source on GitHub Listen to the sets →

What it does

Two decks of live nets

Each deck is a turntable you can scratch, or a Petri net composed natively from genre + seed + structure, or loaded from a beats share link. Scratching a net deck runs its clock backwards.

Perform the track, not the file

Jump sections, mute roles, fire stingers, play the MPK's keys into the track's scale, and drive 18 master-chain FX, pitch and feel macros from any controller, the UI, or MCP.

Wander and auto-mix

A deck can walk by itself, one move per phrase. AUTO hands the set between decks: the idle deck gets a neighbouring track (next seed, another instrument, a nearby genre in a compatible key), then they swap drums-forward on a phrase boundary.

Sets that replay exactly

A set is a recorded sequence of moves over deterministic configurations, so it re-renders to the same audio. Published sets are content-addressed, and the CID is the name.

See the music

The scope panel, per deck or on the master, drawn by the app's own view code.

Scope: the waveform above lanes for hi-hat, kick, snare, bass, harmony, melody and four stinger roles, with each note drawn as a tick
Scope: the waveform over the role lanes. Every tick is a transition firing.
Spectrogram per bar, warm colours for energy
Spectro: spectrogram per bar.
Energy per frequency band per bar
Bands: energy per band per bar.

Played on real hardware

All three at once, hot-pluggable. Every control is either bound or explicitly parked with a reason, and the app draws each device with its bindings.

The app's map of the Hercules DJControl Inpulse 200 MK3: jogs, EQ, filter, pads, sync, cue and play, each labelled with its binding
Hercules DJControl Inpulse 200 MK3: jogs (scratch, bend, seek), EQ, filters, crossfader, pad modes, and a headphone cue on its outputs 3/4.
The app's map of the Akai APC mini mk2 grid
Akai APC mini mk2: macro grid, per-role mutes, 64 loops, FX faders.
The app's map of the Akai MPK Mini Mk II
Akai MPK Mini Mk II: keys snapped to the track's scale, mixer knobs, hot-cue pads.

Build it

Swift (SwiftUI, CoreMIDI, AVAudioEngine) built with SwiftPM. There's no Xcode project: the Command Line Tools with Swift 6.2+ are enough. Needs macOS 15.

git clone https://github.com/stackdump/beats-btw-dj
cd beats-btw-dj
make run-app-release   # build an optimized DJApp.app and open it
make install-app       # or install it as ~/Applications/beats-btw-dj.app
make swift-test        # the test suite

No controller? It still runs: the UI drives everything, and so does its MCP server. The generator is ported from beats-btw and held to the same CIDs and bytes by fixtures from the real JavaScript. See the manual.

Latest sets

All works →

Recorded in the app and published from its own Publish… button. Free to share and adapt under CC BY 4.0.

Loading…