GitHub Issues




group Discord chat Telegram chat Matrix
All Projects

Music Automata api

git:// Watch  Star  Fork

The goal of this project is to create an API that can be used to schedule and organize automated music generation using ReactiveX and the observable pattern.

To gain some insight into how this can be used, think of music generation as a series of mutations upon an existing set of data. For example, a random integer value could be transformed into a chord, and made to conform to a specific beat pattern before then being passed to an instrument to play. While it may be common to do so, these are not mutations that need to happen at the exact time that the note is played, and should happen independently.

In this API, something that can accept or output a note is referred to as a “Block”. Blocks are notified when a note is sent to them, and have the ability to modify the note, remove it, or create new notes before passing them along. Together, the blocks build a sort of tree structure along which notes are passed. For example, consider a set of blocks that are organized like below:

        /      \
    [piano]  [arpeggiator]

Here, all notes are created from keyboard input. They are then passed directly to the blocks “piano” and “arpeggiator”. The “piano” block simply plays the notes it receives. The “arpeggiator” mutates them - into an arpeggio - and passes the result of that mutation to the “synth” block which, again, plays them.

Using this API, here is an example of what such a structure might look like:

let synth = new Block()
    .on('noteStart', (note) => {
        audioApi.playMidiNote(note.midi, synthInstrument);

let arpeggiator = new Block()
    .on('note', (note) => {
        arpeggiator.forward(Object.assign(note, { midi: note.midi + 4 }));
        arpeggiator.forward(Object.assign(note, { midi: note.midi + 7 }));

let piano = new Block()
    .on('noteStart', (note) => {
        audioApi.playMidiNote(note.midi, pianoInstrument);

let keyboard = new Block()

Last updated: