teoria-chord-progression v1.0.0

teoria-chord-progression

Diatonic chord progressions for Teoria.js - the JS lib for music theory.

Teoria.js is a lightweight and fast JavaScript library for music theory, both Jazz and Classical. It aims at providing an intuitive programming interface for music software (such as Sheet Readers, Sheet Writers, MIDI Players etc.).

Features

• A chord progression object, for creating and managing groups of teoria.chord
• Supports browser and Node environment
• Lightweight (2.6 KB minified, gzipped)

Installation

via npm:

npm install teoria-chord-progression

Browser compatible build available in ./dist

Alternatively, download the latest release from GitHub.

Not using a module system?

In a browser environment, the global function teoriaChordProgression will be added to window.

Usage

teoria-chord-progression depends on Teoria.js.

var teoria = require('teoria'),
    teoriaChordProgression = require('teoria-chord-progression');

// create teoria.scale object
var cMajorScale = teoria.scale('c', 'major');

// chords 1-7 in heptatonic scale
var chords = [2, 5, 1];

// construct a diatonic chord progression
var twoFiveOne = teoriaChordProgression(cMajorScale, chords);

// or pass chord length argument to build 7th chords
var twoFiveOne7thChords = teoriaChordProgression(cMajorScale, chords, 4);

// get teoria.chord by index
var Dmin7 = twoFiveOne7thChords.getChord(0);

// get simple representation
twoFiveOne7thChords.simple(); // [ [ 'd3', 'f3', 'a3' ], [ 'g3', 'b3', 'd4' ], [ 'c3', 'e3', 'g3' ] ]

Building

Fetch the code:

git clone git@github.com:JasonStorey/teoria-chord-progression.git

Enter the directory, and install the dependencies:

cd teoria-chord-progression && npm install

And build:

npm run build

Run the tests:

npm test

Contributing

Found a bug or missing feature? Please open an issue!

Send your feedback. Send your pull requests. All contributions are greatly appreciated!

Copyright and license

Created and copyright (c) 2014-2015 by Jason A. Storey

teoria-chord-progression may be freely distributed under the MIT license.