MIDI for Node.js

A very basic node library to parse and write MIDI messages.

Usage

The library supports three major types of MIDI structures:

1. A sequence, representing a full MIDI file with multiple tracks.
2. A track, a ordered collection of messages.
3. A message, the basic component for the MIDI protocol.

These can all be parsed from a Buffer.

Parsing a Message

varmidi=require('midi-node');varnoteOff=newBuffer('803c00','hex');// Channel 0, middle C4, 0 velocityvarmessage=midi.Message.fromBuffer(noteOff);message.getStatus();// 0x80message.getCommand();// "NOTE_OFF"message.getChannel();// 0message.getData();// [0x3c, 0x00]

Parsing messages from a stream

Anything that emits a 'data' event can be used as a stream.

varmidi=require('midi-node');varinput=<somethingreadable>;
var stream = new midi.Stream(input);
stream.on('startTrack', function (track) {// do something with the track});
stream.on('event', function (delta, message) {message.getStatus();// 0x80message.getCommand();// "NOTE_OFF"message.getChannel();// 0message.getData();// [0x3c, 0x00]});

The following events are emitted:

• startFile, parameter is the file header
• startTrack, parameter is the track object
• event, parameters are delta and message
• endTrack, parameter is the track object
• error, parameter is the error object

Writing a Message

varmidi=require('midi-node');varstream=<somethingwritable>;
var writer = new midi.Writer(stream);
writer.startFile(0, 1, 128);
writer.startTrack();
writer.noteOn(0, 0, 0x3c, 100); // Channel 0, middle C4, 100 velocity

Resources

http://www.midi.org/techspecs/midimessages.php