Historical task source. The Eve task board holds current task state.
Phase 148: Sovereign DJ Workstation — Serato DJ Pro / Pioneer Rekordbox / Native Instruments Traktor / Virtual DJ / Engine DJ Replacement#
Closes the DJ sovereignty gap. Phase 133 (Composer DAW) covers studio music production; Phase 132 (Audio Runtime) ships low-latency drivers. Neither delivers the live-performance turntable workflow — high-resolution timecode vinyl control, beat-matched cue juggling, four-deck performance, redline-tight sync, hardware controller integration, and tour-grade crash resilience — that working DJs rely on for club, festival, mobile, and broadcast sets.
This phase delivers a complete sovereign replacement for Serato DJ Pro, Pioneer Rekordbox DJ, Native Instruments Traktor Pro 3/4, Virtual DJ, Engine DJ (Denon/InMusic), Mixxx, Algoriddim djay Pro, and Serato Stems.
148.1 @neith/dj-core — Deck Engine & Transport#
148.1.1 Deck Architecture#
- 148.1.1.1 2 / 4 / 6 deck configurations
- 148.1.1.2 Per-deck independent transport & clock
- 148.1.1.3 Per-deck resampling engine (any SR in → 48 kHz out)
- 148.1.1.4 32-bit float internal mix bus
- 148.1.1.5 Sub-sample accurate transport positioning
- 148.1.1.6 Per-deck bit-perfect bypass path
- 148.1.1.7 Deck hot-swap without audio gap
- 148.1.1.8 Live deck handoff between controllers
- 148.1.1.9 Mono / stereo / M-S deck modes
- 148.1.1.10 Per-deck pre-gain with auto-gain analysis
148.1.2 Pitch / Key / Tempo#
- 148.1.2.1 Time-stretch engine (independent tempo and key,
artefact-controlled). Restated 2026-09-18: "elastique-class, sub-1ms
artefact" names a proprietary product and an unmeasurable target.
Implement a phase-locked phase-vocoder with transient preservation (or
WSOLA for percussive material) in
libs/neith/dj/crates/neith-dj/src/time_stretch.rs, chosen per block by a transient detector. Verify: on a fixed set of test signals (a drum loop, a sustained pad, a vocal), a spec asserts the stretched output holds the target tempo within 0.1 %, preserves the pitch within 5 cents, keeps transient positions within 5 ms of the ideal, and shows lower spectral-phase incoherence than a plain overlap-add baseline. - 148.1.2.2 Independent pitch shift ±12 semitones
- 148.1.2.3 Tempo range ±8 / ±16 / ±50 / ±100 % slider
- 148.1.2.4 Master tempo (key lock) toggle
- 148.1.2.5 Key detection (12-TET + microtonal) at import
- 148.1.2.6 Camelot + Open-Key wheel display
- 148.1.2.7 Harmonic-mix suggestion (±1 / ±7 wheel jumps)
- 148.1.2.8 Per-deck pitch bend with jog-wheel
- 148.1.2.9 Smart Pitch (key-lock with formant preserve)
- 148.1.2.10 Tempo-map follow (variable-tempo tracks)
148.1.3 Beat-Grid & Phase#
- 148.1.3.1 Automatic beat-grid detection (onset + transient)
- 148.1.3.2 Manual grid anchor + bar-one marker
- 148.1.3.3 Downbeat detection (ML + spectral)
- 148.1.3.4 Multi-grid for tempo-changing tracks
- 148.1.3.5 Grid nudge ±1 sample
- 148.1.3.6 Phase meter (decks A vs B)
- 148.1.3.7 Beat-jump 1 / 2 / 4 / 8 / 16 / 32 bars
- 148.1.3.8 Quantize-to-grid cueing option
- 148.1.3.9 Flex-beat (Serato Flex / Traktor elastic) warp markers
- 148.1.3.10 Grid export to Rekordbox / Serato / Engine formats
148.2 @neith/dj-mixer — Mixer, Crossfader & Routing#
- 148.2.1 4-channel mixer with per-channel gain, 3-band EQ, filter
- 148.2.2 Isolator EQ with full-kill (-∞ dB) cut option
- 148.2.3 Classic, Innofader, Pro-X curves for crossfader
- 148.2.4 Crossfader assign per channel (A / B / thru)
- 148.2.5 Curve editor for channel fader
- 148.2.6 Cue / PFL routing with split-cue option
- 148.2.7 Master out + booth out + record out + zone out
- 148.2.8 Per-output limiter with threshold + ceiling
- 148.2.9 VU + peak + LUFS-short-term meters per channel
- 148.2.10 Talkover / mic channel with auto-duck
- 148.2.11 FX send / return per channel
- 148.2.12 Stem isolation per channel (drum / bass / vocal / other)
- 148.2.13 Aux input / USB send-return
- 148.2.14 HPF / LPF filter with resonance per channel
- 148.2.15 Color FX insert per channel (dub-echo / noise / etc.)
148.3 @neith/dj-timecode — Control Vinyl / CDJ Timecode#
- 148.3.1 Serato Control Vinyl NOISEMAP decode. Needs the physical
Serato control record, a turntable and an audio interface (the vendor
NOISEMAP is proprietary; the crate ships only the sovereign timecode, see
libs/neith/dj/docs/sovereign-timecode-v1.md) to capture reference signals and verify the mapping; the fleet has none (stated 2026-09-18).blocked:hardware - 148.3.2 Traktor Scratch MK2 timecode decode. Needs the physical
Traktor Scratch MK2 control record, a turntable and an audio interface to
capture reference signals and verify the mapping; the fleet has none
(stated 2026-09-18).
blocked:hardware - 148.3.3 Rekordbox DVS (RB-VS1-K) timecode decode. Needs the physical
Rekordbox RB-VS1-K control record, a turntable and an audio interface to
capture reference signals and verify the mapping; the fleet has none
(stated 2026-09-18).
blocked:hardware - 148.3.4 Sovereign timecode spec (open-documented pulse pattern)
- 148.3.5 Sub-sample phase lock with drift correction
- 148.3.6 Absolute / Relative / Internal modes
- 148.3.7 Needle-drop position from timecode absolute mode
- 148.3.8 Scratch detection (forward / reverse / scrub)
- 148.3.9 Signal-quality meter (SNR + dropout)
- 148.3.10 Lead-in / outro silence handling
- 148.3.11 CDJ HID control (Pioneer CDJ-2000NXS2 / 3000). Needs the
physical Pioneer CDJ-2000NXS2 or CDJ-3000 unit to capture reference
signals and verify the mapping; the fleet has none (stated 2026-09-18).
blocked:hardware - 148.3.12 HID jog-feedback tempo sync. Needs the physical a CDJ or DJ
controller with a motorised/feedback jog to verify against to capture
reference signals and verify the mapping; the fleet has none (stated
2026-09-18).
blocked:hardware - 148.3.13 Auto-calibration of sticker offset
- 148.3.14 Record-signal pass-through for monitoring
- 148.3.15 DVS setup wizard with SNR tuning
148.4 @neith/dj-cues — Hot Cues, Loops & Samples#
148.4.1 Hot Cues#
- 148.4.1.1 8 / 16 / 32 hot-cue slots per track
- 148.4.1.2 Pad colour + label per cue
- 148.4.1.3 Cue-type (cue / loop / loop-roll / slice / jump)
- 148.4.1.4 Cue-point quantize option
- 148.4.1.5 Flip (Serato Flip / Pioneer Memory Cue) cue sequences
- 148.4.1.6 Cue preview (trigger-without-transport)
- 148.4.1.7 Memorise cue across sessions
- 148.4.1.8 Cue-point nudging ± samples
- 148.4.1.9 Chain cues → performance sequence
- 148.4.1.10 Cue-point recall from controller pads
148.4.2 Loops#
- 148.4.2.1 Manual loop in / out
- 148.4.2.2 Auto-loop 1/32 → 32 bar sizes
- 148.4.2.3 Loop-roll (momentary re-trigger loop)
- 148.4.2.4 Saved loops per track (unlimited)
- 148.4.2.5 Loop shift left / right by loop length
- 148.4.2.6 Half / double loop length
- 148.4.2.7 Beat-jump inside active loop
- 148.4.2.8 Smart-loop (auto snap to nearest bar)
- 148.4.2.9 Loop exit with held-note phrase capture
- 148.4.2.10 Loop-stutter (bounce on off-beats)
148.4.3 Sample Decks#
- 148.4.3.1 8 / 16 sample slot grid per sampler
- 148.4.3.2 One-shot / loop / hold playback modes
- 148.4.3.3 Sampler sync-to-master-tempo
- 148.4.3.4 Sample-grid import from Ableton / MPC / Maschine. Ableton is
the open one: parse the Ableton Live Set (
.als, gzipped XML) inlibs/neith/dj/crates/neith-dj/src/import.rsto recover the sample-grid clips (name, warp markers, gain, slot) into the sampler model. Verify: a spec imports a fixture.alsand asserts the clip names, slot positions and warp markers. MPC (.xpj) and Maschine (.mxgrp) are proprietary binary formats needing the licensed apps to author and validate fixtures, so they stay a noted external residual of this item. - 148.4.3.5 Velocity-layered samples (MIDI pad velocity)
- 148.4.3.6 Per-sample pitch / gain / filter / pan
- 148.4.3.7 Sample chop from active deck (hot-slice)
- 148.4.3.8 Sample recording from master bus
- 148.4.3.9 Save sampler bank to track library
- 148.4.3.10 Sampler performance recording (MIDI capture)
148.5 @neith/dj-stems — Real-Time Stem Isolation#
- 148.5.1 On-device Demucs-class separation (drums / bass / vocal /
other): the current
libs/neith/dj/crates/neith-dj/src/stem_separator.rsis DSP-based; add an ML path that runs a Hybrid Transformer Demucs model on the CPU. First install the runtime and record versions:pip install demucs(Torch CPU) or export the pretrainedhtdemucsweights to ONNX and run throughonnxruntime; park only with a named failed install attempt. Verify: a spec separates a fixture mixture from the MUSDB18 test split and reports the four-stem SI-SDR, which must beat the DSP baseline instem_separator.rs. - 148.5.2 ≤ 80 ms separation latency (streaming mode)
- 148.5.3 4-band stem mixer per deck
- 148.5.4 Per-stem volume + mute + solo
- 148.5.5 Per-stem EQ + filter
- 148.5.6 Per-stem send to FX chain
- 148.5.7 Stem-swap between decks (A-vocal over B-instrumental)
- 148.5.8 Offline stem bake (higher-quality model, cached)
- 148.5.9 Pre-cached stems on library import
- 148.5.10 Stem isolation toggle for scratch decks
- 148.5.11 Stem-mask-aware key detection
- 148.5.12 Guitar / keys / strings sub-separation (5-stem, 8-stem):
extend 148.5.1 with the pretrained
htdemucs_6ssix-stem model (adds guitar and piano) and a documented rule for folding six stems into the 5- and 8-stem layouts the mixer expects. Verify: a spec separates a fixture with prominent guitar and piano and reports per-stem SI-SDR for the six stems, with guitar and piano each beating a silence baseline. Depends on 148.5.1.blocked:upstream - 148.5.13 Beat-repeat per isolated drum stem
- 148.5.14 Acapella isolation quality rating
- 148.5.15 Stem fingerprint for copyright-safe logging
148.6 @neith/dj-fx — Performance Effects#
- 148.6.1 Filter / LPF / HPF with resonance + drive
- 148.6.2 Beat-Echo / Tape-Echo (sync / unsync)
- 148.6.3 Reverb (plate / hall / shimmer) with freeze
- 148.6.4 Flanger / phaser with depth + feedback
- 148.6.5 Beat-Masher / Beat-Slicer
- 148.6.6 Gater with rhythmic pattern
- 148.6.7 Noise / riser / downlifter generator
- 148.6.8 Ring-mod with frequency sweep
- 148.6.9 Granular freeze / stutter
- 148.6.10 Vinyl brake / backspin
- 148.6.11 Reverse-play with cue-back-in
- 148.6.12 Pitch-shift FX (octave / harmonic)
- 148.6.13 Transient shaper
- 148.6.14 Auto-duck FX (sidechain to kick)
- 148.6.15 FX chain (up to 3 serial / parallel slots)
- 148.6.16 FX macro (one-knob multi-param)
- 148.6.17 VST3 / CLAP plug-in host for FX: build the host on the two open plug-in SDKs — CLAP (MIT) first, then VST3 through Steinberg's GPLv3 SDK (install-first: vendor the SDKs, record the versions, park only with a named failed build attempt). Scan a plug-in directory, instantiate a plug-in, and run audio blocks through it in the FX chain, with parameter automation. Verify: a spec loads an open-source test plug-in of each format (a CLAP and a VST3 gain/filter), asserts a known parameter change alters the output as expected, and that an incompatible binary is rejected without crashing the host.
- 148.6.18 FX automation record + playback
- 148.6.19 FX sync-to-master quantize
- 148.6.20 FX beat-fraction selector (1/64 → 16 bar)
148.7 @neith/dj-library — Library & Crates#
- 148.7.1 1M-track library with sub-100 ms search
- 148.7.2 Crate / playlist / smart-crate with rule engine
- 148.7.3 BPM / key / energy / date / genre filter columns
- 148.7.4 Tag engine (custom user tags + free-text)
- 148.7.5 Track history (session play log)
- 148.7.6 Preview cue with pre-fader audition
- 148.7.7 Waveform thumbnail in browse list
- 148.7.8 Duplicate detector (audio fingerprint + metadata)
- 148.7.9 Missing-file relink wizard
- 148.7.10 Import from iTunes / Music.app / Rekordbox / Serato / Traktor / Engine libraries
- 148.7.11 Export to USB (Rekordbox-compatible) for CDJs: write the
Rekordbox USB export — the
PIONEER/rekordbox/export.pdbdatabase plus the per-trackANLZ0000.DAT/.EXTanalysis files (beat grid, waveform, cue points) — intolibs/neith/dj/crates/neith-dj/src/library.rs, following the reverse-engineered format documented by the Deep Symmetry project (cite therekordcrateschema). Verify: a spec exports a small library and reads it back with an independent PDB parser, asserting track rows, beat grids and hot cues match; playback on a real CDJ is a hardware residual. - 148.7.12 Cloud library sync (sovereign S3-compatible)
- 148.7.13 Library roaming across multiple machines
- 148.7.14 Saved-search smart crates
- 148.7.15 Audit log (every track edit tracked)
148.8 @neith/dj-analysis — Track Analysis#
- 148.8.1 Background analyser (BPM / key / energy / downbeat / grid)
- 148.8.2 LUFS integrated + true-peak loudness normalisation
- 148.8.3 Gain auto-match (ReplayGain-compatible)
- 148.8.4 Mood / genre embedding classifier: extract audio embeddings
and train a genre and mood head on an openly licensed dataset —
MTG-Jamendo (mood/theme and genre tags, CC) and optionally GTZAN for genre
— on the CPU. First install the feature extractor and record versions (for
example
openl3or a small mel-CNN in ONNX); park only with a named failed install attempt. This is "Nous-trained" in that Nous owns the training job, but the model is small and CPU-trainable. Verify: report accuracy / macro-F1 on a held-out split that beats the majority-class baseline, and a spec that embeds two contrasting fixture tracks and asserts distinct top genres. - 148.8.5 Intro / breakdown / drop segment auto-mark
- 148.8.6 Vocals / instrumental section detection
- 148.8.7 Bar / phrase structure extraction
- 148.8.8 Silence / mastering-margin trim suggest
- 148.8.9 Waveform overview multi-resolution cache
- 148.8.10 RMS / peak / crest-factor stats per track
- 148.8.11 Fingerprint (chromaprint + custom) for de-dupe
- 148.8.12 Batch folder analysis with optional GPU acceleration: analyse a folder of tracks (BPM, key, beat grid, the embedding of 148.8.4) with a bounded worker pool, an optional Metal/wgpu compute path for the FFT-heavy stages where a GPU is present, and resumable progress. Verify: a spec analyses a fixture folder on the CPU on the Linux server, asserts every track gets a complete analysis record, that a re-run skips already-analysed tracks, and that the GPU path (when selected) produces results equal to the CPU path within a stated tolerance.
- 148.8.13 Re-analysis on algorithm upgrade (version-pinned)
- 148.8.14 User-corrected analysis fed back to training: capture a DJ's
corrections to BPM, key, beat grid and genre as labelled examples in
libs/neith/dj/crates/neith-dj/src/analysis.rs, and export them as a fine-tuning dataset for the classifier of 148.8.4 (deduplicated, with the original prediction and the correction). Verify: a spec records corrections against fixture predictions and asserts the exported dataset holds one labelled example per correction with both values. The retraining run itself follows the model of 148.8.4.blocked:upstream - 148.8.15 Analysis cache portable across installs
148.9 @neith/dj-controller — Hardware Controller Integration#
- 148.9.1 Pioneer DDJ-FLX series HID mapping. Needs the physical Pioneer
DDJ-FLX-series controller (published Mixxx mappings can seed it, but the
HID reports and jog/LED behaviour must be captured and verified on the
unit) to capture reference signals and verify the mapping; the fleet has
none (stated 2026-09-18).
blocked:hardware - 148.9.2 Pioneer CDJ-3000 / 2000 / 900 HID. Needs the physical Pioneer
CDJ-3000 / 2000 / 900 unit (published Mixxx mappings can seed it, but the
HID reports and jog/LED behaviour must be captured and verified on the
unit) to capture reference signals and verify the mapping; the fleet has
none (stated 2026-09-18).
blocked:hardware - 148.9.3 Pioneer DJM mixer HID + MIDI. Needs the physical Pioneer DJM
mixer (published Mixxx mappings can seed it, but the HID reports and
jog/LED behaviour must be captured and verified on the unit) to capture
reference signals and verify the mapping; the fleet has none (stated
2026-09-18).
blocked:hardware - 148.9.4 Native Instruments S4 / S8 / Z2 HID. Needs the physical Native
Instruments S4 / S8 / Z2 unit (published Mixxx mappings can seed it, but
the HID reports and jog/LED behaviour must be captured and verified on the
unit) to capture reference signals and verify the mapping; the fleet has
none (stated 2026-09-18).
blocked:hardware - 148.9.5 Denon SC6000 / X1800 / X1850 / Prime 4 HID. Needs the physical
Denon SC6000 / X1800 / X1850 / Prime 4 unit (published Mixxx mappings can
seed it, but the HID reports and jog/LED behaviour must be captured and
verified on the unit) to capture reference signals and verify the mapping;
the fleet has none (stated 2026-09-18).
blocked:hardware - 148.9.6 Rane Seventy-Two / ONE / Twelve HID. Needs the physical Rane
Seventy-Two / ONE / Twelve unit (published Mixxx mappings can seed it, but
the HID reports and jog/LED behaviour must be captured and verified on the
unit) to capture reference signals and verify the mapping; the fleet has
none (stated 2026-09-18).
blocked:hardware - 148.9.7 Reloop Mixtour / Terminal Mix HID. Needs the physical Reloop
Mixtour / Terminal Mix unit (published Mixxx mappings can seed it, but the
HID reports and jog/LED behaviour must be captured and verified on the
unit) to capture reference signals and verify the mapping; the fleet has
none (stated 2026-09-18).
blocked:hardware - 148.9.8 Generic MIDI learn with curve editor
- 148.9.9 Open-source controller definition DSL (YAML / JSON)
- 148.9.10 LED / screen feedback to controller (waveform, BPM). Needs
the physical a DJ controller with LED rings or a screen to verify the
feedback round-trip to capture reference signals and verify the mapping;
the fleet has none (stated 2026-09-18).
blocked:hardware - 148.9.11 Jog-wheel tension (torque) curve
- 148.9.12 Per-pad RGB feedback for cue colour
- 148.9.13 Controller hot-plug without crash
- 148.9.14 Multi-controller combine (stack two DDJs to form 4-deck)
- 148.9.15 Screen-less headless DJ mode (audio-only, for tour rig)
148.10 @neith/dj-recording — Session Recording & Streaming#
- 148.10.1 Master-out recording (WAV / FLAC / AIFF / OGG)
- 148.10.2 Stereo + per-channel multitrack record
- 148.10.3 Auto-split on track-change cue
- 148.10.4 Session ID3 tagging with track-list + timestamps
- 148.10.5 Mixcloud / SoundCloud / live-stream destination. Mixcloud and
SoundCloud need developer accounts and API credentials that are the
owner's; the sovereign self-hosted destination is 148.10.15 and the open
push protocols are 148.10.6 (stated 2026-09-18).
blocked:external - 148.10.6 Icecast / RTMP push: stream the master mix to an Icecast
mount (Ogg/Opus) and to an RTMP endpoint (FLV/AAC) from
libs/neith/dj/crates/neith-dj/src/recording.rs, driving the encode through ffmpeg (installed at/usr/bin/ffmpeg; a local Icecast for the test installed via apt, record the version, park only with a named failed install attempt). Verify: a spec streams a 30-second fixture to a local Icecast and to a local RTMP listener and asserts a client pulls back a valid, gapless stream of the expected codec and bitrate from each. - 148.10.7 Per-track license fingerprint for rights-report
- 148.10.8 Live DJ-set video capture (deck waveforms + cam): composite the rendered deck waveforms and a camera/video input into an encoded video via ffmpeg. Use a file or test-pattern video as the camera source so it runs headless. Verify: a spec renders 10 seconds with a moving waveform overlaid on a test-pattern input and asserts the output file's resolution, frame rate and duration, and that the overlay region changes frame to frame. A physical camera or HDMI capture card is a hardware residual (see 148.12.9).
- 148.10.9 In-set bookmark / cue for post-edit
- 148.10.10 MIDI performance capture (relative → absolute render)
- 148.10.11 Session replay mode (time-travel debug)
- 148.10.12 Crash-safe journalled session (resume after power-cut)
- 148.10.13 Pre-roll buffer (records from 5 min before Rec pressed)
- 148.10.14 Spatial print option. Split 2026-09-18 by whether an encoder
is licensed.
- 148.10.14.a Binaural print: render the master (or the stems) to a
binaural stereo file through an HRTF convolution, reusing
libs/neith/dj/crates/neith-dj/src/spatial.rs. Verify: a spec prints a fixture and asserts an interaural time/level difference consistent with the panned source positions. - 148.10.14.b Dolby Atmos print: encode to Dolby Atmos (ADM BWF or the
Atmos master format). The Atmos encoder is licensed by Dolby with no
free tier, and the owner holds no licence (stated 2026-09-18).
blocked:external
- 148.10.14.a Binaural print: render the master (or the stems) to a
binaural stereo file through an HRTF convolution, reusing
- 148.10.15 Session publish to a sovereign radio/podcast service: from a recorded set, produce a podcast episode (the audio file plus a chapter list from the set list and an RSS item) and publish it to a self-hosted feed served from the Hetzner static plane. Verify: a spec builds the episode from a fixture recording and asserts the RSS validates against the podcast RSS schema, that the enclosure length and duration match the audio, and that chapters map to the set-list track changes.
148.11 @neith/dj-sync — Ableton Link, MIDI Clock & Show Sync#
- 148.11.1 Ableton Link peer discovery + beat sync: integrate Ableton
Link (open source; vendor the SDK or its Rust binding, install-first,
record the version, park only with a named failed build attempt) into
libs/neith/dj/crates/neith-dj/src/sync.rsfor tempo and phase sync across peers on the LAN. Verify: a spec starts two in-process Link peers, changes the tempo on one, and asserts the other converges to the same tempo and beat phase within a stated time. - 148.11.2 MIDI clock in / out with quarter-frame drift correction
- 148.11.3 MIDI MTC / LTC timecode slave
- 148.11.4 Beats-out to lighting desk (ArtNet / sACN trigger)
- 148.11.5 OSC transport + cue broadcast
- 148.11.6 Sync to Composer (Phase 133) session over OSC
- 148.11.7 Sync to VJ software (Resolume / MadMapper / sovereign VJ)
- 148.11.8 Sync to video decks (4-deck video DJ)
- 148.11.9 Sync jitter ≤ 0.5 ms under network load: measure the phase
jitter of the Link sync of 148.11.1 between two peers while a background
load is applied to the loopback with
tc netem(added delay and jitter). Verify: a soak spec records the beat-phase error distribution over 10 minutes and asserts the 99th percentile stays at or below 0.5 ms; the tc/netem parameters are recorded with the result. - 148.11.10 Sync-lost failover (free-wheel on last known tempo)
148.12 @neith/dj-vj — Video & Visuals Deck#
- 148.12.1 Video deck playback (ProRes / H.264 / HEVC / AV1)
- 148.12.2 Beat-synced visual loop trigger
- 148.12.3 Crossfade / wipe / cube / tile video transitions
- 148.12.4 Chroma-key / luma-key per video source
- 148.12.5 Visual FX (posterize / glitch / pixel-sort)
- 148.12.6 Shared-texture video output (Syphon / Spout / NDI). Split
2026-09-18 by licence.
- 148.12.6.a Syphon (macOS) and Spout (Windows) are open source: publish the visuals deck as a shared GPU texture through each, verified with a small test consumer — Syphon on the Mac, Spout on a Windows CI runner. Install the SDKs (open source; record versions; park only with a named failed build attempt). Verify: a consumer receives a frame whose checksum matches the rendered frame.
- 148.12.6.b NDI output over the network: NDI needs NewTek/Vizrt's SDK
under its EULA, whose redistribution terms the owner must accept (stated
2026-09-18).
blocked:external
- 148.12.7 Dual-screen (booth preview / front-of-house output)
- 148.12.8 Projection-mapping output with keystone
- 148.12.9 Camera / webcam / HDMI capture-card input: capture live video into the visuals deck through V4L2 (Linux) / AVFoundation (macOS), with a file or test-pattern source as the headless fallback. Verify: a spec opens the test-pattern source, pulls 30 frames and asserts their resolution, format and timestamps advance. A physical HDMI capture card or webcam is a hardware residual.
- 148.12.10 AI-generated visuals driven by stems (Phase 47 integration): map per-stem energy and the beat phase from the analysis engine to visual-generation parameters, and drive the Phase 47 generative-visual backend with them. Verify: a spec feeds a fixture stem-energy timeline and asserts the parameter stream tracks the stems (a bass hit raises the low-band parameter, a beat triggers the beat parameter) and stays within the backend's valid ranges. The generative backend itself is Phase 47's.
148.13 @neith/dj-perf — Low-Latency & Tour-Grade Resilience#
- 148.13.1 Low round-trip latency on the fleet's real audio stack: measure input-to-output round-trip latency on the Mac's CoreAudio at 128- and 64-sample buffers with a loopback, targeting ≤ 4 ms at 64 samples / 48 kHz, and record the device and buffer sizes. Verify: a measurement harness on the Mac reports the round-trip latency per buffer size and asserts the 64-sample case meets the target. ASIO is Windows-only and is measured separately once a Windows host with an ASIO interface exists.
- 148.13.2 Dropout-free under 95 % CPU load: run the four-deck engine while a load generator pins the other cores to ~95 %, and count audio-callback overruns. Verify: a spec runs 5 minutes under load on the Linux server and asserts zero buffer underruns in the audio callback and that processing time per block stays under the buffer period at the 99th percentile.
- 148.13.3 Per-deck CPU budget cap
- 148.13.4 Graceful degrade (disable stems if CPU > 85 %)
- 148.13.5 Watchdog process restarts audio engine on crash
- 148.13.6 Warm-spare deck (second process mirrors state)
- 148.13.7 Hot-swap audio interface mid-set
- 148.13.8 Failover to internal speakers / laptop output
- 148.13.9 Brown-out power handling (battery-backed). Needs a real power
source and a battery/UPS to induce and verify a brown-out; the fleet has
no such rig (stated 2026-09-18).
blocked:hardware - 148.13.10 USB controller disconnect grace handling
- 148.13.11 Over-temp thermal throttle notice (not shutdown)
- 148.13.12 6-hour uninterrupted performance-mode soak: run performance mode for 6 hours driving continuous mixing on a playlist loop, tracking memory, CPU and audio-callback health. Verify: the run completes 6 hours on the Linux server with zero audio underruns, no unbounded memory growth (RSS slope under a stated bound), and a committed log of the metrics.
- 148.13.13 Tour-mode UI lock (prevent accidental clicks)
- 148.13.14 Offline-first (no network needed for playback)
- 148.13.15 Tour-mode telemetry (local black box for post-set review)
148.14 @neith/dj-rights — Rights, Metadata & Reporting#
- 148.14.1 Per-track ISRC / ISWC / BPM / key in metadata
- 148.14.2 PRO reporting export (BMI / ASCRAP / SACEM / GEMA / JASRAC)
- 148.14.3 Set-list auto-generation with timestamps
- 148.14.4 Track-play frequency report
- 148.14.5 Integration with Themis Music Shield (Phase 74)
- 148.14.6 DMCA-safe live-stream segmentation
- 148.14.7 Event-organiser rights report export
- 148.14.8 Venue / festival / online-platform format profiles
- 148.14.9 Audit chain signed with sovereign identity (Phase 146): sign
each proof-of-play / rights audit record in
libs/neith/dj/crates/neith-dj/src/rights.rswith the sovereign identity keypair from the Phase 146 identity library, chaining records by the previous signature. Verify: a spec builds a chain of audit records, verifies every signature against the public key, and asserts that altering any record breaks verification from that point on. - 148.14.10 Proof-of-play ledger option (Phase 37 Aje): write each
proof-of-play record to the Aje ledger (Aje owns the Web3 domain —
libs/aje/), behind an opt-in flag, with the sovereign signature of 148.14.9 as the payload. Verify: a spec submits fixture play records to a local Aje test chain and asserts each is retrievable and its signature verifies; the NFT-mint variant is one adapter behind the same interface.
148.15 Testing & Validation#
- 148.15.1 Timecode decode bit-exact regression tests
- 148.15.2 Time-stretch quality vs an open reference. Restated 2026-09-18: elastique is proprietary; compare against the open-source Rubber Band Library instead (install-first; record the version; park only with a named failed install attempt). Verify: for the test signals of 148.1.2.1, a spec asserts the engine's transient-position error and pitch error are within a stated margin of Rubber Band's on the same inputs.
- 148.15.3 Beat-grid accuracy on an open annotated set. Restated 2026-09-18: a 10k-track labelled set does not exist openly; use the published beat-annotation datasets (Ballroom, Hainsworth, GTZAN-rhythm) instead. Verify: a spec runs the beat tracker over the combined set and reports F-measure and CMLt against the annotations, asserting F-measure ≥ 0.90 on the ballroom subset (a defensible bar for these genres).
- 148.15.4 Stem-separation SI-SDR on MUSDB18: MUSDB18 is openly
downloadable for research (install-first: fetch the dataset and record its
version/checksum; park only with a named failed download). Verify: a spec
runs the separator of 148.5.1 over the MUSDB18 test set and reports mean
SI-SDR per stem, asserting the four-stem mean ≥ 6 dB (a realistic bar for
a CPU Demucs; the 9 dB figure is the full-GPU model's headline). Depends
on 148.5.1.
blocked:upstream - 148.15.5 Latency soak test, 24 h no dropout: run the audio engine for 24 hours at the performance buffer size and count underruns. Verify: the run completes 24 hours on the Linux server (or the Mac) with zero audio-callback underruns and a committed metrics log.
- 148.15.6 Controller LED / screen feedback round-trip test. Needs a
physical controller with LEDs or a screen to verify the round-trip (stated
2026-09-18); it validates 148.9.10.
blocked:hardware - 148.15.7 Multi-machine Ableton Link sync soak: the fleet has two
machines, so run Link (148.11.1) between the Mac and the Linux server over
the LAN and soak the sync. Verify: a one-hour run reports the
cross-machine beat-phase error distribution and asserts the 99th
percentile stays within a stated bound, with the network conditions
recorded. Depends on 148.11.1.
blocked:upstream - 148.15.8 Crash-recovery / warm-spare failover drill
- 148.15.9 Live club-rig compatibility matrix (top 30 clubs). Needs
access to the physical rigs (mixers, CDJs, amps) of thirty named venues to
test against; the fleet has none (stated 2026-09-18).
blocked:hardware - 148.15.10 Tour-reliability: 100 shows, zero set-killing incidents.
This is a field-reliability outcome measured across 100 real live
performances, not a software deliverable (stated 2026-09-18).
blocked:release