How to play

chordsoup is a harmony instrument for your browser. Pick a key and every chord you can play belongs in it, so you can't hit a wrong one. No music theory needed.


Start in ten seconds

tap, hold, strum

  1. Press a chord key (the big keys at the bottom, or A–J on a keyboard) and hold it.
  2. Swipe across the strum strip, or press space, to play it like a guitar.
  3. Move between chords. Try A → F → G → A.

No sound on an iPhone? Flip the ring switch off silent. Browsers only allow sound after your first tap or key press.


The chord keys

seven that always fit, five for spice

The lower row holds the seven chords of the key you picked. They all fit together. The small numeral on each key is its step in the key: a capital numeral (IV) is a major chord, bright; a lower-case one (ii) is minor, softer; ° marks a tense, diminished chord.

The upper row holds five borrowed chords. They come from outside the key but sound good in it, for special moments. In a major key they're the darker, cinematic chords; in a minor key they include the bright major V, which pulls you home.

In C major, try A → U → F → A (C → B♭ → F → C), a classic rock and pop move.

Several keys at once: the newest one sounds. Let it go and the one still held underneath comes back, so you can flick between two chords. On a touchscreen you can slide from key to key.

Legato: go straight from one chord to the next without letting go in between, and notes the two chords share are not struck again. They simply ring on, as if your finger stayed down, so the changes flow.


The panel

what kind of soup

key

The twelve round keys set the note the music is at home on. The chosen one is pressed in.

maj · min

One switch. Out is major (bright, happy). Pressed in is minor (darker, wistful).

colour

coloursoundsin C
rootjust the root, one note: bare and percussiveC
powerroot and fifth: open and raw, the punk and rock soundC5
triadplain and clear, three notesC
7thsofter, jazzierCmaj7
9thrich and shimmeringCmaj9
susopen, floating, unresolvedCsus4

modules

Your band. Switch on any mix.

With every module off the chord keys are silent and only strum sounds.


The three strips

bend · voicing · strum

stripwhat it doeskeyboard
bendBends the whole chord up to two semitones up or down. Springs back when you let go. Each notch is a semitone.← →
voicingThe same chord higher, lower or stacked differently. Clicks into one of nine places and stays. Double-click to centre.↑ ↓
strumOne string per note of the chord, over three octaves. Swipe to strum, tap to play a single note.space

Hold a chord and slide voicing slowly from left to right: the chord climbs without changing.


hold · repeat · click · rec

for playing live

hold

When it's on, a chord keeps sounding after you let go, until you play the next one. Tap the sounding chord again to stop it, or switch hold off. Holding shift does the same while it's down, like a piano's sustain pedal.

repeat

Hold it and the sound you're making loops in time, a stutter. The order doesn't matter: press repeat and then play, or the other way round. A new chord or strum while holding is looped instead.

click

A metronome: a click on every beat at the tempo, the first of every four a little higher, and the bpm in the display blinks along. With the click on, the arp starts in step with it. The click is only for you: it stays out of repeat and out of recordings. M switches it on and off.

rec

Press rec to record what you hear; the display shows the time. Press it again and the recording is saved as an audio file. Safari and recent Chrome save .m4a, other browsers .webm.


setup

the display, flipped

setup turns the display into a settings page; press it again, or esc, to go back.

settingwhat it does
arp notesHow fast the arp plays: 1/8 two notes per beat, 1/16 four, 1/8 T three (triplets, a rolling feel).
repeatHow long the repeat loop is.
soundnew, the full sound, or classic, the first plain one.
midi outSend what you play to other music apps or instruments (see below).

The two knobs: tempo (40–240 beats per minute) sets the arp, the click, the echo and the repeat; volume is volume. Drag up or down, scroll, or use the arrow keys.


Keyboard

everything at your fingertips

keydoes
A S D F G H Jthe seven chords of the key
W E T Y Uthe five borrowed chords (on a German keyboard: Z instead of Y)
spacestrum
← →bend, while held
↑ ↓voicing
shifthold, while held
1–4repeat, while held
Mclick (metronome) on and off
escclose setup

the link remembers

The address keeps your key, scale, colour, modules, tempo, voicing, sound and whether the click is on. Copy it and whoever opens it starts with exactly your soup. For example, #d-minor-7-kb-104 is D minor, 7th chords, keys and bass, 104 bpm.


midi out

chrome and edge

In setup → midi out, choose connect and allow access once, then pick where to send. Each module plays on its own channel: keys 1, pad 2, bass 3, arp 4, strum 5. Bend is sent as pitch bend (±2 semitones, most synths' default). own sound switches chordsoup's own sound on or off. Safari doesn't offer midi to websites.