Skip to Content
Tonal
Harmony

Progressions

@tonaljs/progression on npm

Parse and create harmonic progressions

import { Progression } from "tonal";

Progression.fromRomanNumerals("C", ["IMaj7", "IIm7", "V7"]); // => ["CMaj7", "Dm7", "G7"]

API

Progression.fromRomanNumerals

fromRomanNumerals(keyTonic: string, chordProgression: string[]) => string[]

Given a tonic and a chord progression expressed in roman numeral analysis chords, returns the progression expressed in leadsheet chords.

Progression.fromRomanNumerals("C", ["IMaj7", "IIm7", "V7"]);
// => ["CMaj7", "Dm7", "G7"]

A lowercase roman numeral is a minor chord, unless its chord type already has a quality (like viio, iim7 or ii+). Every spelling of a chord type gives the same chord (iimaj7 and iiMaj7 are both minor-major sevenths):

Progression.fromRomanNumerals("C", ["I", "vi", "ii7", "V7", "viio"]);
// => ["C", "Am", "Dm7", "G7", "Bo"]

An applied (secondary) chord, like V7/V, is a chord on a degree of another degree's major scale. Applied chords can nest:

Progression.fromRomanNumerals("C", ["I", "V7/ii", "ii", "V7/V", "V7", "I"]);
// => ["C", "A7", "Dm", "D7", "G7", "C"]
Progression.fromRomanNumerals("C", ["viio7/V", "V/V/V"]);
// => ["F#o7", "A"]

A note after a slash is the bass: I/E is C/E. A numeral whose chord type isn't a known chord type gives an empty string:

Progression.fromRomanNumerals("C", ["I/E", "V65", "It6"]);
// => ["C/E", "", ""]

Progression.toRomanNumerals

toRomanNumerals(keyTonic: string, chordProgression: string[]) => string[]

The opposite of fromRomanNumerals. Given a tonic and a chord progression expressed in leadsheet chords, returns the progression using roman numeral analysis chords.

Progression.toRomanNumerals("C", ["CMaj7", "Dm7", "G7"]);
// => "IMaj7", "IIm7", "V7"]

References

On this page