Repository Public
1<!--2ORIX DJ3File: README.md4Author: Simon-Pierre Boucher5Contact: contact@spboucher.ai6-->7<p align="center">8 <img src="docs/assets/icon.png" width="168" alt="ORIX DJ icon">9</p>1011<h1 align="center">ORIX DJ</h1>12<p align="center"><strong>Mix the Music. Program the Experience.</strong></p>13<p align="center">14A native macOS DJ application with its own real-time audio engine, four decks, Metal waveforms, real DSP effects,<br>15and <strong>ORIX Script</strong>: a small deterministic language that programs a mix in beats and bars.<br>16Local files only. No account. Mixing works with the network unplugged.17</p>1819<p align="center">20 <img src="docs/assets/badges/platform.svg" alt="macOS 15 or later">21 <img src="docs/assets/badges/silicon.svg" alt="Apple Silicon">22 <img src="docs/assets/badges/swift.svg" alt="Swift 6">23 <img src="docs/assets/badges/ui.svg" alt="SwiftUI, AppKit, Metal">24 <img src="docs/assets/badges/audio.svg" alt="Core Audio, own engine">25 <img src="docs/assets/badges/script.svg" alt="ORIX Script, deterministic">26 <img src="docs/assets/badges/offline.svg" alt="mixing works offline">27 <img src="docs/assets/badges/accounts.svg" alt="no account">28</p>29<p align="center">30 <img src="docs/assets/badges/tests.svg" alt="241 core tests passing">31 <img src="docs/assets/badges/uitests.svg" alt="9 UI tests passing">32 <img src="docs/assets/badges/coverage.svg" alt="core line coverage 91.6 %">33 <img src="docs/assets/badges/version.svg" alt="version 1.0.0 build 1">34 <img src="docs/assets/badges/notarization.svg" alt="notarization accepted and stapled">35 <img src="docs/assets/badges/release.svg" alt="release 1.0.0 published">36 <img src="docs/assets/badges/dmg-size.svg" alt="DMG 7.4 MB">37</p>38<p align="center">39 <img src="docs/assets/badges/render.svg" alt="render time, 4 decks at 256 frames: 70.5 microseconds mean">40 <img src="docs/assets/badges/sync.svg" alt="worst sync error 0.021 ms">41 <img src="docs/assets/badges/effects.svg" alt="18 effects">42 <img src="docs/assets/badges/presets.svg" alt="24 automation presets">43 <img src="docs/assets/badges/license.svg" alt="all rights reserved">44</p>4546<p align="center">47 <img src="docs/screenshots/studio-dark.png" alt="ORIX DJ studio: two decks, mixer, waveforms" width="100%">48</p>4950> The badges are local SVG files written by `Scripts/badges.py` from the measured reports in `docs/reports/`.51> Every number in this README was measured on this code base; section 31 says how, and section 36 says what was52> **not** verified. Every screenshot was captured from the running application by `Scripts/screenshots.sh`.5354## Contents55561. [Overview](#1-overview) · 2. [ORIX Philosophy](#2-orix-philosophy) · 3. [Application Preview](#3-application-preview) ·574. [Decks](#4-decks) · 5. [Waveforms](#5-waveforms) · 6. [Beat Grid, Tempo and Key](#6-beat-grid-tempo-and-key) ·587. [Sync, Time Stretch and Key Lock](#7-sync-time-stretch-and-key-lock) · 8. [Mixer](#8-mixer) ·599. [Effects](#9-effects) · 10. [Cues, Loops and Pads](#10-cues-loops-and-pads) · 11. [Library](#11-library) ·6012. [Auto DJ](#12-auto-dj) · 13. [Recording and Export](#13-recording-and-export) · 14. [MIDI](#14-midi) ·6115. [ORIX Script](#15-orix-script) · 16. [Compiler and Runtime](#16-compiler-and-runtime) ·6217. [Automation Studio](#17-automation-studio) · 18. [Simulator and Debugger](#18-simulator-and-debugger) ·6319. [Presets and Visual Builder](#19-presets-and-visual-builder) · 20. [Docs Tab](#20-docs-tab) ·6421. [Claude Studio](#21-claude-studio) · 22. [Performance Mode](#22-performance-mode) · 23. [Projects](#23-projects) ·6524. [Architecture](#24-architecture) · 25. [Audio Engine](#25-audio-engine) · 26. [Technology Stack](#26-technology-stack) ·6627. [Repository Layout](#27-repository-layout) · 28. [Installation](#28-installation) ·6729. [Build Instructions](#29-build-instructions) · 30. [Testing](#30-testing) · 31. [Measurements](#31-measurements) ·6832. [Privacy and Security](#32-privacy-and-security) · 33. [Accessibility](#33-accessibility) ·6934. [Localization](#34-localization) · 35. [Release Status](#35-release-status) ·7036. [Known Limitations](#36-known-limitations) · 37. [ORIX Ecosystem, Author, License](#37-orix-ecosystem-author-license)7172## 1. Overview7374ORIX DJ is a DJ application written for the Mac, not ported to it. The audio engine, the time stretcher, the75effects, the track analysis, the waveform renderer and the automation language are first-party Swift; the only76frameworks are Apple's (Core Audio, AVFoundation, Accelerate, Metal, Core MIDI, SQLite).7778What sets it apart is **ORIX Script**. A transition, a build-up or a whole routine is a short text file, timed in79beats and bars, checked by a compiler before it can touch the mix, and executed with sample-accurate scheduling.80The same script runs identically in the simulator and on the live engine.8182| | |83|---|---|84| Decks | 2 or 4, each with varispeed, key lock, key shift, sync, quantize, slip-free loops, 8 hot cues |85| Engine | own Core Audio render graph, no allocation and no lock on the audio thread |86| Effects | 18 real DSP effects, three slots per deck plus a master rack |87| Analysis | tempo and beat grid, musical key, BS.1770 loudness, three-band waveform |88| Automation | ORIX Script: compiler, runtime, scheduler, simulator, debugger, 24 presets, visual builder |89| Assistant | Claude Studio, with the user's own Anthropic API key, optional |90| Formats | whatever AVFoundation decodes: MP3, AAC, ALAC, FLAC, WAV, AIFF |91| Size | 22 MB application, 7.4 MB disk image |9293## 2. ORIX Philosophy9495- **Native.** One Mac application, Swift 6, SwiftUI and AppKit, Metal for the waveforms.96- **Local first.** The music is the user's files. There is no account, no telemetry, no streaming service.97- **Honest.** The application displays only values it measures. The documentation states what was verified and98 what was not.99- **Deterministic automation.** A script does the same thing every time. There is no AI in Auto DJ and none in the100 execution of a script.101- **AI as an option, not a dependency.** Claude Studio writes and explains scripts when the user provides a key;102 everything else works without it.103104## 3. Application Preview105106| Studio, light | Four decks |107|---|---|108|  |  |109110| Automation Studio | Performance mode |111|---|---|112|  |  |113114## 4. Decks115116Each deck loads a track fully decoded to 32-bit float in memory (limit: 150 minutes per track), so seeking, loops117and scrubbing never wait for the disk.118119- Play, pause, cue (set and return), scrub on the waveform, seek on the overview.120- Tempo fader (±8 %), tempo reset.121- Key lock and key shift in semitones.122- Sync to the master deck (tempo and phase), quantize to the beat.123- Reverse and brake.124- Two displays: horizontal waveform or vinyl.125126127128## 5. Waveforms129130The scrolling waveform is one full-screen Metal fragment pass over a summary texture (150 columns per second of131audio, low, mid and high bands in separate colours). It shows the beat grid, the cue point, hot cues and the132active loop, and zooms from 1 to 32 seconds. The overview shows the whole track, the played part and the markers.133134135136## 6. Beat Grid, Tempo and Key137138Analysis runs when a track is imported and is stored in the library.139140| Property | Method |141|---|---|142| Tempo and first beat | spectral-flux onset envelope, autocorrelation, phase search; search range 78 to 156 BPM |143| Key | chromagram correlated with the Krumhansl-Kessler profiles; shown in musical and Camelot notation |144| Loudness | integrated loudness after ITU-R BS.1770, used for optional gain matching |145| Waveform | three-band summary, 150 columns per second |146147The beat grid has a constant tempo. Tracks whose tempo drifts (live drums, old recordings) get a grid that is right148on average only, and the grid cannot be edited by hand in this version. Measured accuracy is in section 31.149150## 7. Sync, Time Stretch and Key Lock151152- **Varispeed** uses Catmull-Rom interpolation.153- **Key lock** uses a first-party WSOLA time stretcher (2048-sample frames, coarse-to-fine similarity search).154- **Sync** matches the tempo of the master deck and bends the phase until the beats line up; with quantize on,155 a deck that starts is placed on the master grid.156- Starts from silence are sample-exact; seeks, pauses and loop wraps are de-clicked over 4 ms.157158## 8. Mixer159160Per channel: trim, three-band EQ with full kill, a bipolar filter knob (low-pass to the left, high-pass to the161right), fader, cue button, level meter. Master: crossfader with a selectable curve, master level,162a look-ahead limiter with a gain-reduction meter that shows the real reduction, cue mix and cue level.163164Cue (headphone) routing needs an output device with at least four channels; with a stereo device the cue bus is165not audible.166167## 9. Effects168169Eighteen effects, each with its own DSP, tempo-synced where it makes sense, with a 12 ms fade on enable and170disable.171172| Family | Effects |173|---|---|174| Space | reverb, delay, echo |175| Modulation | flanger, phaser, chorus, tremolo, auto-pan |176| Filter | high-pass, low-pass, band-pass |177| Dynamics | gate, compressor, limiter |178| Distortion | distortion, bitcrusher |179| Rhythm and generator | beat repeat, noise |180181182183## 10. Cues, Loops and Pads184185Eight hot cues per deck, a main cue, beat loops from a quarter beat to 16 beats on screen (any length from a186script) with halve and double, manual loop in and out, and beat jumps.187188## 11. Library189190A local SQLite database. Tracks are referenced where they are, never copied or uploaded.191192- Import of files and folders, background analysis, missing-file detection.193- Columns for title, artist, album, genre, BPM, key, duration, rating, play count, date added.194- Search, sort, crates, playlists, smart crates (rule-based), history.195- Drag a track to a deck, or load with the keyboard.196197198199## 12. Auto DJ200201Auto DJ plays a queue and mixes from one track to the next. It is deterministic: it chooses the next track by202tempo distance and harmonic compatibility (Camelot), chooses the transition from the tracks' properties, and203**writes the transition as an ORIX Script** that can be read, edited and reused. There is no AI in it.204205206207## 13. Recording and Export208209Recording starts only when the user presses record, and a red indicator stays visible for as long as it runs. The210master bus is tapped on the audio thread into a lock-free ring and written by a separate thread. Takes can be211exported to WAV, AIFF, ALAC, AAC or FLAC.212213214215## 14. MIDI216217Core MIDI input and output, hot-plug, MIDI learn (touch a control on screen, move a control on the hardware),218mapping profiles, soft takeover, and sixteen automation triggers that a mapping can fire for scripts219(`on trigger(1) { … }`).220221No controller was tested: the MIDI code is verified against virtual Core MIDI endpoints only, and ORIX DJ ships no222ready-made mapping for any commercial controller.223224225226## 15. ORIX Script227228ORIX Script is a small language made for one job: moving the controls of a DJ rig in musical time. Files have the229extension `.orixdj`.230231```orixdj232automation "Build And Drop Swap" quantize bar {233 if not deck.B.loaded or deck.B.playing {234 print("Deck B must be loaded, paused and cued on its drop.")235 stop236 }237238 deck.B.sync(true)239 deck.B.volume = 0dB240241 fx.noise.level = -60dB242 fx.noise.cutoff = 500Hz243 fx.noise.enable()244245 // Scheduled first, so that they overlap the ramp below.246 at bar 7 { deck.A.loop(1 beat) }247 at bar 8 { deck.A.loopHalve() }248 at beat 31 { deck.A.loopHalve() }249 at beat 32 { deck.A.volume = -60dB }250251 over 8 bars curve exp {252 deck.A.filter.highpass -> 1200Hz253 fx.noise.level -> -12dB254 fx.noise.cutoff -> 10kHz255 }256257 deck.B.play()258 fx.noise.disable()259 deck.A.pause()260 deck.A.loopExit()261 deck.A.filter.highpass = 20Hz262 deck.A.volume = 0dB263}264```265266- **Typed values with units**: `0dB`, `1200Hz`, `250ms`, `50%`, `1 beat`, `8 bars`. Mixing up units is a compile267 error.268- **Musical time**: `wait`, `at bar`, `at beat`, `over … { target -> value }` with linear, ease-in, ease-out,269 smooth and exponential curves, `every`, `quantize`.270- **Structure**: variables, conditions, bounded loops, functions, events (`on deck.A.trackEnd`, `on bar`, `on trigger(1)`).271- **Deterministic and bounded**: no file access, no network, no unbounded loop, no recursion, an instruction272 budget per tick, a declared list of the controls a script may touch.273274## 16. Compiler and Runtime275276```mermaid277flowchart LR278 S[".orixdj source"] --> L[Lexer] --> P[Parser] --> A[AST]279 A --> C["Compiler<br/>types, units, ranges,<br/>capabilities, loop bounds"]280 C -->|diagnostics| E[Editor]281 C --> PL[Program plan]282 PL --> VM["Runtime<br/>cooperative tasks in beat time"]283 VM --> H["Automation host<br/>4 ms scheduler thread,<br/>30 ms look-ahead"]284 VM --> SIM["Simulator and debugger<br/>same runtime, simulated rig"]285 H -->|timestamped events| Q[Lock-free control queue]286 Q --> R["Render thread<br/>events applied on the exact sample"]287```288289No script code runs on the audio thread. The scheduler thread runs the script slightly ahead of time and sends290timestamped parameter changes; the render thread splits its buffer at each timestamp and applies the change on the291exact sample.292293## 17. Automation Studio294295A native editor for ORIX Script: syntax colouring, completion generated from the language schema, problems as you296type with a position and a suggested fix, a formatter, version history for every script, and a console that297accepts single statements against the live rig.298299| Editor with problems | Console |300|---|---|301|  |  |302303Running a script while music is playing asks for confirmation first.304305## 18. Simulator and Debugger306307The simulator runs a script on a simulated rig, faster than real time, and draws what it would do: every parameter308change on a timeline in bars. The debugger adds breakpoints, stepping, and inspection of variables and tasks.309Both use the same runtime as the live engine.310311| Simulator | Debugger |312|---|---|313|  |  |314315## 19. Presets and Visual Builder316317Twenty-four presets, each a readable script: Eight Bar Transition, Bass Swap, Harmonic Transition, Smooth318Crossfade, Quick Cut, Filter Sweep, Low-Pass Dive, Echo Out, Dub Echo Throw, Reverb Wash, Beat Repeat, Gate319Pattern, Progressive Build-up, Snare Roll Build, Drop Preparation, Tape Stop Drop, Loop Roll, Loop and Hold, Auto320DJ Blend, Play Next on Track End, Stutter Cut, Ping-Pong Delay Ride, Four Deck Layering, Beat Counter.321322The visual builder assembles a script from blocks and shows the generated source beside it.323324| Presets | Visual builder |325|---|---|326|  |  |327328## 20. Docs Tab329330The whole manual is inside the application and works offline: 29 chapters, 14 worked examples, full-text search,331and a Run button on every example. The reference chapters are generated from the same schema the compiler uses, so332they cannot drift from the language. A test compiles and simulates all 150 code examples of the documentation and333checks that the 59 examples of errors really produce the stated error.334335336337The same text is in [`docs/orix-script/`](docs/orix-script/introduction.md).338339## 21. Claude Studio340341Claude Studio is an optional assistant for ORIX Script: generate a script from a description, explain one, fix342compile errors, or convert a description of a routine. It needs the user's own Anthropic API key.343344- The key is stored in the macOS Keychain, nowhere else. It is not written to preferences, projects, logs or345 screenshots.346- Requests go directly from the Mac to `api.anthropic.com` over HTTPS. There is no ORIX server in between.347- What is sent: the request, the language reference, and the script being worked on. Audio is never sent. Track348 titles are not sent unless the user ticks the option.349- Generated code is compiled, shown with its diagnostics, and placed in the editor. It is never run automatically.350351| No key configured | A generation (debug stub, see below) |352|---|---|353|  |  |354355The right-hand screenshot was made with the debug build's local stub, which replays a canned response. **No356request to the real Anthropic API was made during development** (no key was available), so the live path is357verified against the stub and by unit tests of the request and stream parsing only.358359## 22. Performance Mode360361A full-window layout for playing: large waveforms, transport, pads, and the running automations, with everything362else hidden.363364365366## 23. Projects367368A project (`.orixdjproject`, a package with a JSON document) stores the deck contents, mixer and effect settings,369output routing, scripts, the MIDI profile and the Auto DJ queue. Projects are autosaved. Tracks are referenced, not370embedded. Loops are not restored when a project is reopened.371372## 24. Architecture373374```mermaid375flowchart TB376 subgraph App["ORIX DJ.app (SwiftUI + AppKit)"]377 UI["Studio · Library · Automation Studio · Docs · Claude Studio · Settings"]378 MW[Metal waveform renderer]379 AM["AppModel (@Observable, main actor)"]380 end381 subgraph Core["ORIXDJCore (Swift package)"]382 ENG["ORIXDJEngine<br/>DJEngine, RenderCore, DeckVoice,<br/>AutomationHost, Recorder, AutoDJ, Session"]383 SCR["ORIXScript<br/>lexer, parser, compiler, runtime, simulator"]384 DSP["ORIXDSP<br/>18 effects, filters, limiter"]385 ANA["ORIXAnalysis<br/>tempo, key, loudness, waveform"]386 LIB["ORIXLibrary<br/>SQLite store, import"]387 MIDI["ORIXMIDI<br/>Core MIDI, mappings"]388 end389 UI --> AM --> ENG390 MW --> ENG391 ENG --> DSP392 ENG --> SCR393 ENG --> ANA394 AM --> LIB395 AM --> MIDI396 MIDI --> ENG397 ENG --> CA[(Core Audio output unit)]398 AM -. "HTTPS, user's key, optional" .-> ANT[(api.anthropic.com)]399```400401One address space of parameters (`deck.A.volume`, `mixer.crossfader`, `fx.master.1.mix`, …) is shared by the user402interface, MIDI mappings and scripts, so the three can never disagree about what a control is.403404Details: [`docs/architecture/overview.md`](docs/architecture/overview.md).405406## 25. Audio Engine407408```mermaid409sequenceDiagram410 participant UI as UI / MIDI / Script scheduler411 participant Q as SPSC control queue412 participant RT as Render thread (Core Audio)413 participant SN as Snapshots (seqlock)414 UI->>Q: timestamped event (no lock)415 RT->>Q: drain events due in this buffer416 RT->>RT: split buffer at event times (blocks of at most 64 frames)417 RT->>RT: decks → stretch → EQ, filter → deck effects → mix → master effects → limiter418 RT->>SN: positions, levels, load419 SN-->>UI: read at display rate420```421422Rules of the render thread: no allocation, no lock, no Objective-C message, no file access, no script code.423Documents: [audio engine](docs/architecture/audio-engine.md), [deck engine](docs/architecture/deck-engine.md),424[DSP](docs/architecture/dsp.md), [mixer](docs/architecture/mixer.md), [automation](docs/architecture/automation.md),425[analysis](docs/architecture/analysis.md), [waveform](docs/architecture/waveform.md),426[recording](docs/architecture/recording.md), [persistence](docs/architecture/persistence.md),427[AI integration](docs/architecture/ai-integration.md).428429## 26. Technology Stack430431| Layer | Technology |432|---|---|433| Language | Swift 6, strict concurrency checking |434| Interface | SwiftUI, AppKit where needed (text editor, tables, menus) |435| Audio | Core Audio output unit (AUHAL), AVFoundation for decoding and encoding, Accelerate |436| Graphics | Metal (waveforms), SwiftUI Canvas (overview, meters) |437| MIDI | Core MIDI |438| Storage | SQLite (library), JSON packages (projects), Keychain (API key) |439| AI | Anthropic Messages API over HTTPS with streaming; no SDK, no third-party code |440| Build | Swift Package Manager, XcodeGen, shell scripts |441| Third-party dependencies | none in the application |442443## 27. Repository Layout444445```446App/ the application: sources, resources, localization447Packages/ORIXDJCore the engine, DSP, analysis, library, MIDI and ORIX Script, with their tests448UITests/ XCUITest scenarios449Scripts/ build, test, screenshots, signing, notarization, packaging, hygiene check450docs/ architecture, design, development, release, research, reports, ORIX Script manual451design/ icon sources452RELEASE-REPORT.md what was built, measured, verified and left open for 1.0.0453```454455Size: 17,392 lines of core sources, 6,122 lines of core tests, 15,966 lines of application sources.456457## 28. Installation4584591. Download [`ORIX-DJ-1.0.0.dmg`](https://git.spboucher.ai/releases/orix-dj/v1.0.0/ORIX-DJ-1.0.0.dmg) ([checksums](https://git.spboucher.ai/releases/orix-dj/v1.0.0/SHA256SUMS.txt)), open it and drag460 ORIX DJ to Applications.4612. Open it. Add a folder of music in the Library.4623. Optional: Settings → AI, to enter an Anthropic API key for Claude Studio.463464Requirements: a Mac with Apple Silicon, macOS 15 or later. No music ships with the application; the demo tracks465used for the screenshots are synthesized by the application when it is launched with `-ORIXDemo YES`.466467## 29. Build Instructions468469Requirements: Xcode 26 or later, [XcodeGen](https://github.com/yonaskolb/XcodeGen).470471```sh472Scripts/build.sh generate # write the Xcode project from project.yml473Scripts/build.sh debug # debug build474Scripts/build.sh app # release build475Scripts/build.sh core-test # the 241 core tests476Scripts/build.sh uitest # the 9 UI scenarios477Scripts/build.sh bench # build the measurement tool478Scripts/check.sh # repository hygiene (headers, no credentials, no audio, network scope)479```480481Signing, notarization and packaging are described in [`docs/release/`](docs/release/checklist.md) and need the482owner's Developer ID certificate and notary profile; neither is in the repository. Setup:483[`docs/development/setup.md`](docs/development/setup.md).484485## 30. Testing486487| Suite | Result |488|---|---|489| Core tests (`swift test`) | 241 tests in 44 suites, all passing |490| UI tests (XCUITest) | 9 scenarios, all passing |491| Documentation examples | 150 examples compile and simulate; 59 error examples produce the stated error |492| Presets | all 24 compile and run in the simulator |493494Core line coverage, measured with `llvm-cov` ([report](docs/reports/coverage.txt)):495496| Module | Lines covered |497|---|---|498| ORIXAnalysis | 99.4 % |499| ORIXMIDI | 96.5 % |500| ORIXLibrary | 95.7 % |501| ORIXDSP | 94.9 % |502| ORIXScript | 94.0 % |503| ORIXDJEngine | 81.6 % |504| **Total** | **91.6 %** |505506The SwiftUI layer is not in that figure; it is exercised only by the 9 UI scenarios.507Test strategy: [`docs/development/testing.md`](docs/development/testing.md).508509## 31. Measurements510511Measured on a MacBook Pro (Apple M5 Max), macOS 27.0, release build, 48 kHz, with other processes running. These512are measurements on one machine, not guarantees. Raw output:513[`engine-benchmark.txt`](docs/reports/engine-benchmark.txt), [`live-device.txt`](docs/reports/live-device.txt).514515**Render cost, offline** (time to render one buffer, against the time the buffer lasts):516517| Load | Buffer | Mean | p99 | Mean load |518|---|---|---|---|---|519| 2 decks, EQ and filter | 256 | 12.1 µs | 46.8 µs | 0.23 % |520| 4 decks, EQ and filter | 256 | 20.3 µs | 56.8 µs | 0.38 % |521| 4 decks, key lock, 14 effects, limiter | 256 | 70.5 µs | 149.3 µs | 1.32 % |522| 4 decks, key lock, 14 effects, limiter | 64 | 18.4 µs | 62.9 µs | 1.38 % |523524**On a real output device** (Core Audio real-time thread, master at −60 dB, 20 s per run, same heavy load):525526| Buffer | Callbacks | Mean | Max | Overloads | Timed automation commands | Late |527|---|---|---|---|---|---|---|528| 256 | 3,756 | 61.5 µs | 246.2 µs | 0 | 560 | 0 |529| 512 | 1,881 | 236.0 µs | 2,895.5 µs | 0 | 560 | 0 |530531The device in that run was a Bluetooth headphone that reports 160 ms of its own latency; an earlier run on the532built-in speakers reported 798 frames of device latency and 21.96 ms of output latency at 256 frames. The largest533gap between two scheduler ticks was 4.12 ms for a nominal 4 ms.534535**Accuracy**536537| Property | Result |538|---|---|539| Phase error between two synced decks | mean 0.0066 ms, worst 0.021 ms |540| Start of a scripted, quantized deck against the grid | 0 samples |541| Pitch with key lock, rates 0.84 to 1.16 | within ±0.04 cents of 440 Hz |542| Stretch residual on a pure tone | 26 to 34 dB below the tone |543| Analysis of a 5-minute track | 0.35 s |544545**Real music.** Sixty tracks from the author's own music library were analysed546([table](docs/reports/real-music-analysis.tsv), no audio in the repository). For the twenty with a well-known547tempo, the detected tempo is within ±1 BPM of the commonly published value; those reference values were recalled,548not independently verified. Of eleven tracks with a commonly published key, six match exactly, two are the549relative key and three are a fifth away. Two complete transitions were rendered offline between real tracks with550the Bass Swap and Eight Bar Transition presets: no late command, no clipping. **Nobody has listened to them yet.**551552## 32. Privacy and Security553554- No account, no analytics, no crash reporting, no update check.555- The only network code in the application is the Anthropic client, used only when the user asks Claude Studio for556 something. `Scripts/check.sh` fails the build if network code appears anywhere else.557- The API key lives in the Keychain and is never logged.558- Hardened Runtime, no entitlement, no helper, no privileged operation.559- Scripts cannot read files, open connections or run code outside the language.560561Report: [`docs/reports/security.md`](docs/reports/security.md).562563## 33. Accessibility564565Controls carry a label, a value and, where it applies, adjustable actions; notices are announced to VoiceOver;566state is paired with text or shape, not colour alone; a colour-blind-safe and a monochrome waveform palette are567provided. Walking the accessibility tree in the UI tests found and fixed three classes of defects.568569Gaps: Reduce Motion, Increase Contrast and Reduce Transparency are not read by the application (the waveform570keeps scrolling); breakpoints can be set only with the mouse; contrast ratios are computed from the colour571tokens, not measured on screen; nobody has used the application with VoiceOver.572Report: [`docs/reports/accessibility.md`](docs/reports/accessibility.md).573574## 34. Localization575576English and Canadian French (1,270 strings). The French was written with the application and has not been577proofread by a second person.578579580581## 35. Release Status582583| Item | State |584|---|---|585| Version | 1.0.0 (build 1), arm64, macOS 15.0 or later |586| Signature | Developer ID Application, Hardened Runtime, no entitlement |587| Notarization, application | Accepted, submission `eafc4e24-d278-4460-8cef-0d7827e2481e`, stapled |588| Notarization, disk image | Accepted, submission `4c301728-4b75-4c88-b3b2-831d986bcbaa`, stapled |589| Gatekeeper | accepted (`spctl`) |590| Install check | disk image opened and application launched on two other Macs (M4 Pro; M2 with 8 GB), macOS 26.5.1 |591| `ORIX-DJ-1.0.0.dmg` | 7,383,880 bytes, SHA-256 `ec9de1ab4f05c7f8ae7f5122202de6e9ee0ec8e92444e6f0b13941b984208ee2` |592| `ORIX-DJ-1.0.0.zip` | 6,308,251 bytes, SHA-256 `63026b4e44b86ea2a58a44e6e617e2def6746de5aee0b1c6851c27a221393873` |593| Publication | published on 2026-11-21 with the owner's approval: [DMG](https://git.spboucher.ai/releases/orix-dj/v1.0.0/ORIX-DJ-1.0.0.dmg), [ZIP](https://git.spboucher.ai/releases/orix-dj/v1.0.0/ORIX-DJ-1.0.0.zip), [checksums](https://git.spboucher.ai/releases/orix-dj/v1.0.0/SHA256SUMS.txt); the published files were downloaded back and their checksums and notarization verified |594595Full account: [`RELEASE-REPORT.md`](RELEASE-REPORT.md).596597## 36. Known Limitations598599Not verified:600601- **Sound quality by ear.** Everything about audio was measured, nothing was listened to: the stretcher, the 18602 effects, the limiter and the two rendered mixes.603- **MIDI hardware.** Virtual endpoints only. No controller is claimed to be compatible.604- **Multi-channel audio interfaces.** Cue routing is verified offline only.605- **The live Anthropic API.** Stub and unit tests only.606- **VoiceOver** by a person; **macOS 15** (built for it, run on 26 and 27 only); **French** proofreading.607- **Long sessions.** No continuous session of an hour or more was run.608- Many mouse interactions in the secondary screens are covered by neither a UI test nor a manual pass.609610Not implemented:611612- Audio Unit hosting, stems separation, streaming services, DVS (timecode vinyl), video, Intel Macs.613- Variable-tempo beat grids. Tempo detection outside 78 to 156 BPM is folded into that range.614- Loop state in saved projects. Metadata tags in exported files.615- Ready-made controller mappings.616617## 37. ORIX Ecosystem, Author, License618619ORIX DJ is part of the ORIX family of native applications (Sheet, Docs, Clean, Monitor, Calc, Scan, Audio, Camera,620Secure, Arcade): [orixlab.dev](https://www.orixlab.dev).621622Author: Simon-Pierre Boucher · contact@spboucher.ai623624Copyright © 2026 Simon-Pierre Boucher. All rights reserved. The source is published for reading; no licence to625reuse it is granted.626