Home

Awesome

purescript-midi

Build Status

Latest release

MIDI support in the browser.

This library allows you to both parse and generate MIDI event streams and MIDI recordings. It also allows you to connect to a MIDI instrument (such as a keyboard) via the Web MIDI API. For example, if you use Chrome and can plug in a MIDI keyboard you should to be able to play it using this demonstration.

To parse a MIDI string that represents a recording and thus generate a value of type Midi.Recording you can use:

(parse <<< normalise) midiString

On the other hand, you may merely need to parse MIDI events (such as note on or note off) that emanate from a Web MIDI connection. In other words, you are connecting directly to a MIDI device through the browser and need to parse the stream of event messages as the instrument is played. To do this, use:

parseMidiEvent midiEvent

This will attempt to parse an individual event.

To Build

npm run build 

To Test

npm run test

Web MIDI Permissions

It appears that browsers are becoming stricter about allowing Web MIDI to run from 'untrusted' servers after being notified of security exploits. At the time of writing, both Chrome (see details) and Mozilla require HTTPS connections.

Module documentation

Module documentation is published on Pursuit.