Waiting for a selection in the main window.
Chords in 12-TET spelling → every just-intonation reading, with HEJI, cents, Hz, tuning routes and playback.
Manual ↗New here? Type chords as note names, one per line. JI-ify lists the ways each chord can be tuned in just intonation, writes the tuning you pick on the staff with Helmholtz-Ellis accidentals, and plays it. With several chords it holds the notes they share and shows how far the pitch drifts. The example below is loaded to try: press ▶ Play progression, then Start vs end. The ? beside each title explains that panel; the manual explains the rest.
The manual walks through the tool from the beginning. This block is the short version, then the reference.
most fused: all notes are low harmonics of one fundamental, so the chord sounds as one spectrum; measured by the largest harmonic number. simplest dyads: every pair of notes forms a simple, tunable interval, whether or not they share a fundamental (the "complexity" figure, lower is simpler). simplest route: the most complex interval on the tuning route is simpler than in the other readings. least retuning: smallest total movement from 12-TET. fewest signs: fewest HEJI comma signs to engrave. open strings: the most notes that stand in a simple ratio (odd part up to 15, within 3¢) to an open string of their player, violin G3 D4 A4 E5, viola C3 G3 D4 A4, cello C2 G2 D3 A3, tuned in pure fifths from the page's A4; ties go to the simpler ratios. The per-note column open string names the string and the ratio (5/4 × A4), so the note can be tuned as a double stop or by resonance. The overtone family is ranked by fusion; every other family by complexity. A mark is relative to the chord's own readings.
The recommended reading is the purest one (lowest dyad complexity); the alternatives are the most fused reading and the best of another family. Equally pure readings are ordered by fewest comma signs. The cards state facts (signs per note, the most complex interval on the route, the note farthest from the piano, primes, respellings) and do not grade a reading as easy or hard: that is for the players. One weighted sum of those facts remains, as the live pick easiest to read for MIDI input: 1.5 × the most comma signs on any one note + 0.5 × signs per note + 1.3 × the most complex interval on the route (Tenney height of the interval as sounded, 7/4 = 4.95, 16/9 = 7.17, 19/16 = 12.1; a note within 6¢ of 12-TET counts as 3, since it is simply played as on the piano) + 2 per respelled note + the largest move from the piano in cents ÷ 20 + 2 if a prime above 7 is used (+3 above 13) + 3 × the reading's complexity above the chord's best, as a fraction; lowest wins.
Letter = Pythagorean pitch; each sign is one comma, up or down, for one prime. Derived from the comma definitions, so confirm glyphs against the Plainsound legend before engraving.
Signs are measured from a 1/1. In the linked view that is the segment's first root, so signs the whole chord shares say where this chord's root fell (a root a 7·23 ratio away puts ↓7 ↑23 on every note). A chord that follows a 12-TET chord, or a reset, is its own 1/1: a tempered neighbour offers no ratio to measure from, so a link change there moves the chord (cents, Hz) without changing its signs; the column's caption states the reference it is measured from (1/1 A2 = 109.0 Hz). Spell from under the staff chooses what plays as well as what is written. Absolute: the chords are linked, chord 1's root is the one 1/1, drift is carried from chord to chord and every comma a link adds shows as signs. Relative: each chord stands on its own with its root at the piano's pitch, exactly as its card sounds, spelled from that root (as typed) or from whichever chord note reads cheapest (fewest signs: signs, then re-lettered notes); links, drift and the verdict do not apply, and a common tone that differs between two neighbouring chords shows its slip on the tie. Cents and Hz do not change, only the declared reference, which the title then states (spelled as typed, B♭2 = 118.33 Hz as 1/1).
Chords are linked in the order typed; with two or more chords the score becomes the progression, and the focused chord's link is set right under the staff. A common tone (same written note, or the same pitch class an octave away) is held at the same frequency; when several are shared, the one whose hold breaks the others least is chosen, and the breaks are reported with the comma they amount to. With no common tone the root moves by the simplest just ratio within tolerance of the tempered motion, spelled as you spelled the roots (C→F♯ gives 10/7, C→G♭ gives 7/5). Each root's position against 12-TET is tracked as an exact ratio, so the net drift of a progression that returns to its first root comes out as a named comma (the I–vi–ii–V–I pump in 5-limit returns 80/81, a syntonic comma flat). A chord left at 12-TET is fixed; a reset link re-anchors the next root at its tempered pitch. Suggest searches the readings of every chord (beam width 40) for the path minimising Σ|breaks| + 8·(each reading's complexity above its chord's best, as a fraction); the drift-avoiding variant adds 0.5¢ of cost per cent of root drift at every chord.
How the figures above are worked out, and the parts that need more than a browser.
Suggested by Parncutt's root-support weights: a chord tone a unison, fifth, major third, minor seventh or major second above the candidate supports it by 10, 5, 3, 2, 1; the bass gets 1.5 extra. Type any pitch class to try an absent root.
Deviations from 12-TET with the chosen note held at its tempered pitch. To anchor elsewhere, add one constant to every value.
For each interval, the exponents of its primes above 2 times log2 of the prime, with primes above 7 weighted more (×1.6 for 11 and 13, up to ×2.3 for 31). Summed over all pairs, counting pairs with the root twice and with the bass one and a half times. Tuning routes and the "most complex interval" figures use the same height counting the 2s as well, so an interval's actual width matters.
An additive tone (24 harmonics, 1/n amplitudes with a gentle high-frequency roll-off, no vibrato). The level is scaled by the number of voices (n−0.75) with a mild tilt that lifts high notes and tames low ones, and a limiter at −3 dBFS guards the output, so a full chord does not clip. Single notes are therefore a little louder than the chord, per voice.
MIDI in listens to a keyboard (Chrome on your own machine, or inside Max's jweb); the chord you hold is read and tuned at once by the live-pick rule, and the sustain pedal (CC 64) captures it to the list. The performer window shows only the selected chord, large, and follows the main window through this browser's storage; inside Max it can be driven directly with a show message. For iPads, run node server.js in the repository: it serves this page and the performer display on the local network and prints one address per player (/perf?player=1 … 4, 1 = the lowest note); see the README. When the page runs inside jweb, every selection is sent out as selection <json> and hz …, and the page accepts chords, midi, capture, select, focus and show messages; see max/README-max.md in the repository.
One chord per line, lowest note first: a letter, an accidental if any (#, b, x, bb) and an octave number, C4 being middle C. MIDI note numbers work too. Text after | is the chord's name on the staff. How a note is spelled decides how it is tuned: D♯ and E♭ get different ratios.
Analyze reads the list. examples replaces it with a progression that drifts. The keyboard writes a chord for you: click keys, then Add to list or copy the line; black keys switches between sharps and flats for the keys you click next. The row below is for a MIDI keyboard, a second window for performers, and copying the results out. More in the manual
These decide which tunings are looked for. Families are the kinds of just intonation to try, named by the primes they use. Tolerance is how far a tuned note may sit from its piano pitch. Hold at 12-TET is the one note that stays at piano pitch. Your spellings says whether a reading may respell a note you typed. The defaults suit most chords; a change re-analyzes at once. More in the manual
The staff shows every chord in the list, each in the tuning chosen for it. Click a chord to focus it; the chips under the staff switch its tuning and the table lists its notes. Accidentals with arrows are Helmholtz-Ellis signs: each arrow moves the note by one small interval (a comma). Click a notehead to hear that note alone.
With several chords, dashed lines join notes that are held from one chord to the next, and each caption gives the chord's distance from the piano's pitch. The sentence beside the title sums up the drift. More in the manual
Each card is one reading: one way to tune this chord in just intonation. Per note: its ratio to the root, its Helmholtz-Ellis accidental in words, its distance from 12-TET in cents (blue = lower, amber = higher), its frequency. Tune is an order in which players can tune it, interval by interval.
Shortlist shows the recommended reading and two alternatives; All readings shows every family. The root is suggested; choose another, or type one, to read the chord differently. More in the manual