This tar file contains the Hairless MIDI<->Serial Bridge and the
Ardumidi Arduino MIDI library (part of ttymidi.)

"Hairless MIDI<->Serial Bridge" allows you to send MIDI messages
to/from a serial device (like an Arduino.)

The project home page is http://projectgus.github.com/hairless-midiserial/

If you're a command line kind of person, I suggest checking out
ttymidi - http://www.varal.org/ttymidi/ - a different project that
creates a Serial/MIDI bridge on the command line. Hairless Bridge is
compatible with ttymidi.


RUNNING THE BRIDGE
==================

Run "hairless-midiserial" in this directory.

The executable is static linked, so you don't need to have installed Qt.


ARDUINO LIBRARIES
=================

Hairless Bridge is compatible with at least two libraries for
sending/receiving MIDI data from Arduino: Ardumidi, which is included,
and "Arduino MIDI Library", which is available from
http://arduino.cc/playground/Main/MIDILibrary

It's up to you which library to use. "Arduino MIDI Library" is nicer
in many ways, and seems to be the way of the future, but it doesn't
let you easily send debug messages to your computer along with the
MIDI messages.


USING ARDUINO MIDI LIBRARY
==========================

If you use the Arduino MIDI Library, you can follow the instructions
on their page: http://arduino.cc/playground/Main/MIDILibrary

The only difference is you need to initialise the serial port -after-
calling MIDI.begin(), like this:

void setup() {
  MIDI.begin(1);
  Serial.begin(115200);
}


USING ARDUMIDI
==============

Ardumidi is an Arduino MIDI library, part of the separate ttymidi
project (http://www.varal.org/ttymidi/). It can be used with Hairless
MIDI<->Serial Bridge.

To install Ardumidi, place the "Ardumidi" directory inside a
"libraries" directory within your Arduino "sketchbook" directory. Then
restart the Arduino IDE. Example sketches can be found in the example/ folder.


LICENSE
=======

The Hairless MIDI<->Serial Bridge is licensed under the GNU Lesser
General Public License 2.1, as described in the About box of the
application.

The Ardumidi library is licensed under the GNU General Public License
3, as described in the file Ardumidi\LICENSE.

 
