https://github.com/ianprime0509/temperatune

A simple, browser-based tuner app with temperament support.
https://github.com/ianprime0509/temperatune

Last synced: 3 days ago
JSON representation

A simple, browser-based tuner app with temperament support.

• Host: GitHub
• URL: https://github.com/ianprime0509/temperatune
• Owner: ianprime0509
• License: mit
• Created: 2018-02-05T01:02:36.000Z (almost 7 years ago)
• Default Branch: main
• Last Pushed: 2023-10-19T09:40:36.000Z (about 1 year ago)
• Last Synced: 2024-04-17T06:57:06.796Z (7 months ago)
• Language: TypeScript
• Homepage: http://ianjohnson.dev/temperatune/
• Size: 2.57 MB
• Stars: 6
• Watchers: 3
• Forks: 1
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Temperatune

Temperatune is a simple tuner app that runs in the browser. Its key

distinguishing feature from the myriad of other online tuners is its support for

_[temperaments](https://en.wikipedia.org/wiki/Musical_temperament)_, which makes

it much more useful for people who want to play

[early music](https://en.wikipedia.org/wiki/Early_music) in period style or

music which does not originate in the traditional Western style (such as

[Arabic music](https://en.wikipedia.org/wiki/Arabic_music)). Of course,

Temperatune doesn't have built-in support for all these types of music; instead,

it allows the user to define temperaments as JSON files that Temperatune

understands.

## Browser support

I currently test Temperatune in the browsers I have access to, namely, Firefox

and Chrome for Linux and Chrome for Android. However, it should work on any

modern browser (meaning anything except Internet Explorer), and I hope to

eventually find ways to test on more browsers.

## Installation

To build and run Temperatune on your own machine, you should have

[Node.js](https://nodejs.org/en/) and [NPM](https://www.npmjs.com/) installed

(NPM comes bundled with Node.js). Then, to run the development version in a

local web browser:

```shell

$ npm start

```

To build an optimized production version:

```shell

$ npm run build

```

You will find the resulting files in the `build` directory.

## User-defined temperaments

The part of Temperatune that handles temperament definitions is actually a

separate module, called simply

"[temperament](https://github.com/ianprime0509/temperament)". Please see its

README for detailed usage on how to write your own temperaments or how to use

the same backend in your own project. For your reference, the JSON files

corresponding to the built-in temperaments can be found under the

`src/temperaments` directory of this project.

## License

This is free software, distributed under the

[MIT license](https://opensource.org/licenses/MIT).