README

Note-Art JS :guitar:

:fire: :fire:

Demo (outdated) :musical_note: | API :blue_book:

Music is a highly versatile art that originates in nature, and has been taken up by mankind as a way of expression and also as an art. Now, it's going to be taken up by machines as well.

About the Project
Features
Getting Started
- Usage
Contribute and Support
Todo
Contact
License

About

Create Notes, Chords, Scales and more easily.
Designed to be simple and intuitive.
Create scores using music composition logic Note-Art has a music notation api that works like writing music sheets.
Easily integrate with other music libraries to play music in the browser You can use libraries like ToneJS to easily play scales, chords and even scores you create with Note-Art.
Use this library to create tools for musicians, research music theory, just create some fun music with programming and much more!

Features

Create Notes, Chords, Scales and more, manipulate and extract information from them.
Create full musical scores with multiple instruments.(Only theoretically)

You can use awesome libraries like ToneJS to play audio and schedule music in the browser.

Getting Started

One of the things that make note-art so awesome & easy to use is the way it was designed, musical models, and the notation system are not tightly coupled and do not rely on each other to work.
That means you can easily create music scores without ever needing to understand how the musical models work, or you can even create your own way of interacting with the notation API which is super intuitive and simple.

Installation:

npm install note-art

Usage

Music Models

The music models are pure music theory concepts that are translated to code.

patterns are in semi-tones.

import {PitchClass, Note, Chord, Scale} from 'note-art'

// PitchClass

const a = new PitchClass('a')

console.log(a.interval(5))  // Returns a new pitch class instance with 'D' as the pitch.

// Note

const A = new Note('a', 4)

console.log(A)      // A4

console.log(A.frequency) // outputs 440

const fourth = A.interval(5) // calculate 5 semitones up - fourth is the note E with octave 5

console.log(fourth) // E4

//Chord

const A_M = new Chord(a, [4, 7]})

console.log(A_M.pitchClasses) // A, C, E(returns pitch class instances)

//Scale

const C_Major = new Scale(new PitchClass('c'), [0, 2, 4, 5, 7, 9, 11]})

console.log(A_Major.pitchClasses) // C, D, E, F, G, A, B

Notation

The notation api is more complex so check out the api, or the demo source code to see an example of using it.

Check out the API for more.

Contribute and Support :pray:

Make a pull request :avocado:.

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
3. Commit your Changes (`git commit -m 'Add some AmazingFeature`)
4. Push to the Branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request

Support me on patreon.
Download my app on the google play store
- Scale Heaven - which can generate and play any scale in the history of mankind on google play (and press the banner once in a while ;)).

Todo:

Create base music models - pitch class, note, chord, etc... :heavy_check_mark:
Implement Music notation. :heavy_check_mark:

Contact

Sean Dvir - seandvir12@gmail.com - @seanitzel

Your welcome to mail me your ideas and recommendations!

License

Note-Art uses the MIT license, check out the license tab for more information.

note-art

Usage no npm install needed!