Be sure to also check out:
- Our Knowledgebase article on the subject of controlling QLab with Isadora using OSC
- More information about QLab's OSC capabilities
- QLab's OSC Dictionary
Using OSC (Open Sound Control) messages, you can easily trigger cues in Isadora from QLab. Just follow the instructions below.
Setup the QLab Settings:
- Click the Gear icon at the bottom right of the workspace to open the Settings window
- Click "Network" at the left to open the "Network Cue Destination Patches"
- In an empty patch enter a name of "Isadora".
- If Isadora is running on the same computer as QLab, leave the destination set to "localhost". If it is running on a remote computer, you will need to enter the IP address of that computer on the network, e.g., 192.168.0.10. (In Isadora, you can see the current IP address by opening Isadora's preferences. The IP address is shown at the bottom left of the window.)
- Make sure to set the port after the IP address to 1234. The result should look something like this:
- Click "Done" to close the Settings Window.
Add QLab Network Cues
- Click the Network button above the Cue List to create a new Network cue.
- Double click the cue to give it a name, e.g,. "Isadora Cue 1"
- With the new Network cue still selected, click the "Settings" tab at the bottom.
- Enter a valid Isadora OSC address and an argument. The OSC addresses /isadora/1 through /isadora/99 are built in to Isadora, so it's probably easiest to use /isadora/1. (Note that it is a small "i" – this won't work if you use Isadora!)
- You must also add an argument after the address. You don't have to use this value, but Isadora won't see the trigger if there is not some argument after the address. You'll see in a moment how this value appears in Isadora
Here's an example cue with the address /isadora/1 and the argument set to 1.
We added a second cue with the address /isadora/1 and an argument of 2.
Add an OSC Listener in Isadora:
- In the currently active Scene, add an OSC Listener actor.
- The OSC Listener has an input called "channel". This corresponds to the number in the OSC address used in QLab. If you used /isadora/1 in the QLab Network cue, then you should leave this set to 1. If you had used /isadora/37 in QLab, then you'd need to set this input to 37.
- Isadora is now ready to receive a cue from QLab
Test Connection Between Isadora and QLab:
- Arrange your screens so that you can see both QLab and Isadora.
- Fire the network cue in QLab.
- If the connection is successful, the trigger output should fire, briefly changing from a '-' to an 'X'.
- In addition, the argument value specified in QLab will appear at the 'value' output of the OSC listener when the cue is fired.
Get Aural Confirmation that the Connection is Working:
- Add a Speak Text actor next to the OSC Listener
- Set the 'text' input of Speak Text to "got it"
- Connect the 'trigger' output of the OSC Listener to the Speak Text's trigger input.
- Now each time a message is received, Isadora should say "got it" ;-)
Use the Trigger to Jump to the Next Scene
- Add a Jump actor next to the OSC Listener
- Connect the 'trigger' output of the OSC Listener to the Jump actor's trigger input.
- If you would like a crossfade to the next scene, enter the number of seconds into the 'fade' input of the Jump actor.