user manual · rev. 2.4  ·  Version française

_chordlab

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
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.
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.
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)

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