Info

• HPL Player is a Node.JS package used to play .hpl files.
• Version 1.0.6

How To Use

First, we need to get the package.

const player = require('hpl-player');

Next, just do this and it will start the file.

player.play('path/to/example.hpl');

You can also detect an event.

player.onevent = function(eventname, data) {
  console.log(data);
}

Before you do that, we need to put something in the hpl file.

Lets just get over how this works first.

c0:127:0

• The first number after the note name is the velocity of the note.

• The second number after the note name is the delay of the note. (measured in milliseconds)

• This will simply play the note "c0" at velocity "127" as soon as it starts.

• To stop or release the note, put this after the "notename:velocity:time" thingy:

c0:stop:1000

• This stops the note "c0" 1 second after the midi plays (note that 1 second = 1000 milliseconds)

• To make another note, just put a space and then another notename:velocity:time.

• And always make sure you put this at the end of your file:

end:time

• Replace the "time" with the time that the last note of the file ends.

So, with a basic .hpl file with "c0:127:0 c0:127:1000 end:1000", these 2 JSON objects will pop up in console:

{ name: 'notepressed', value: 60, note: 'c5', velocity: 20 }
{ name: 'notereleased', value: 60, note: 'c5', velocity: undefined }

• The second one will pop up 1 second after the first one.

Changing Tempo

• The tempo event is in the code but it dosen't do anything yet. I will figure that out later.