Tonal
Dictionaries

Chord dictionary

A dictionary of musical chords.

import { ChordType } from "tonal";
 
ChordType.get("major").intervals; // => ["1P", "3M", "5P"],

API

ChordType.get

get(name: string) => object

Given a chord type name, return an object with the following properties:

  • name: the chord type name
  • aliases: a list of alternative names
  • quality: Major | Minor | Augmented | Diminished | Unknown
  • num: the pcset number
  • chroma: the pcset chroma
  • length: the number of notes
  • intervals: the interval list

Example:

ChordType.get("major"); // =>
// {
//   name: "major",
//   aliases: ["M", ""],
//   quality: "Major",
//   intervals: ["1P", "3M", "5P"],
//   num: 2192,
//   chroma: "100010010000",
//   length: 3
// });

ChordType.names

names() => string[]

List all chord type (long) names in the dictionary

ChordType.symbols

symbols() => string[]

List all chord type (long) names in the dictionary

ChordType.all

all() => object[]

Return a list of all available chord types.

ChordType.add

add(intervals: string[], names: string[], fullName?: string) => ChordType

Add a chord type to dictionary:

add(["1P", "3M", "5P"], ["M"], "mayor");

How to...

How to get triad chord names?

ChordType.all()
  .filter((get) => get.length === 3)
  .map((get) => get.name);

How to add a chord type to the dictionary?

ChordType.add(["1P", "3M", "5P"], ["M", "may"], "mayor");
ChordType.get("mayor"); // => { name: 'mayor', quality: "Major", chroma: ... }
ChordType.get("may"); // => { name: 'mayor', quality: "Major", chroma: ... }

On this page