Open Sound Control

Work in progress

This page is a work in progress. Information on this page might be incomplete, incorrect or outdated.

Open Sound Control (OSC) is a network protocol used for connecting music technology, computers and other multimedia devices. Compared to MIDI it offers more flexibility, higher resolution and more bandwidth. However, it also requires a bit more configuration as message formats are less standardized thus it is a bit less plug-and-play.

The PolyPulses sends and receives OSC over UDP and currently only supports IPv4 addresses.

See also

To use OSC you need a working network connection between your PolyPulse and the device you want to communicate with. See Network.

Controlling the PolyPulse using OSC

Using OSC you can set PolyPulse parameters to exact values. Use the following address format:

track no	device	device no [1]	parameter [2]	value [3]	example OSC message
/ 1-5	/ seq	-	/ string	number	/2/seq/chance 75
	/ syn				/1/syn/filt_freq 440.0
	/ afx	/ 1-4			/5/afx/1/feedback 99.5
	/ mod	/ 1-?			/2/mod/4/amount 25.0

[1]

Note that if audio effects and modulators are added or removed you might have to change this number.

[2]

Replace spaces in the parameter name with an underscore.

[3]

Value can be sent as float, double, int32 or int64.

Examples

Listed below are several examples showcasing how to communicate with the PolyPulse via OSC. The examples assume that ethernet IPv4 is 192.168.0.203, OSC in port is 909 and that you are (somewhat) familiar with the software that is shown.

The sending examples shown how to:

• send messages to /1/syn/filt_freq to control the filt freq on the sound engine of track 1.

• send messages to /5/afx/1/feedback to control the feedback on the 1st audio effect of track 5.

Pure Data

Works with Pd-vanilla, plugdata (shown below) or Purr Data.

Max/MSP

Works with Max/MSP (shown below) or Max for Live.