https://github.com/eibens/pitch
Tools for working with musical pitch in TypeScript for Deno.
https://github.com/eibens/pitch
deno diatonic frequency library midi music pitch tuning typescript
Last synced: 3 months ago
JSON representation
Tools for working with musical pitch in TypeScript for Deno.
- Host: GitHub
- URL: https://github.com/eibens/pitch
- Owner: eibens
- License: mit
- Created: 2021-07-10T18:59:59.000Z (almost 4 years ago)
- Default Branch: master
- Last Pushed: 2021-08-07T00:16:04.000Z (almost 4 years ago)
- Last Synced: 2025-03-05T05:17:18.156Z (3 months ago)
- Topics: deno, diatonic, frequency, library, midi, music, pitch, tuning, typescript
- Language: TypeScript
- Homepage:
- Size: 15.6 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# pitch
[pitch] is a collection of tools for working with musical pitch. It is
implemented in TypeScript for [Deno].
[![License][license-shield]](LICENSE) [![Deno doc][deno-doc-shield]][deno-doc]
[![Deno module][deno-land-shield]][deno-land]
[![Github tag][github-shield]][github] [![Build][build-shield]][build]
[![Code coverage][coverage-shield]][coverage]
# [cent.ts](cent.ts)
A [Cent] is a musical unit that equals 1/1200th of an octave.
# [centitone.ts](centitone.ts)
A [centitone] is a musical unit that equals 1/600th of an octave, which is equal
to 2 [cent].
# [diatonic.ts](diatonic.ts)
A [diatonic scale] consists of seven of the twelve tones of the chromatic scale.
# [midi.ts](midi.ts)
The MIDI standard associates numbers with the notes of the chromatic scale, for
example `69` for the pitch `A4`.
# [mts.ts](mts.ts)
The [MIDI Tuning Standard] (MTS) defines how MIDI numbers get converted to
absolute frequencies. For example, A4 at [440 hz] corresponds to MIDI number 69.
# [pitch.ts](pitch.ts)
The `Pitch` type defines an absolute pitch with a `Letter`, `Accidental`, and
octave `number`. The `Chroma` type defines a pitch without an octave and models
the concept of a [pitch class].
# [spn.ts](spn.ts)
In [Scientific Pitch Notation] (SPN) a musical pitch is specified by combining a
musical note name (with accidental if needed) and a number identifying the
pitch's octave. For example, `A4`, `C#4`, and `Eb2` are valid pitches in SPN.
Such strings can be parsed with the `parse` function.
```ts
import { parse } from "https://deno.land/x/pitch/spn.ts";
const { letter, accidental, octave } = parse("C#4");
console.assert(letter === "C");
console.assert(accidental === "#");
console.assert(octave === 4);
```
Given a `Pitch` object, the `stringify` function generates an SPN string.
```ts
import { stringify } from "https://deno.land/x/pitch/spn.ts";
const spn = stringify({
letter: "C",
accidental: "#",
octave: 4,
});
console.assert(spn === "C#4");
```
[pitch]: #
[Deno]: https://deno.land
[cent]: https://en.wikipedia.org/wiki/Cent_(music)
[centitone]: https://en.wikipedia.org/wiki/Cent_(music)#Centitone
[diatonic scale]: https://en.wikipedia.org/wiki/Diatonic_scale
[MIDI tuning standard]: https://en.wikipedia.org/wiki/MIDI_tuning_standard
[440 hz]: https://en.wikipedia.org/wiki/A440_(pitch_standard)
[scientific pitch notation]: https://en.wikipedia.org/wiki/Scientific_pitch_notation
[pitch class]: https://en.wikipedia.org/wiki/Pitch_class
[github]: https://github.com/eibens/pitch
[github-shield]: https://img.shields.io/github/v/tag/eibens/pitch?label&logo=github
[coverage-shield]: https://img.shields.io/codecov/c/github/eibens/pitch?logo=codecov&label
[license-shield]: https://img.shields.io/github/license/eibens/pitch?color=informational
[coverage]: https://codecov.io/gh/eibens/pitch
[build]: https://github.com/eibens/pitch/actions/workflows/ci.yml
[build-shield]: https://img.shields.io/github/workflow/status/eibens/pitch/ci?logo=github&label
[deno-doc]: https://doc.deno.land/https/deno.land/x/pitch/mod.ts
[deno-doc-shield]: https://img.shields.io/badge/doc-informational?logo=deno
[deno-land]: https://deno.land/x/pitch
[deno-land-shield]: https://img.shields.io/badge/x/pitch-informational?logo=deno&label