user manual · rev. 2.8  ·  Version française

_chordlab ORC

A chord and progression machine. The whole idea fits in one sentence: you don't play the notes of a chord, you describe it — a root, a type, some tensions — and the machine takes it from there, all the way to your synths or your DAW.

01

The front panel

The screen is laid out like a hardware front panel. Six zones, always in the same place:

Cm7 C4 · D#4 · G4 · A#4 1
CHORD TYPE
TENSIONS
ALTÉRATIONS 2
ROOT — 1-octave keyboard 3
VOICING
BASS · KEY 4
PROGRESSION — slots · ADD · PLAY · perf · BPM 5
MIDI OUT · EXPORT .MID · SESSION 6
  • 1LCD — your constant reference: chord name, actual notes, mode status.
  • 2Chord description — type (one active at a time) plus tensions and alterations (stackable).
  • 3Root — the only thing you actually “play”.
  • 4Shaping — voicing, drop, bass, key.
  • 5Sequence — the progression and its playback.
  • 6Ins and outs — the bridge to your studio.
fig. 1 — front panel map

The app header carries an FR / EN switch that flips the whole interface: labels, dropdowns, buttons, tooltips and messages. The language is detected at startup from your browser and stored in .json sessions. Musical vocabulary — chord names, types, tensions, performance modes — stays the same in both languages.

02

Your first chord

Three moves: pick a type, press a root, read the LCD. The chord sounds right away.

CHORD TYPE
DIM
MIN
MAJ
SUS4
1
ROOT
C 2
LCD
Cm
C4 · D#4 · G4
3
  • 1Select MIN — the LED lights up; only one type is active at a time.
  • 2Press C (mouse, touch, or the A key on your computer keyboard).
  • 3The LCD confirms: Cm, with the actual notes and their octaves.
fig. 2 — the core move: type + root → chord

The eight types

ButtonChordIntervalsCharacter
DIMdiminished1 · ♭3 · ♭5tense, passing
MINminor1 · ♭3 · 5dark, melancholic
MAJmajor1 · 3 · 5stable, bright
AUGaugmented1 · 3 · ♯5unsettled, strange
SUS2suspended 2nd1 · 2 · 5open, airy
SUS4suspended 4th1 · 4 · 5waiting to resolve
5power chord1 · 5neutral, heavy
m♭6minor flat 6th1 · ♭3 · ♭6dramatic, cinematic
03

Tensions & alterations

The two lower rows stack freely on top of the type: several LEDs on at once. Tensions add notes; alterations change or remove notes that are already there.

TENSIONS — add notes
6
m7
M7
9
♭9
♯9
11
♯11
ALTERATIONS — change / remove
13
♭5
♯5
no3
MIN + m7 + 9 pressed →
Cm7(9)
C4 · D#4 · G4 · A#4 · D5
fig. 3 — stacking: the deep-pad m9 chord in two LEDs

Combinations worth knowing

CombinationResultWhy
DIM + 6Cdim7a 6th on a diminished triad is the diminished 7th
DIM + m7Cø7the half-diminished, backbone of the minor ii–V
MAJ + m7 + ♯9C7(♯9)the “Hendrix” chord
type + no3open chordneither major nor minor — perfect for ambient
m7 + M7WTF?the LCD warns you. You do you.
♭5 and ♯5 replace the fifth rather than adding to it: C7♭5 contains F♯, not G plus F♯. That is what makes them usable straight away.
04

Voicing

The same chord can be tight, open, low or airy. Three independent tools stack up, in this order: rotation → drop → slash bass.

4.1 · The rotation knob (±8)

Each step rotates the chord: at +1 the lowest note jumps up an octave; at −1 the highest note drops down. Here is Cmaj7:

high ↑ low ↓ voicing 0 C4 E4 G4 B4 +12 voicing +1 E4 G4 B4 C5 +12 voicing +2 G4 B4 C5 E5 voicing −1 B3 C4 E4 G4
fig. 4 — rotation: the amber note is the one that just moved by an octave

How to drive it: drag vertically on the knob, use the − 0 + buttons or the ←→ arrows, double-click to return to 0. The same chord at +3 and at −2 tells two different stories.

4.2 · Drop voicings

Applied after the rotation, these spread the voices the way an arranger would:

high ↑ low ↓ close C4 E4 G4 B4 drop 2 G3 ↓ C4 E4 B4 spread C4 G4 E5 ↑
  • ↕The red notes are the ones moved by an octave by the drop mode.
fig. 5 — close · drop 2 (the jazz voicing) · spread (wide pad)
ModeEffectUse
closeclose position (no change)default
drop 22nd voice from the top → −1 octthe jazz standard
drop 33rd voice from the top → −1 octwide gaps, guitar-like
drop 2+4two voices droppedvery open, cinematic
spreadevery other voice → +1 octwide pads, ambient

4.3 · Bass and slash chords

The BASS button adds a held note (−1 or −2 octaves) on its own MIDI channel. The bass / selector picks which chord tone it plays: root, third, fifth or seventh — the LCD then reads C/E. Detection follows the chord: minor third on a minor chord, diminished fifth on a ♭5. If the chord has no seventh, asking for one falls back to the root.

05

Key Mode — one-finger diatonic chords

Turn on KEY, choose a tonic and one of the eight scales. Every key then produces the diatonic chord for its degree — you cannot fall out of the key.

C Dm Em F G Am Bdim I ii iii IV V vi vii°
fig. 6 — Key Mode in C major: each key gives its degree’s chord; out-of-key notes are dimmed and silent

