OSC Setup Guide

What Is OSC?

OSC (Open Sound Control) is a network protocol for communicating between multimedia software and hardware. It sends structured messages over UDP (or TCP) to specific address paths — like a URL for a parameter value.

CueSync outputs OSC to control Resolume, QLab, TouchDesigner, Unreal Engine, Disguise, millumin, and any OSC-capable application.

Configuring OSC in CueSync

1. Open Network → Outputs and click + (or choose Output → Quick Add → Show Control → Custom OSC).
2. Pick the protocol — Resolume Arena, QLab, TouchDesigner, Unreal Engine 5, disguise, or Custom OSC for anything else.
3. Configure:

Custom OSC sends over UDP and lets you define your own address patterns in the OSC Schema Manager (Manage schemas…); QLab also offers a TCP output.

Common OSC Target Ports

All ports are configurable in each application's preferences. Check the target app's OSC settings if the default doesn't work.

OSC Message Format

CueSync sends standard OSC messages in the format:

/address/path  value

For example:

• /composition/layers/1/video/opacity 0.75 — set Resolume layer 1 opacity to 75%
• /cue/3/start — start QLab cue number 3
• /cuesync/bus/Energy 0.88 — CueSync's energy value for TouchDesigner, from the CueSync Bus (Settings → MIDI & Sync → CueSync Bus)

Sending OSC from Cues

On the Cues screen:

1. Click + to add a cue.
2. Set the Trigger — Beat or Manual in every edition; Phrase Change, Energy Level, BPM Range, Hot Cue Hit and the other music-reactive triggers in DJ and Production.
3. Click Add Action, open your OSC output under Your outputs, and choose its action — for a Custom OSC output, Custom OSC with a Target Device, Parameter and value; for a one-off message, Generic OSC under No output needed takes a Host, Port, OSC Address and space-separated Arguments.
4. Use Fade (OSC ramp) to move a value over beats or milliseconds instead of jumping to it.

Multiple OSC Targets

CueSync supports unlimited simultaneous OSC targets on every edition. Each action goes to the output you pin it to, or to every output of that protocol with Send to every … output ticked.