README

midivent README
---------------

midivent is a MIDI library for Node.js.  It is based on portmidi
(http://sourceforge.net/apps/trac/portmedia/wiki/portmidi), so in
theory it should work with Linux, MacOS X and Windows.  The main
development platform is MacOS X.  It compiles on Ubuntu too.

midivent is currently in alpha state.

Please check out the documentation:  http://vaxbusters.org/midivent/

Comments?  Suggestions?  Get in touch: hans.huebner@gmail.com

Building
--------

1) Build steps under MacOS X
----------------------------

- install node, node-waf, npm

- install underscore
   $ npm install underscore

- install portmidi
  Build for 64-bit:
  https://github.com/thomasjachmann/portmidi

  Copy pmutil.h from hand to install directory
  $ sudo cp pm_common/pmutil /usr/local/include

1.1) Build steps under Ubuntu GNU/Linux  
---------------------------------------

- install node, node-waf, npm

- install underscore
   $ npm install underscore

- install portmidi
  $ sudo aptitude install cmake-curses-gui
  $ mkdir portmedia
  $ cd portmedia
  $ svn co https://portmedia.svn.sourceforge.net/svnroot/portmedia/portmidi/trunk portmidi
  $ cd portmidi
  $ ccmake . (press c to configure and g to generate and exit)
  $ make
  $ sudo make install
  $ sudo cp pm_common/pmutil* /usr/local/include

2) Build midivent
-----------------

$ cd src

Edit wscript to set the correct portmidi location

$ node-waf configure
$ node-waf
$ node-waf install

3) Run test example
-------------------

$ node test-listen.js