JI-ify manual
JI-ify takes chords written the ordinary way, as note names, and shows how each could be tuned in just intonation. For every tuning it gives the ratios, the notation in Helmholtz-Ellis accidentals, the distance of each note from the piano in cents, and the frequencies, and it plays the result. Given several chords, it links them, holds the notes they share, and shows where the pitch ends up.
It does not choose a tuning for you. It lists the candidates, says what each costs the players, and lets you hear them.
A first look
On a first visit the tool opens on five chords: C major, A minor, D minor, G major and C major again.
- Press ▶ Play progression under the staff. Each chord is purely tuned, and every note that two neighbouring chords share is held at exactly the same pitch.
- Read the captions from left to right: 0.0¢, −15.6¢, −17.6¢, −19.6¢, −21.5¢. Each chord sits a little lower against the piano than the one before.
- Press Start vs end. You hear the first C major chord, then the same chord where the progression has left it, 21.5 cents lower. That gap is the syntonic comma, and the sentence beside the word Score says so.
- Click the second chord on the staff. The chips under the staff now list the tunings available for A minor; click another and listen to what changes.
- Read the line under the staff. It states the drift and offers four ways to deal with it. They are explained under Progressions.
Everything else in the tool is a closer look at one of these steps.
Entering chords
Type one chord per line in the Chords box, then press Analyze (or Ctrl+Enter, ⌘+Enter on a Mac).
C3 G3 E4 Bb4 | C7
- Notes are a letter, an accidental if there is one, and an octave number. C4 is middle C. Their order on the line does not matter.
- Accidentals:
#sharp,bflat,xor##double sharp,bbdouble flat. - A name for the chord can follow a
|. It appears under the chord on the staff and changes nothing else. - MIDI note numbers (60 = middle C) are accepted in place of note names; the tool then spells the notes itself.
- A chord needs at least two notes.
Spelling matters. D♯ and E♭ are the same key on a piano but different notes in just intonation, and the tool reads them differently. Spell a chord the way you would write it in a score.
The keyboard under the box writes a chord without typing. Click keys to switch notes on and off; the line below the keys lists them, lowest first, ready to copy. Add to list appends them to the chord box as a new line and analyzes. black keys switches between sharps and flats for the black keys you click next; notes already selected keep their spelling. White keys are always naturals, so E♯, C♭ and double accidentals have to be typed.
The examples menu replaces the list with a ready-made progression; see The examples. The list, the settings and your choices are kept in the browser, so the page reopens as you left it.
Readings and cards
A reading is one way of tuning a chord: a ratio for every note, measured from the root. Readings are grouped into families, according to which prime numbers their ratios use.
| Family | What it contains |
|---|---|
| Overtone series | Every note is a harmonic of one fundamental. Ranked by how low the harmonics are. |
| 5-limit | Primes 2, 3 and 5: pure fifths and pure thirds. |
| 7-limit | Adds prime 7: the low seventh of the harmonic series, 7/4. |
| 2·3·7 | Fifths and sevenths without prime 5: septimal thirds (9/7, 7/6) in place of 5/4 and 6/5. |
| 3-limit (Pythagorean) | Chains of pure fifths only. Close to the piano; useful as a comparison. |
| 11- and 13-limit | Adds intervals near quarter tones (11) and third tones (13). Switched off until you tick it under Settings. |
Under the score, the focused chord has a row of cards, one per reading. The table on a card for C7, read as harmonics 2, 3, 5 and 7 of a low C, looks like this:
| note | ratio | HEJI | ¢ | Hz |
|---|---|---|---|---|
| C3 | 1/1 | C3 | 0.0 | 130.81 |
| G3 | 3/2 | G3 | +2.0 | 196.22 |
| E4 | 5/2 | E4 ↓5 | −13.7 | 327.03 |
| B♭4 | 7/2 | B♭4 ↓7 | −31.2 | 457.84 |
- ratio: the note's frequency divided by the root's.
- HEJI: the accidental in words. ↓5 is one arrow down for prime 5, ↓7 the sign for prime 7. The staff shows the same thing as notation.
- ¢: how far the note is from its piano pitch, in cents (hundredths of a semitone). Minus is lower, on a blue ground; plus is higher, on amber.
- Hz: the frequency.
- open string, when filled: the note stands in a simple ratio to an open string of the instrument playing it, so it can be tuned against that string. The tool assumes a string quartet; who plays which note is set in the performer window.
Around the table:
- The line under the title names the family and states facts about the reading: comma signs per note, the most complex interval on the tuning route, the note farthest from the piano. The page does not grade a reading as easy or hard; that is for the players to say.
- Tune is an order in which the players can build the chord, one interval at a time.
- The words beside the title are what this reading is best at among the chord's readings: simplest dyads (every pair of notes forms a simple interval), most fused (the notes are low harmonics of one fundamental), simplest route, least retuning, fewest signs, open strings.
- ♪ Score puts the reading on the staff. ▶ Play plays it. 12-TET → JI plays the piano's version, then this one. Copy table copies the rows as text.
Shortlist shows the recommended reading and two alternatives. All readings shows every family in full.
The root. Ratios are measured from a root, and the tool suggests one. The menu beside the chord's name offers the other candidates with their scores; the box next to it takes any pitch class (type it and press Enter), including one that is not in the chord. A different root gives different readings of the same notes.
The score
The staff shows every chord in the list as a column of whole notes, each in the tuning chosen for it. A chord starts at 12-TET, the piano's tuning, until you choose a reading.
- Click a chord to focus it, or use the ← and → keys. The focused chord is shaded.
- The chips under the staff list the focused chord's tunings. Click one to choose it.
- The table under the chips lists the focused chord's notes, top note first.
- Click a notehead, or a row of the table, to hear that note alone.
- ▶ Play (or the space bar) plays the focused chord. 12-TET → JI plays it as on the piano, then tuned. Arpeggio plays the notes from the bottom, then together. Hold sustains the chord until you release it.
- ▴ staff hides the staff and keeps the controls.
The accidentals. The notation is the Helmholtz-Ellis JI Pitch Notation, HEJI. A note's letter and its ordinary sharp or flat place it in a chain of pure fifths. Each extra sign raises or lowers it by one small interval, a comma, belonging to one prime number: arrows on the accidental for prime 5, a separate sign for 7, others for 11, 13 and beyond. The tool's own legend is in Help and reference at the foot of its page; the full legend is published at heji.plainsound.org.
Spell from decides what the signs are measured from, and with it what you hear.
- absolute: the chords are linked. The first chord's root is the reference for everything after it, and whatever a chord has drifted shows in its signs.
- relative, as typed: each chord stands alone with its root at piano pitch, as its card sounds.
- relative, fewest signs: the same, written from whichever note of the chord needs the fewest signs.
Progressions
With two or more chords in the list, and spell from set to absolute, the tool links each chord to the one before it.
- A common tone is held. If two neighbouring chords share a note, it keeps exactly the same frequency, and the second chord is placed around it. When they share several, the tool holds the one that disturbs the others least and reports any that had to move.
- With no common tone, the root moves by the simplest just interval close to the written one.
- A chord left at 12-TET is fixed at piano pitch and starts the chain again.
The caption under each chord reads, for example, −15.6¢ · hold C3 → C4: this chord's root is 15.6 cents below its piano pitch, and it was placed by holding the C. The distance is the drift.
Changing a link. Focus any chord but the first and use link from previous under the staff: auto, hold a particular common tone, move the root by a stated ratio, or reset, which puts this chord's root back at piano pitch.
The summary beside the word Score gives the outcome. When the progression ends on the root it began on, the drift is given as an exact ratio, with its name if it is a known comma.
The line under the staff appears when the drift is 5 cents or more, with four choices:
- Accept: let it drift. The signs on the staff carry it.
- Slip a note by a comma: at one link, the held note is allowed to move so that the progression closes. The tool picks the link where this costs least.
- Reset at the last chord: the last chord goes back to piano pitch.
- Pick readings that don't drift: search again for readings, this time counting drift against them.
Suggest readings (hold common tones) searches the readings of every chord for the combination that breaks the fewest held notes. Suggest (hold, avoid drift) does the same and also keeps the roots near the piano. Copy progression copies every chord, link, drift and note as text.
Enharmonic spelling. Common tones are matched by their written names. B♭ in one chord and A♯ in the next are not held, and the link falls back to a root motion. This is why the cycle examples end on C♭ or B♯ and not on the note they began on: written that way, every common tone is held and the drift is visible.
The examples
Each example is a progression that does not come back to where it started when every common tone is held. Loading one replaces the chord list and chooses the readings.
| Example | Chords | Drift |
|---|---|---|
| Comma pump | C, Am, Dm, G, C | −21.5¢, syntonic comma (80/81) |
| Pump with dominant sevenths | C, A7, D7, G7, C | −21.5¢, syntonic comma |
| Giant Steps cycle | B, D7, G, B♭7, E♭, G♭7, C♭ | +41.1¢, lesser diesis (128/125) |
| Major thirds | C, E, G♯, B♯ | −41.1¢, lesser diesis |
| Minor thirds | C, A, F♯, D♯, B♯ | −62.6¢, greater diesis (625/648) |
| Circle of fifths | C upward by fifths to B♯, thirteen chords | +23.5¢, Pythagorean comma |
| Two chords | B7(♯9,♭5), B♭13(♯9)/F | Loaded at 12-TET, for trying readings by hand |
The figures are for the default settings. With other settings the search may choose other readings.
Settings
A change takes effect at once.
| Setting | What it does |
|---|---|
| A4 (Hz) | The reference pitch, 400 to 480. Every frequency follows it. |
| Hold at 12-TET | The one note of a chord that stays at piano pitch: the root or the bass. The cents of all other notes are counted from there. |
| Tolerance (±¢) | How far a tuned note may sit from its piano pitch and still count as that note. 50 is a quarter tone. Lower it to keep readings close to the piano; raise it to admit more distant ones. |
| Readings per family | How many readings to keep from each family, 1 to 5. |
| Your spellings | prefer: readings that would respell one of your notes are kept but ranked lower. strict: they are dropped. ignore: spelling is not considered. |
| Overtone fits up to prime, and up to harmonic | How high in the harmonic series the overtone family may look. |
| Families | Which families to search. |
Keyboard, performers, export
- MIDI in connects a MIDI keyboard, in a browser that supports Web MIDI, such as Chrome. A chord held on the keyboard is read and tuned at once by the live pick rule (purest, most fused, easiest to read, a particular family, or open strings). Capture, or the sustain pedal, adds the held chord to the list.
- Performer window ↗ opens a second window that shows only the focused chord, large, with each note's name, accidental, ratio, cents and frequency. It follows the main window as long as both are open in the same browser on the same computer. The instrument for each note is chosen there.
- Copy CSV copies every row of every reading of every chord, for a spreadsheet or another program. Copy all as text copies the same as text tables. Copy session log copies every selection made, with its time.
- The round button at the bottom right changes the colours. The staff stays on white.
Limits
- The accidentals are worked out from the definitions of the commas. Check them against the published HEJI legend before engraving a score.
- Playback is a plain synthetic tone with no vibrato. It is a tuning reference, not a rendering of instruments.
- The recommendation comes from a fixed rule: the purest reading first. The rule is written out in Help and reference on the tool's page.
- Nothing is sent anywhere. The chord list and settings are stored in your browser only; another browser or device starts fresh.
Terms
- 12-TET
- Twelve-tone equal temperament, the tuning of the piano. The tool measures everything against it.
- Cent, ¢
- A hundredth of a tempered semitone. Cent
- Ratio
- An interval as a fraction of frequencies: 3/2 is a pure fifth, 5/4 a pure major third. 1/1 is the note everything else is measured from.
- Limit
- The largest prime number allowed in the ratios. 5-limit uses 2, 3 and 5. Limit
- Comma
- A small interval, the difference between two ways of reaching nearly the same note. The syntonic comma, 81/80, is 21.5 cents.
- Drift
- How far a chord in a progression has moved from its piano pitch through pure intervals and held notes. Comma pump
- HEJI
- The Helmholtz-Ellis JI Pitch Notation, by Marc Sabat and Wolfgang von Schweinitz, revised in 2020 by Marc Sabat and Thomas Nicholson.
- Reading
- This tool's word for one tuning of a chord.
Further reading
- Just Intonation Explained, Kyle Gann. A short introduction for musicians.
- Just intonation, Wikipedia.
- HEJI, Plainsound Music Edition. The notation's legend, fonts and documents.
- Harmonic Space Calculator, Plainsound. Ratios to HEJI notation, one interval at a time.
- Plainsound Music Edition. Scores and writings on just intonation.
- Just intonation, Xenharmonic Wiki. Reference pages on intervals, commas and limits.
- List of intervals, Huygens-Fokker Foundation. Names for several hundred ratios.