Werner's Miscellanea

Werner's Miscellanea Git Source Tree

1	midi2osc - MIDI to OSC forwarder
2	================================
3
4	midi2osc register itself as a writeable MIDI device. It then forwards
5	the MIDI messages it receives to the specified OSC destination.
6
7	Build prerequisites:
8
9	libasound(-dev) (ALSA)
10	liblo(-dev) (OSC)
11
12	Compilation:
13
14	make
15
16
17	Usage
18	-----
19
20	To 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
30	midi2osc can also remap MIDI controls. The syntax is
31
32	c[<chan>][.<control>]=c<chan>[.<control>[=<value>]]
33
34	where <chan> is a channel number and <control> is the optional control
35	number. 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
39	would map the joysticks and two faders of a Faderfox LV3 to the
40	controls 1 through 6 on channel 0, and send the OSC messages to
41	a host called "m1".
42
43	If <value> is given, that value will be assigned for any control
44	message that matches the input pattern, irrespective of the input
45	value.
46
47
48	File-based mappings
49	-------------------
50
51	To load mappings from a file containing #-style comments, the
52	following invocation can be used:
53
54	midi2osc `sed 's/#.*//' filename` ...
55

Branches:
master