Music programming language
JavaScript
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
src
test
.gitignore
Gruntfile.js
LICENSE
README.md
package.json

README.md

Polyhymnia

Polyhymnia is a programming language for composing music. It lets you write rules that evaluate to sequences and patterns of notes, chords and drums.

Polyhymnia is still in the design stage. Some things will change. Some things won’t.

Getting started

The best way to try Polyhymnia is in the online playgroud.

Build from source

To build Polyhymnia from source:

  1. Clone the repository and run grunt to build Polyhymnia.

  2. Add polyhymnia.min.js to your project.

<script src="js/polyhymnia.min.js"></script>
  1. Create a Context object, and pass in samples for your instruments:
var context = new Polyhymnia.Context({
  instruments: [
    { name: 'Kick', samples: [{ url: 'audio/Kick.mp3' }] },
    { name: 'Snare', samples: [{ url: 'audio/Snare.mp3' }] },
    { name: 'Hihat', samples: [{ url: 'audio/Hihat.mp3' }] },
    {
      name: 'Pad',
      samples: [
        { root: 'C', octave: 1, url: 'audio/PadC1.mp3' },
        { root: 'C', octave: 2, url: 'audio/PadC2.mp3' },
        { root: 'C', octave: 3, url: 'audio/PadC3.mp3' },
        { root: 'C', octave: 4, url: 'audio/PadC4.mp3' },
        { root: 'C', octave: 5, url: 'audio/PadC5.mp3' }
      ]
    }
  ]
});
  1. Pass the code you want to play to the Context object:
context.parse('Play = Pad: C D E F');
  1. Play it:
context.play();

Requirements

Polyhymnia runs in the browser and uses the Web Audio API, which is part of HTML5. It should work in all modern browsers, including Safari on iOS and Chrome on Android. You won’t have much luck with Internet Explorer.