Music theory multitool with a jazz focus
Switch branches/tags
Nothing to show
Clone or download
jsrmath Merge pull request #8 from mattcarpenter/master
Fix chord.identify for empty arrays
Latest commit 4f5857c Nov 24, 2017

README.md

Sharp11

Music theory multitool with a jazz focus

Introduction

Sharp11 is an npm module for performing music theory operations, ranging from simple things like transposing a note to complicated things like generating an ordered list of scales that can be played over a given chord. I also built an interactive web front-end to showcase the features of Sharp11, which I encourage you to play around with.

So what can Sharp11 do?

Sharp11 contains several modules for manipulating everything from notes and durations to entire corpora of jazz charts. A full list of Sharp11 modules and what they can do is available in the docs. With the exception of the MIDI output option, everything in the core Sharp11 library deals purely with Sharp11 objects. For audio output, check out the sharp11-web-audio library.

Sharp11 Ecosystem

The main Sharp11 library can be thought of as the core module of a larger comptuer music ecosystem. Other libraries in this ecosystem include sharp11-improv, a tool for generating improvisations over jazz chord changes, and sharp11-jza, a probabilistic automaton model for jazz harmony. The latter makes use of the iRb corpus, a corpus of over a thousand jazz standards that can be loaded into Sharp11 by installing the sharp11-irb library.

Mutability

Methods in Sharp11 do not mutate objects, but instead return new ones. I feel that in music, a C4 should be a C4, not a reference to an object that might become a D4 at some point. The same goes for chords, scales, and every other use case I've come across. There's nothing stopping you from mutating objects in Sharp11, but if you plan to extend any Sharp11 APIs or build anything on top of Sharp11, please try to abide by this rule.

Install

npm install sharp11

API Documentation

Read the full Sharp11 API documentation here.

Example Music Theory Operations

var s11 = require('sharp11');

Transposing a note:

s11.note.create('Ab').transpose('P4'); // Db
s11.note.create('Ab').transposeDown('P4'); // Eb
s11.note.create('Ab3').transpose('P4'); // Db4

Finding the interval between two notes:

s11.note.create('C').getInterval('F#'); // aug4
s11.note.create('F').getInterval('Abb'); // dim3

Parsing a chord symbol:

s11.chord.create('G'); // G B D
s11.chord.create('Am7b5'); // A C Eb G
s11.chord.create('Cmaj7/B'); // B C E G
s11.chord.create('F/G'); // G F A C
s11.chord.create('CmM9#11'); // C Eb G B D F#

Identifying a chord:

s11.chord.identify('C', 'Eb', 'G', 'A'); // Cm6
s11.chord.identify('A', 'C', 'Eb', 'F'); // F7/A
s11.chord.identify('G', 'B', 'D#', 'F', 'A#'); // G7#5#9
s11.chord.identify('F#', 'C', 'Eb', 'G', 'B', 'D'); // CmM9#11/F#

Working with scales

s11.scale.create('C', 'major'); // C D E F G A B
s11.scale.create('G', 'altered'); // G Ab Bb Cb Db Eb F
s11.scale.create('F', 'melodic minor').descending(); // [F, Eb, Db, C, Bb, Ab, G]
s11.scale.create('C', 'major').transpose('m3'); // Eb F G Ab Bb C D
s11.scale.create('C', 'major').contains('F'); // true