tonal-index

📚 Music theory library providing iterable collections of every possible note, scale and chord

---

If you have ever needed to iterate through every possible note, scale, or chord in your music applications then tonal-index is the answer.

tonal-index uses tonal to dynamically generate and aggregate each collection.

Modes

Because tonal-index generates relatively large sets of data it may be loaded in either warm or lazy mode.

• Warm: Pre-generates and caches all of the possible collection values
• Lazy: Defers generation until the collections are actually needed (default)

Install

npm install --save tonal-index

then, either:

// warm / pre-cached module
const music = require('tonal-index')()

or

// lazy module
const music = require('tonal-index')

API

all

• Types: notes, scales, and chords
• Returns: Every possible combination of notes, scales, or chords

const { notes, scales, chord } = require('tonal-index')

notes.all()  // [ 'C', 'C#', 'Db', 'D', 'D#', 'Eb', ...]
scales.all() // 1530 results
chords.all() // 1853 results

by

Queries scale or chord collections by either type or root.

• Types: scales, chords
• Params:
  • key: Either 'type' or 'root' (i.e. the root note of the scale or chord)
  • value: The value to compare all other values against
• Returns: Entire collection filtered by entries matching a key and value

const { scales, chords } = require('tonal-index')

const majScales  = scales.by('type', 'major')
const min7Chords = chords.by('type', 'm7')

each

• Types: scales, chords
• Returns: Each combination of scales, or chords, one element at a time (generator)

const { scales } = require('tonal-index')

const generate = scales.each()

generate.next()

Output

You can find the full list of chords and scales in test/fixtures/*

Types

note

• Type: string
• Format: Scientific pitch notation

scale and chord

• Type: object
• Properties:
  • type:
    • Type: string
    • Format: Scientific pitch notation
    • Examples: "+add#9", "m7", "major"
  • root:
    • Type: string
    • Format: Scientific pitch notation
    • Example: "C"
  • notes:
    • Type: Array<string>
    • Format: Scientific pitch notation
    • Example: ["C", "E", "G#", "D#"]

Future

• Optionally group by root note
• Configurable octaves
• Chord voicings
• Chord inversions
• Generator collection

License

MIT