Open Sound Control

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	destination	device [1]	parameter [2]	value [3]	example message	destination
/ 1-5	/ seq		/ name	number	/2/seq/chance 75	Sequencer
	/ syn				/1/syn/filt_freq 440.0	Sound engine [4]
	/ sub				/4/sub/filt_freq 440.0	Subtractive
	/ fm				/3/fm/1_volume -12.0	FM
	/ add				/1/add/partials 26	Additive
	/ res				/2/res/pos-neg 20.0	Resonator
	/ qua				/5/qua/2_ratchet 3.7	Quad engine
	/ gra				/2/gra/variation 85.0	Granular
	/ ext				/1/ext/control_04 440.0	External
	/ afx	/ 1-4			/5/afx/1/feedback 99.5	Audio effect
	/ mod	/ 1-?			/2/mod/4/amount 25.0	Modulator

[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. Replace slashes with a dash.

[3]

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

[4]

Targets the currently selected sound engine.

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.