User Manual

OSC Control
From version 2.0.0 Augustus Loop can be controlled via the Open Sound Control (OSC)
protocol.
If you’re new to OSC, start by visiting opensoundcontrol.org.
Two settings control what port Augustus Loop uses to listen on for OSC
commands. One is the base OSC port, set in the preferences. The second is
the OSC Port Offset control. If the port offset is set to something other than
‘Off’, then the two numbers are added together and the result used as the
port number. E.g. if the base port is 6000 and the port offset is 1, then
Augustus Loop will listen on port 6001.
Received OSC Commands
In the documentation below, OSC parameters are prefixed with a string to indicate their
type, as follows:
•
s - string
•
i - integer
•
f - float
All the examples assume that Augustus Loop is listening at address 10.0.0.1:6001.
/ping s:returnUrl s:returnPath
Responds by sending a message back to the returnUrl and returnPath with the parameters
s:hosturl s:version
E.g.
/ping osc.udp://10.0.0.2:7000 “/foo”
replies to 10.0.0.2:7000 with
/foo osc.udp://10.0.0.1:6001 “Augustus Loop 2.0.0”
/set i:param f:value
Sets the value of parameter ‘param’ to ‘value’.
/get i:param s:returnUrl s:returnPath
Responds by sending a message back to the returnUrl and returnPath with the parameters
i:param f:value
where ‘value’ is the value of parameter ‘param’. E.g.
/get 14 osc.udp://10.0.0.2:7000 “/foo”