Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/gueritta/primemixxx/llms.txt

Use this file to discover all available pages before exploring further.

primemixxx lets you run MIXXX — the professional open-source DJ software — on your Denon DJ Prime Go or Prime 4 hardware. The setup lives entirely on a microSD card: insert it to boot MIXXX, remove it to return to stock Engine OS instantly. No firmware modification required. No permanent changes.

Quickstart

Prepare your SD card, install the boot hook, and launch MIXXX in under 10 minutes.

Supported Devices

Check compatibility status for Prime Go and Prime 4, including known limitations.

Build from Source

Compile MIXXX for ARMv7 using Buildroot and produce a distributable SD card bundle.

Deploy to Device

Use the developer deploy scripts to push updates to your device over SSH.

​
How It Works

primemixxx uses the TKGL Bootstrap framework to inject a modular boot hook into the device’s systemd chain — without touching the internal eMMC. When the SD card is present, the hook launches MIXXX. When absent, Engine OS boots as normal.
1

Download the SD card bundle

Grab prime-series-sdcard-*.tar.gz from GitHub Releases.
2

Prepare your microSD card

Format as ext4 with label TKGL_BOOTSTRAP, then extract the bundle to the card root.
3

Run the one-time installer

SSH into the device and run install-device.sh from the SD card. This backs up your original engine.service and installs the TKGL stub.
4

Reboot and mix

Reboot with the SD card inserted — MIXXX launches automatically. Remove the card and reboot to return to Engine OS.

​
Key Features

Non-Destructive Boot

Everything runs from the SD card. Remove it at any time to return to stock Engine OS — no recovery needed.

5ms Audio Latency

PREEMPT_RT kernel with CPU shielding achieves a stable 5.8ms ALSA buffer on the Prime Go at 256/512 frames.

Full MIDI Mapping

All Prime Go controls — platters, faders, pads, jog wheels, and RGB LEDs — are mapped for MIXXX via XML + JavaScript.

USB Music Library

Plug in a USB drive with MP3s and MIXXX auto-mounts and scans it on startup.

​
Device Status

DeviceStatusNotes
Denon Prime Go✅ VerifiedDisplay, audio, touch, MIDI all working at 5.8ms latency
Denon Prime 4⚠️ PartialBoots in offscreen mode — DSI display causes GPU crash
The Prime Go is the fully supported target. Prime 4 support is experimental — MIXXX runs correctly but the built-in display cannot be used yet. See the Devices page for details.

​
Architecture Overview

primemixxx is built on several interlocking components:
  • TKGL Bootstrap — modular SD card framework that injects into the systemd boot chain
  • Buildroot cross-compile — produces a self-contained ARMv7 MIXXX bundle with Qt 5.15.8
  • Custom Mali EGLFS integration — libqeglfs-mali-integration.so enables display output on the Rockchip RK3288 GPU
  • CPU shielding — EngineWorkerSch and EngineSideChain pinned to cores 2-3 at SCHED_FIFO 98
  • Go updater — cross-platform firmware flasher with fastboot support for reflashing the Prime Go

Boot Chain

Understand the full systemd → TKGL → MIXXX launch path.

CPU Shielding

How real-time thread pinning achieves sub-5ms audio on ARM Cortex-A17.

Display & GPU

Mali-T76x EGLFS configuration, DDK mismatch workaround, and touchscreen setup.

Audio Architecture

ALSA routing through the XMOS XS1-U6A to the AKM AK4621 CODEC.

Build docs developers (and LLMs) love

Get started for freeTalk to us