Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/abbernie/tune
A web audio tuning library of microtonal and just intonation scales
https://github.com/abbernie/tune
Last synced: about 2 months ago
JSON representation
A web audio tuning library of microtonal and just intonation scales
- Host: GitHub
- URL: https://github.com/abbernie/tune
- Owner: abbernie
- Created: 2015-07-29T18:57:41.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2017-11-27T17:47:46.000Z (about 7 years ago)
- Last Synced: 2024-08-01T03:19:02.077Z (4 months ago)
- Language: HTML
- Size: 19.4 MB
- Stars: 169
- Watchers: 9
- Forks: 24
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-webaudio - TuneJS - A tuning library of microtonal and just intonation scales. Supports over 3,000 historical tunings. (Obsolete / Community)
README
# TuneJS
**Authors:** Andrew Bernstein & Ben Taylor
**Overview:** Tune.js is a web audio tuning library of microtonal and just intonation scales. Tune.js supports over 3,000 historical tunings and temperaments, ported from the vast [Scala](http://www.huygens-fokker.org/scala/) tuning archive via the Microtuner files [compiled and documented by Victor Cerullo](http://www.venetica.net/Sites/16tone/mtx_file_specs.htm).
**List of Tunings:** [Tuning Archive](http://abbernie.github.io/tune/scales.html)
**Demo:** [Microtonal Piano](http://abbernie.github.io/tune/)
### How to Tune.js, a Quick Start Guide
Download tune.js and include it in a script tag at the top of your page.
```html
```
Create a Tune.js instance.
```js
var tune = new Tune();
```
Load your scale of choice with the ```loadScale('scale-name') ``` method.
```js
tune.loadScale('mean19');
```
Set the root frequency that you'll be working with. This sets your scale to the key of A 440
```js
tune.tonicize(220);
```
Pass scale degree numbers to the ```note() ``` method. By default, ```note(degree) ``` returns the corresponding frequency in Hertz. You can use ```note() ``` to set the frequency of an oscillator.
```js
osc.frequency.value = tune.note(2);
```
Optionally, pass an octave in as a second parameter. This will return the frequency for the third note in the scale, one octave down.
```js
osc.frequency.value = tune.note(2,-1);
```
### Properties
#### Tune.mode.output
Set the output mode of `tune.note()`. Choose between
- **frequency**: `tune.note()` will return a hertz value, e.g. 392.43834 for a pure G4 over C4
- **ratio**: `tune.note()` will return a ratio value, e.g. 1.5 for a pure G over C
- **MIDI**: `tune.note()` will return an adjusted MIDI pitch, e.g. 67.0195 for a pure G4 over C4
```js
// Set the output mode to 'ratio', e.g. the ratio 3/2 will output 1.5
tune.mode.output = 'ratio';
```
The default output mode is 'frequency'. Currently the only available input mode is 'MIDI'.
#### Tune.tonic
The current root frequency of this Tune instance. To set the tonic of a Tune instance use the ```tonicize()``` method. The default tonic is set to 440 Hz.
```js
var tonic = 200;
```
#### Tune.scale
Read only. An array containing the ratio values of the current scale loaded with the ```loadScale()``` method.
```js
// Returns the length of the current scale
var scaleLength = tune.scale.length;
```
### Methods
#### Tune.note(scale-degree-# [, octave-#])
Returns a microtonally tuned note value for any scale degree input. By default, `Tune.note` returns a frequency value in hertz.
```js
// This will return the frequency for 7th scale degree of our scale
var note = tune.note(7)
```
Depending on `Tune.mode`, the `Tune.note` method may return a frequency value in hertz (default, e.g. 392.43834 for a pure G4 over C4), a ratio value as a float (e.g. 1.5 for a pure G over C), or a MIDI float value (e.g. 67.0195 for a pure G4 over C4). See `Tune.mode`.
An optional second argument lets you specify what octave to be played (i.e. -1 for one octave down, 1 for one octave up).
Additionally, `tune.note()` automatically wraps scale degrees that are out of range, so that `tune.note(8)` in a 7 note scale will return the second scale degree, one octave up. Therefore, given a 7 note scale, `tune.note(8)` is equivalent to `tune.note(1,1)`
#### Tune.tonicize(frequency)
Sets the scale's root frequency.
```js
//sets the base (tonic) frequency to 200 Hz
tune.tonicize(200);
```
#### Tune.chord([array-of-scale-degree-#s])
Returns an array of note values. Like `Tune.note()`, `Tune.chord()` returns values according to the current output mode (`Tune.mode`).
```js
// returns a three note chord with the specified scale degrees
var myMicrotonalChord = [60,67,71];
tune.chord(myMicrotonalChord);
```
#### Tune.search("string")
Searches through the scale archive for scales that match the query.
```js
//returns an array of scale names that contain the word "partch"
tune.search("partch");
```
### Example Tunings
| Name | Description |
|------|-------------|
| ji_12 | Basic just instonation with 7-limit tritone |
| harm30 | First 30 harmonics and subharmonics |
| pyth_31 | 31-tone Pythagorean scale |
| ptolemy | Intense Diatonic Syntonon, also Zarlino's scale |
| couperin | Couperin modified meantone |
| helmholtz_pure | Helmholtz's two-keyboard harmonium tuning untempered |
| partch_43 | Harry Partch's 43-tone pure scale |
| johnston_81 | Ben Johnston's 81-note 5-limit scale of Sonata for Microtonal Piano |
| young-lm_piano | LaMonte Young's Well-Tempered Piano |
| xenakis_chrom | Xenakis's Byzantine Liturgical mode, 5 + 19 + 6 parts |
| slendro | Observed Javanese Slendro scale, Helmholtz/Ellis p. 518, nr.94 |
| harrison_5 | From Lou Harrison, a pelog style pentatonic |
| malkauns | Mode of Indian Raga Malkauns, inverse of prime_5 |
### License
Tune.js is licensed as open source software under [the MIT license](https://opensource.org/licenses/MIT),
Archive copyright 2003-2010 by Victor Cerullo