Nonchalantly Performs Magic
    Wondering what’s next for npm?Check out our public roadmap! »

    note-art
    TypeScript icon, indicating that this package has built-in type declarations

    3.0.1 • Public • Published

    Note-Art JS 🎸

    🔥 Downloads   Build Status   Maintainability   Test Coverage   License: MIT 🔥

    Demo (outdated) 🎵 | API 📘

    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.
    • 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

    1. Create Notes, Chords, Scales and more, manipulate and extract information from them.
    2. 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 🙏

    • Make a pull request 🥑.

      • 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... ✔️

    • Implement Music notation. ✔️

    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.

    Install

    npm i note-art

    DownloadsWeekly Downloads

    27

    Version

    3.0.1

    License

    MIT

    Unpacked Size

    1.2 MB

    Total Files

    117

    Last publish

    Collaborators

    • avatar