项目作者: Seanitzel

项目描述 :
:guitar: Music Theory in Code.
高级语言: JavaScript
项目地址: git://github.com/Seanitzel/Note-Art.git
创建时间: 2018-07-09T16:55:56Z
项目社区:https://github.com/Seanitzel/Note-Art

开源协议:MIT License

下载


Note-Art JS :guitar:

:fire:
Downloads
Build Status
Maintainability
Test Coverage
License: MIT
: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.

Table of Contents

About

  • Create Notes, Chords, Scales and more easily.
  • Designed to be simple and intuitive.
  • 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

  1. Transpose, generate chords and scales easily, invert chords.
  2. Tons of music theory utilities, e.g getting the interval between 2 notes, normalizing notes, getting the enharmonic pitch class, converting sharps to flats and a lot more.

Getting Started

Installation:

  1. # Using npm
  2. npm install note-art
  3. # Using yarn
  4. yarn add note-art

Usage

Note-art is fully written in TS and offers functions that can achieve any music theory related task you desire.

Theory Functions

  • patterns are in semi-tones.
Transpose any pitch class, note or group of notes easily
  1. import { transpose } from 'note-art'
  2. // PitchClass
  3. transpose('A', 5) // 'D'
  4. // Note
  5. transpose('A3', 5) // 'D4'
  6. // Group of notes(can represent a chord, scale or anything else)
  7. const notes = ['C3', 'E3', 'G3']
  8. notes.map(note => transpose(note, 7)) // ['G3', 'B3', 'D4']
Other functions
  1. import { noteFromFrequency, intervalsToNotes, invertChord };
  2. noteFromFrequency(440) // A4
  3. const majorChordPattern = [0, 4, 7];
  4. const cMajorChord = intervalsToNotes('C3', majorChordPattern) // ['C3', 'E3', 'G3']
  5. const cMajorFirstInversion = invertChord(cMajorChord, 1); // ['E3', 'G3', 'C4']


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. 1. Fork the Project
      2. 2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
      3. 3. Commit your Changes (`git commit -m 'Add some AmazingFeature`)
      4. 4. Push to the Branch (`git push origin feature/AmazingFeature`)
      5. 5. Open a Pull Request
  • Support me on patreon.

  • Download my app on the google play store
    • Music Guru - which can generate and
      play any scale in the history of mankind
      on google play.

Todo:

  • Create music theory functions - pitch class, note, chord, etc… :heavy_check_mark:

  • Re-implement Music notation.

Contact

Sean Dvir - seandvir12@gmail.com"">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.