OSC GrandMA Integration

CueCollab integrates with both grandMA3 and grandMA2 to automatically use the current cue as the scene name. grandMA3 is natively supported via OSC output, while grandMA2 requires a Lua plugin and has some limitations.

A wired Ethernet connection is recommended for reliability.

grandMA3

grandMA3 has native OSC output support, making integration with CueCollab straightforward.

Setup

1. Make sure your console is on the same network as the CueCollab server and can reach it on the configured UDP port.

2. In grandMA3, go to Settings > In & Out > OSC and enable Output (Global).

3. Add a new OSC data line with the following settings:

   Setting	Value
   Name	CueCollab
   Destination IP	IP address of the CueCollab server
   Mode	UDP
   Port	Configured OSC port (usually 3333)
   Prefix	grandma3
   Send	Yes
   Send Command	Yes

If the console does not send OSC messages - particularly when CueCollab and grandMA3 onPC are running on the same machine - make sure CueCollab is started before grandMA3, or try disabling and re-enabling OSC output in the grandMA3 settings.

---

grandMA2

grandMA2 does not have native OSC output support. CueCollab provides a Lua plugin that runs on the console and sends OSC messages to the CueCollab server.

Installation

1. Make sure your console is on the same network as the CueCollab server and can reach it on the configured UDP port.

2. Download the CueCollabSceneUpdater Lua plugin and extract the archive.
   Download link: grandma2-cuecollabsceneupdater-v1.0.zip

3. Copy both the .lua and .xml plugin files to the grandMA2 plugins folder on the console or the connected file system. The exact path may vary, but common locations include:

   C:\ProgramData\MA Lighting Technologies\grandma\gma2_V_3.X.X\plugins
   D:\gma2\plugins

4. In grandMA2, open the Plugins window (Empty Screen > System > Plugins), edit an empty slot, select Import, and load the CueCollabSceneUpdater plugin from the plugins folder.

5. Set CUECOLLAB_OSC_HOST to the IP address of the CueCollab server.
   Optionally, adjust CUECOLLAB_OSC_PORT if you are using a non-default port:

   local CUECOLLAB_OSC_HOST = "192.168.1.100"
   local CUECOLLAB_OSC_PORT = 3333

6. Save the plugin and run it. It will continuously send the current cue name to CueCollab as the scene name.

Limitations

• The plugin must be running for the integration to work. If the console is restarted, the plugin may need to be started again manually.
• The plugin only observes the currently selected executor for the active cue. If cues are triggered from multiple executors, only the cue from the observed executor will be sent to CueCollab.
• The plugin runs as the user who started it, but session changes can transfer execution to master. It is strongly recommended to always run the plugin as master to avoid issues during session changes.