Open Sound Control (OSC) Specification - v1.4

Created by Technical Support, Modified on Tue, 12 Nov at 4:24 PM by Technical Support

For software version 1.4 and higher, Open Sound Control (OSC) is a protocol for real-time communication between multimedia devices, allowing flexible, high-precision control over networks like Ethernet or Wi-Fi. Similar to MIDI, OSC can be used to control MaestroDMX in real time. Industry-standard controllers such as lighting desks and architectural lighting control systems can output OSC to control MaestroDMX over a network.

MaestroDMX Default Network Information:

  • Ethernet: 10.0.0.200

  • Wifi: 192.168.37.1

  • Hostname: maestro.local

  • Port: 7672

Note: The above information is modifiable via the WIFI and NETWORK control in MaestroDMX be sure to confirm the correct settings.


Function

OSC Address Path 

Data 

Range

Notes

Global Brightness

/global/brightness

float

0.0-1.0

Sets global brightness of lights

Set audio input by input name

/audio/input

string

Config name

Set the specific audio input based on the name of the input

Advance audio input

/audio/input/next

n/a

n/a

Advance to the next audio input on the input list

Live Pause

/live/pause

n/a

n/a

Pauses the live show

Live Resume

/live/resume

n/a

n/a

Resumes the live show

Live Stop

/live/stop

n/a

n/a

Stops the live show

Pattern Select

/live/N/pattern

string

Name of pattern

Select a pattern via name [ N = group ]

Pattern Select Via Channel 

(See Pattern List)

/live/N/pattern/channel

int

0 - number of Patterns

Sets pattern based on its order. Useful for fader interfaces such as TouchOSC [ N = group ]

Palette Select
(See Palette List)

/live/N/palette

int

Palette ID defined in config

Sets palette selection [N = group ]

Palette Select Via Channel

(See Palette List)

/live/N/palette/channel

int

0 - number of Palettes

Sets palette based on its order. Useful for fader interfaces such as TouchOSC [N = group]

FX Palette Select

/live/N/fx/channel

int

0 - number of FX Palettes

Sets FX Palette based on it’s order. Useful for fader interfaces such as TouchOSC [N = group]

Brightness

/live/N/brightness

float

0.0-1.0

Sets the current pattern brightness [ N = group]

Excitement

/live/N/excitement

float

0.0-1.0

Sets the current pattern excitement [ N = group ]

Background

/live/N/background

float

0.0-1.0

Sets the current pattern background [ N = group ]

Motion Range

/live/N/motion/range

float

0.0-1.0

Sets the current pattern motion range [ N = group ]

Motion Speed

/live/N/motion/speed

float

0.0-1.0

Sets the current pattern motion speed [ N = group ]

Speed

/live/N/speed

float

0.0-1.0

Sets the current pattern speed in live mode [ N = group ]

Energy

  /live/N/energy

float

0.0-1.0

Sets the current pattern energy in live mode [ N = group ]

Variance

/live/N/variance

float

0.0-1.0

Sets the current pattern variance in live mode [ N = group ]

Decay

/live/N/decay

float

0.0-1.0

Sets the current pattern decay in live mode [ N = group ]

Attack

/live/N/attack

float

0.0-1.0

Sets the current pattern attack in live mode [ N = group ]

Shape

/live/N/shape

int

0-15

Sets the current pattern shape in live mode [ N = group ]
Note: for core patterns only, works better in 2D

Load Show

/show/name

string

Show name

Load a given show based on its saved name. If multiple shows have the same name this will pick the first

Next Show

/show/next

n/a


Go to the next show

Previous Show

/show/previous

n/a


Go to the previous show

Load Show Based On Index

/show/channel

int

0- Number of Shows

Load a show based on its order. 

Advance to Cue

/show/cue

int

0 - Number of Cues

Advance to the specific index of a cue

Show Next Cue

/show/cue/next

n/a

n/a

Move to the next cue in the show

Show Previous Cue

/show/cue/previous

n/a

n/a

Move to the previous cue in a show

Show Pause

/show/pause

n/a

n/a

Pause the existing show

Show Play

/show/play

n/a

n/a

Play the existing show

Show Stop

/show/stop

n/a

n/a

Stop the existing show

Strobe

/triggers/strobe

boolean


Momentary Strobe

Toggle Strobe

/triggers/strobe/toggle

n/a

n/a

Toggle Strobe On/Off

Strobe Brightness

/triggers/strobe/brightness

float

0.0-1.0

Sets brightness of Strobe

Strobe Rate

/triggers/strobe/rate

float

0.0-1.0

Sets Strobe rate (min - max)

Blinder

/triggers/blinder

boolean


Momentary Blinder

Toggle Blinder

/triggers/blinder/toggle

n/a

n/a

Toggle Blinder On/Off

Blinder Brightness

/triggers/blinder/brightness

float

0.0-1.0

Sets brightness of Blinder

Blackout

/triggers/blackout

boolean


Momentary Blackout

Toggle Blackout

/triggers/blackout/toggle

n/a


Toggle Blackout On/Off

Fog

/triggers/fog

boolean


Momentary Fog

Toggle Fog

/triggers/fog/toggle

n/a


Toggle Fog On/Off

Fog Interval

/triggers/fog/interval

float

0.0-1.0

In timer mode, controls the interval of the Fog

Fog Duration

/triggers/fog/duration

float

0.0-1.0

In timer mode, controls the duration of the Fog ON

Fog Volume

/triggers/fog/volume

float

0.0-1.0

Fog Volume

Fog Speed

/triggers/fog/speed

float

0.0-1.0

Fog Speed

Effect

/triggers/effect

boolean


Momentary Effect

Toggle Effect

/triggers/effect/toggle

n/a


Toggle Momentary On/Off

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article