1
0
mirror of git://projects.qi-hardware.com/wernermisc.git synced 2024-12-28 21:52:25 +02:00
wernermisc/midi2osc/README

55 lines
1.3 KiB
Plaintext
Raw Normal View History

midi2osc - MIDI to OSC forwarder
================================
midi2osc register itself as a writeable MIDI device. It then forwards
the MIDI messages it receives to the specified OSC destination.
Build prerequisites:
libasound(-dev) (ALSA)
liblo(-dev) (OSC)
Compilation:
make
Usage
-----
To use it with the Milkymist One,
- enable Ethernet on the M1
- ./midi2osc IP-address-or-host-name
- launch qjackctl
- click on the Connect button in qjackctl
- in the "Connections" window, drag a connection from each MIDI device
you want to connect to midi2osc
- MIDI events will now show up in the MIDI settings dialog, etc.
midi2osc can also remap MIDI controls. The syntax is
c[<chan>][.<control>]=c<chan>[.<control>[=<value>]]
where <chan> is a channel number and <control> is the optional control
number. For example,
./midi2osc c8.1=c0.1 c8.2=c0.2 c9.1=c0.3 c9.2=c0.4 c0.7=c0.5 c7.7=c0.6 m1
would map the joysticks and two faders of a Faderfox LV3 to the
controls 1 through 6 on channel 0, and send the OSC messages to
a host called "m1".
If <value> is given, that value will be assigned for any control
message that matches the input pattern, irrespective of the input
value.
File-based mappings
-------------------
To load mappings from a file containing #-style comments, the
following invocation can be used:
midi2osc `sed 's/#.*//' filename` ...