1. knarf
  2. stdin2midi

Overview

HTTPS SSH
stdin2midi
==========

stdin2midi is a command-line [JACK client](http://jackaudio.org/) that:

* connect to JACK
* open an ouput port
* reads midi values on the standard input and send them on its output
  port
* close its port and exit on EOF.

Requirements
------------
In order to build stdin2mdi you need JACK and JACK header files.

Installation
------------
Edit config.mk to match your local setup.

Afterwards enter the following command to build and install (if
necessary as root):

    make clean install

Input format
------------
* input is pure ascii
* each midi event is composed of 3 bytes

To send a midi event, just print (in decimal) 3 numbers separated by
spaces and a newline. That's it. For more information about what
value to use, read this [pretty simple and good midi
doc](http://tonalsoft.com/pub/pitch-bend/pitch.2005-08-24.17-00.aspx).

Example
-------
This example creates a named pipe, use it as input for stdin2jack and
send a random event indefinitely.

    $ mkfifo in
    $ stdin2jack < in &
    [connect output port where you want using qmidiroute or whatever]
    $ while true; do echo 164 42 42; sleep 1; done > in

License
-------
stdin2midi is under the ISC license. See LICENSE for more detail.