Root/midi2osc/README

Source at commit 5a34af4f9a210fa534d026c3da10ab3197b2289f created 9 years 11 months ago.
By Werner Almesberger, ircstat/README: run "mlabs" for IRC statistics
1midi2osc - MIDI to OSC forwarder
2================================
3
4midi2osc register itself as a writeable MIDI device. It then forwards
5the MIDI messages it receives to the specified OSC destination.
6
7Build prerequisites:
8
9libasound(-dev) (ALSA)
10liblo(-dev) (OSC)
11
12Compilation:
13
14make
15
16
17Usage
18-----
19
20To use it with the Milkymist One,
21
22- enable Ethernet on the M1
23- ./midi2osc IP-address-or-host-name
24- launch qjackctl
25- click on the Connect button in qjackctl
26- in the "Connections" window, drag a connection from each MIDI device
27  you want to connect to midi2osc
28- MIDI events will now show up in the MIDI settings dialog, etc.
29
30midi2osc can also remap MIDI controls. The syntax is
31
32c[<chan>][.<control>]=c<chan>[.<control>[=<value>]]
33
34where <chan> is a channel number and <control> is the optional control
35number. For example,
36
37./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
38
39would map the joysticks and two faders of a Faderfox LV3 to the
40controls 1 through 6 on channel 0, and send the OSC messages to
41a host called "m1".
42
43If <value> is given, that value will be assigned for any control
44message that matches the input pattern, irrespective of the input
45value.
46
47
48File-based mappings
49-------------------
50
51To load mappings from a file containing #-style comments, the
52following invocation can be used:
53
54midi2osc `sed 's/#.*//' filename` ...
55

Archive Download this file

Branches:
master



interactive