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
- Press a chord key (the big keys at the bottom, or A–J on a keyboard) and hold it.
- Swipe across the strum strip, or press space, to play it like a guitar.
- 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
| colour | sounds | in C |
|---|---|---|
| root | just the root, one note: bare and percussive | C |
| power | root and fifth: open and raw, the punk and rock sound | C5 |
| triad | plain and clear, three notes | C |
| 7th | softer, jazzier | Cmaj7 |
| 9th | rich and shimmering | Cmaj9 |
| sus | open, floating, unresolved | Csus4 |
modules
Your band. Switch on any mix.
- keys: an electric piano playing the chord
- pad: a soft, floating layer underneath
- bass: the root note, low, sliding to the next chord
- arp: plays the chord's notes one by one, up and down, in time
With every module off the chord keys are silent and only strum sounds.
The three strips
bend · voicing · strum
| strip | what it does | keyboard |
|---|---|---|
| bend | Bends the whole chord up to two semitones up or down. Springs back when you let go. Each notch is a semitone. | ← → |
| voicing | The same chord higher, lower or stacked differently. Clicks into one of nine places and stays. Double-click to centre. | ↑ ↓ |
| strum | One 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.
- Turn tempo while repeating: the stutter speeds up or slows down, same pitch.
- Bend while repeating: the loop bends like tape, higher and faster or lower and slower.
- On a keyboard, hold 1 2 3 4 for a quarter, eighth, sixteenth or thirty-second note loop. Running through 1→4 is the classic build-up before a drop.
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.
| setting | what it does |
|---|---|
| arp notes | How fast the arp plays: 1/8 two notes per beat, 1/16 four, 1/8 T three (triplets, a rolling feel). |
| repeat | How long the repeat loop is. |
| sound | new, the full sound, or classic, the first plain one. |
| midi out | Send 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
| key | does |
|---|---|
| A S D F G H J | the seven chords of the key |
| W E T Y U | the five borrowed chords (on a German keyboard: Z instead of Y) |
| space | strum |
| ← → | bend, while held |
| ↑ ↓ | voicing |
| shift | hold, while held |
| 1–4 | repeat, while held |
| M | click (metronome) on and off |
| esc | close setup |
Sharing a 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.