note-transposer
v1.0.4
Published
Music transposition made easy
Downloads
462
Maintainers
Readme
note-transposer
note-transposer
is a module with a function to (surprise!) transpose notes, or create transposer functions:
var transpose = require('note-transposer')
transpose('C3', '3m') // => 'Eb3'
// create a transposer
var major3th = transpose('3M')
['C', 'D', 'E'].map(major3th) // => ['E', 'F#', 'G#']
It's also capable of add intervals, and is part of tonal
Install
Via npm: npm i --save note-transposer
and require the function.
Or use the distribution file (exports transpose
function to window globals):
<script src="note-transposer.min.js"></script>
<script>console.log(transpose('C3', '3m'))</script>
Usage
Note transposition
The simplest usage is with a note name (pitch) and interval (the order doesn't matter):
transpose('C2', '4A') // => 'F#2'
transpose('4A', 'C2') // => 'F#2'
Pitch class transposition
You can transpose pitch classes (note names without octaves), and the returned value will be a pitch class:
tranpose('A', '3M') // => 'C#'
tranpose('A5', '3M') // => 'C#5'
Add intervals
If you need it you can transpose an interval:
transpose('3M', '3M') // => '5A'
Transposers
Also, you can partially apply the function to get a transposer:
var major3th = transpose('3M')
major3th('D') // => 'F#'
Map arrays
Partially applied transposers allows to work with arrays seamlessly:
['C', 'D', 'E', 'F', 'G'].map(transpose('3M')) // => ['E', 'F#', 'G#', 'A', 'B']
['1P', '3m', '5P'].map(transpose('C')) // => ['C', 'Eb', 'G']
More...
See tonal
License
MIT License