Skip to content

scribbletune/harmonics

Repository files navigation

Harmonics

Tools and utilities for a generic representation of scales, chords, progressions etc. for use in music software, music related web & mobile apps, scribbletune, VCV Rack plugins and Max for Live devices. Uses tonal for western classical and custom generators for other forms of music.

Install

npm install harmonics

Interface

Use harmonics in your project

const harmonics = require('harmonics');

Get an array of all the scales available in harmonics (includes the one's from Tonal and the Melakarta ragas).

harmonics.scales(); // ['ionian', 'dorian', 'lydian', '...', 'Kanakangi', 'Ratnangi', '...']

Get the notes of a scale as an array

harmonics.scale('C4 major'); // ['C4', 'D4', 'E4', 'F4', 'G4', 'A4', 'B4']

Scales available from Tonal are lower cased while ragas have their first letter capitalized.

harmonics.scale('C4 Kanakangi'); // ['C4', 'Db4', 'D4', 'F4', 'G4', 'Ab4', 'A4']

Get an array of all the available chords (with numeric chords such as 4, 5, 7 etc exposed as 4th, 5th, 7th)

harmonics.chords(); // ['M', 'm', 'maj7', '4th']

Get the notes of a chord as an array (defaults to the 4th octave)

harmonics.chord('C4 M'); // ['C4', 'E4', 'G4']

Get the notes of a chord as an array for a specific octave

harmonics.chord('C5 M'); // ['C5', 'E5', 'G5']

Get the notes of an "inline" chord such as CM or Cmaj7 or Dbsus4_6 (here 6 is the octave). This is used in Scribbletune where you can define a bunch of notes and use chords in between, e.g 'C4 E4 Csus2 G4' (here Csus2 is "inlined" with C4, E4 and G4)

harmonics.inlineChord('CM'); // ['C4', 'E4', 'G4']
harmonics.inlineChord('CM_5'); // ['C5', 'E5', 'G5']

Get the indices of a scale/raga or bitmap

harmonics.getIndicesFromScale('phrygian'); // [0, 1,  3,  5, 7, 8, 10, 12]
harmonics.inlineChord('110010110011'); // [0, 1,  3,  5, 7, 8, 10, 12]

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

No packages published