Skip to content

Turn any array of integers into a fun little melody using the Web Audio API.

License

Notifications You must be signed in to change notification settings

chrisburnell/pentatonic

Repository files navigation

Pentatonic

Turn any array of integers into a fun little melody

What?

Pentatonic is a small JavaScript file that will play music generated from an array of integers from anywhere in your DOM.

Why?

Why not?

No, but really though, there’s no serious reason for this. It’s just fun.

Installation

Usage

pentatonic.js gives you a function, pentatonic() to use, like so:

for (let target of document.querySelectorAll(".pentatonic")) {
    target.addEventListener("click", () => {
        pentatonic(target.dataset.values.split(","))
    })
}

The function takes six parameters:

  1. notes — an array of positive integers (required)
  2. duration — the length of time to play the audio for, represented in milliseconds (default = 4000)
  3. volume — controls the gain of the audio, represented by a 0–1 range (default = 0.5)
  4. keyStart — the zero-index of the key on a standard keyboard from which the scale should start (default = 29 / C♯3 / D♭3)
  5. keyIntervals — an array of integers which represent half-steps in a loop which composes the desired scale (default = [2, 3, 2, 2, 3] / a pentatonic scale)
  6. keyLimit — represents the highest index in the desired scale by which input is bound by (default = 12)

Contributing

Contributions of all kinds are welcome! Please submit an Issue on GitHub or get in touch with me if you’d like to do so.

License

This project is licensed under a CC0 license.

About

Turn any array of integers into a fun little melody using the Web Audio API.

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Sponsor this project