OSC - Open Sound Control
CuePoints can be controlled by incoming OSC messages
Configuring Incoming OSC
Accessible via CuePoints > Open Sound Control (OSC)…
- Select the network adapter on which you wish to receive OSC messages. The IP range of this adapter must be configured to match the IP range of the OSC message sender. eg 192.168.0.XX This can be set within System preferences > Network - Make sure Configure IPv4 is set to “Manually”. Set a subnet mask (a safe bet is 255.0.0.0) Loopback IPs are not currently supported.
- OSC Port, this should match exactly with the sending device. The default is 8000.
- Start Listening - must be pressed to enable network traffic.
- Received OSC messages on the network will be displayed in the Message Log.
Implemented OSC Messages
The full list of messages can also be found within the OSC window and these can be clicked to copy the string. CuePoints receives OSC strings only as specified below, variables & arguments are not currently implemented.
Streamdeck / Companion
Bitfocus Companion is an open source software which enables Streamdeck to send OSC commands, amongst other protocols. You don't need an actual Streamdeck to use it, Companion comes with a built-in Streamdeck emulator - a webpage for touch screens - it does the same job, just without the physical buttons.
Installing Companion
Download Bitfocus Companion here: https://bitfocus.io/companion
- When you open Companion, a server window will open. From the opening screen, choose your network interface. If the Companion machine is the same machine as CuePoints machine then simply select the network adapter as configured above. If the companion machine is a separate, the selected network adapter must be configured to match the IP range of the CuePoints machine. eg 192.168.0.XX
- Press Launch GUI
Adding the OSC Connection
From the Connections tab, you can add and configure the OSC connection.
- Add a new device, through a search add Generic OSC.
- Set the Target IP - This is the network adapter IP set within the CuePoints OSC Window - eg 192.168.0.XX
- Set the Target Port - this should match the CuePoints specified port, the default is 8000.
- Press save to add the connection.
Adding the CuePoints Template
In the Buttons tab, you can configure the buttons for your Stream Deck.
- Download the CuePoints Companion template here: https://cuepoints.com/download/
- Goto the Import / Export tab on the right.
- Press import and select the downloaded companionconfig file.
Controlling CuePoints
Web Buttons or Elementor windows can be used to test connection or use companion without a Streamdeck.
Companion software may need a restart to see a Streamdeck, if plugged in after starting the application. Once plugged in, the Streamdeck should display the buttons as configured in Companion.
GrandMA3
GrandMA3 supports OSC Messages, which allows CuePoints playback to be controlled directly from the console. A set of pre-defined macros containing all available CuePoints strings is available for download.
Configuring MA3 to send OSC to CuePoints:
- Press
Menu > Network > My Interfaces(top right), Change an adapter to same IP range and subnet as the CuePoints selected OSC network adapter. - Press
Menu > In & Out > OSC, Select the configured adapter as above, Check your preferred IP matches the IP range and subnet eg 192.0.0.0/8 - Enable Output & make sure you have an active session.
- Assign the following details to OSC line 1:
Name - CuePoints (Optional)
Destination IP - This is the network adapter IP set within the CuePoints OSC Window.
Mode - UDP (default)
Port - this should match the CuePoints specified port, the default is 8000.
Send - Yes
Send Command - Yes
Installing MA3 OSC Macros:
Download CuePoints MA3 Macros here: https://cuepoints.com/download/
- Add the downloaded macro file to a drive: grandMA3/gma3_library/datapools/macros
- Within MA3 Press
Menu > Import/Export, Tap Macros in the Data Pools Column - Select a “CuePointsOSCMacros” from the drive library
- Press Import.
Macros are simply pressed to send the OSC message. They also work well when assigned to encoders for Previous / Next CuePoint skipping functionality. The macros templates all reference OSC line 1, although macros can be easily customised. For example simply Edit the skip macro and customise the number of seconds.
← Previous
Next →