The 6 m7 M7 9 11 13 tensions stay active and are harmonised within the scale: the 7th on G in C major gives a real G7 (with a natural F). The asterisk in the name (G7*) marks that diatonic harmonisation.

Harmonic minor is worth a try: its V degree becomes a genuine dominant chord with a leading tone — the classic minor cadence, with one finger.

Type and tensions. By default the quality comes from the degree (auto mode). You can pin a type button to force a quality on the played root, then click again to return to auto; the root always stays in key. All twelve tensions and alterations (including ♭9, ♯9, ♯11, ♭5, ♯5) work in both cases.

06

Building a progression

Play a chord, then hit ADD (or space): it becomes a slot in the sequence. Anatomy of a slot:

×
Fm7
F G# C D# +B
‹ − 3♩ + ›
1 2 3 4 5
  • 1× — delete the slot.
  • 2Name, notes, and +B when the bass is on.
  • 3Click the slot — audition it on its own.
  • 4− / + — length from 1 to 16 beats, one beat at a time. A 3-, 5- or 7-beat chord fits in a single slot.
  • 5‹ › — move the slot along the sequence.
  • ✎Edit the chord — reloads its configuration into the controls; ✓ update rewrites the slot, ✕ cancel leaves it untouched.
fig. 7 — anatomy of a progression slot

Three ways to fill the sequence

MethodActionWhen
By handplay + ADDyou know where you are going
Presetspick a progression + loadinstant starting point in your key (I–V–vi–IV, ii–V–I, circle of fifths…)
✦ suggestone click = one proposed chordlet the machine drift using functional harmony, take over when it gets interesting

Voice leading

The same progression, voiced two ways:

without VL — voices jump CFG with VL — voices glide CFG
fig. 8 — voice leading picks the voicing that keeps the voices moving as little as possible

VL AUTO (in the transport) applies this on every ADD; ⇄ voice-leading re-voices the whole existing progression in one go. Try it right after loading a preset — you hear the difference immediately.

07

Playback & performance modes

PLAY runs the progression at the displayed BPM, LOOP repeats it. The perf selector changes how each chord is delivered — everywhere: auditioning, live MIDI and .mid export.

block strum ↑ arp ↑ 1/16 t = 0 slot length →
fig. 9 — the same triad as block, strum and arpeggio
ModeOutput
blockchord played as a block
strum ↑ / ↓notes rolled upwards / downwards, guitar style
harpfast sweep (glissando)
arp ↑ / ↓ / ↕ / rndarpeggio at the speed set by rate (1/8 · 1/16 · 1/32)

HUM humanises velocity (±10) and timing (±15 ms) — strums and arpeggios breathe.

08

Live MIDI to your studio

Every chord you click, every slot you audition and the full playback go out over MIDI on two separate channels — chords and bass drive two different machines at once.

_chordlab browser (https) Web MIDI interface USB-MIDI ch 3 ch 5 Pro-800 chords / pads TD-3 + K-2 bass (unison)
fig. 10 — default routing: chords on ch3, bass on ch5 (both editable in the MIDI panel)

Getting going: ① plug the interface in before opening the page (or reload), ② allow the MIDI access the browser asks for, ③ select the device in the MIDI out (live) panel. The LCD reads MIDI ON.

Web MIDI needs HTTPS (or localhost). Over file://, audio and export still work but live MIDI output does not — which is why the app is hosted at chordlab.ghostinthemachine.fr. Safari does not support Web MIDI: use Chrome, Edge or Firefox. Stuck note on a machine? STOP sends All Notes Off across all 16 channels.
09

Export & sessions

progression slots + lengths .mid format 1 · PPQ 480 · tempo DAW (drag and drop) Tracker Mini (SD card)
fig. 11 — one file, two destinations
Export optionChoice
trackschords + bass (2 tracks, each on its own channel) · or chords only
render perfyes: strums and arpeggios are written note by note into the file · no: block chords (better if you plan to arpeggiate later in the DAW or tracker)

Alongside the .mid, the ↓ tracker (.txt) button produces a text file for hand transcription onto a tracker (Polyend Tracker Mini and similar): a pattern grid where each note takes a track (T1..Tn low→high) plus a bass column, with OFF to stop and ... to hold, followed by a reference section giving the notes and their MIDI numbers. The tracker resol. selector (1/16, 1/8, 1/4) should match your machine's pattern resolution.

Sessions

↓ save session writes a .json holding every setting and the full progression; ↑ load restores all of it. Nothing is kept in the browser: the file is the only persistence — version your sessions in Git like any other project file.

10

Keyboard shortcuts

The letters follow a piano layout. A QWERTY / AZERTY switch sits under the on-screen keyboard: only two keys differ between the two layouts, but they are C and C sharp, so the right setting makes all the difference. The app picks a layout at startup based on your browser language — change it with one click if needed, and the choice is stored in .json sessions.

QWERTY AWSEDFTGYHUJ
AZERTY QZSEDFTGYHUJ = C → B
espace ADD ←→ voicing −1 / +1
fig. 12 — only the first two keys differ between layouts

Two reference workflows

Dawless (hardware session)DAW / tracker (writing)
KEY ON → preset or ✦ suggest → ⇄ voice-leading → live MIDI (Pro-800 + TD-3) → LOOP while you shape the sounds and record to the mixer → save a .json session KEY OFF, free exploration of colours (types + tensions + drops) → VL AUTO → export .mid with render perf: no → import into the DAW or Tracker Mini → arpeggiation and sound design in the target machine