Network Cues

Network cues allow QLab to send messages using the network connection of your Mac. At present, QLab can send three types of network messages:

  • OSC messages, which use the Open Sound Control protocol; a flexible, extensible, network-based messaging system designed as a sort of successor to MIDI.
  • QLab messages, which use a subset of OSC to send QLab-specific commands.
  • UDP messages, which send plain text as UDP packets.

When a Network cue is selected, three tabs will appear in the Inspector:

  • Basics
  • Triggers
  • Settings

The Basics and Triggers tabs are the same for all cue types, and you can learn more about them from the page on the Inspector in the General section of this documentation.

Settings

Destination. This drop-down menu shows the sixteen network patches, or destinations, to which QLab can send messages. You can edit this list in Network Settings.

Type. Select which type of message you want to send; OSC message, QLab message, or UDP message.

Send. Click this button to test-send your message.

OSC Messages

OSC message

This option gives you a text field to enter any OSC command. For example, to tell a remote copy of QLab to GO, enter the command /go. Multiple arguments in a custom OSC message are separated by spaces, like this:

/my/groovy/message 2 10 12

That sends message message to address /my/groovy with three integers, 2, 10, and 12, as separate arguments.

When a Network cue is set to send an OSC message, a second drop-down menu appears with options for fading the value of the OSC message over time.

No fade

The OSC message is sent exactly as you entered it, right when the cue is triggered. If you give the Network cue a duration, then this message will be sent repeatedly for the duration of the cue.

1D fade

Choosing 1D Fade will allow you to set a starting value and ending value, and have QLab send a series of OSC messages to fade between them. When you choose 1D Fade, enter your OSC message in the text field, and use the token #v# to represent the value which will fade.

  • Duration sets the length of the fade, just like a Fade cue.
  • From sets the starting value of #v#.
  • To sets the final value of #v#.

You can also adjust the fade curve as needed.

1D OSC fading

2D fade

If your OSC message has two values you'd like to fade, then 2D Fade is for you. 2D OSC fades show a blue rectangular area which let you draw a two dimensional path using your mouse or trackpad. To fade a two-value OSC message, enter your OSC message in the the text field, and use the tokens #x# and #y# to represent the two values which will fade.

  • Duration sets the length of the fade, just like a Fade cue.
  • Max X sets the highest possible value for #x#.
  • Max Y sets the highest possible value for #y#.

Then, click and drag to draw a path within the blue rectangular area. A green circle will indicate the starting position of the fade, and a red one will indicate the ending position.

2D OSC fading

QLab messages

When using Network cues to communicate with another computer running QLab, or to send OSC messages from QLab back to itself, this option provides a very simple interface for accessing the commonly used OSC commands that QLab recognizes. Enter a cue number, and choose a command to send. Some commands have additional arguments, and additional fields will appear when those commands are chosen.

QLab messages

UDP messages

This option allows you to send plaintext strings over UDP. Some software, such as Medialon Manager, prefers to receive commands in this manner.

UDP messages

Broken Cues

Network cues can become broken for the following reasons:

Invalid network destination.

Assign a valid network destination in the Settings tab of the inspector. You may also need to visit the Network section of Settings and specify a valid destination address and port for the desired patch.

Missing QLab cue number.

Fill in a valid cue number in the Settings tab of the inspector. This is only relevant for Network cues set to the QLab message type.

Invalid command parameters.

Fill in valid parameters in the Settings tab of the inspector. This is only relevant for Network cues set to the QLab message type.

No OSC message specified.

Fill in a valid OSC message in the Settings tab of the inspector. This is only relevant for Network cues set to the OSC message type.

Invalid OSC message.

Fill in a valid OSC message in the Settings tab of the inspector. This is only relevant for Network cues set to the OSC message type.

No UDP message specified.

Fill in a valid UDP string in the Settings tab of the inspector. This is only relevant for Network cues set to the UDP message type.

A license is required to reactivate this saved cue.

You'll need to install a license in order to use this cue.