Manual / How To
How to integrate with data consumers
Data consumers are the lighting consoles, audio engines, and media servers that receive OpenFollow's tracking. This guide covers which OpenFollow protocol to choose per system, where to enable receive on the destination, the exact OSC message template if applicable, and known caveats. Products with a dedicated recipe have their own subpage. Pair this guide with Output Protocols for the protocol overview and OSC Transmitters for the placeholder, trigger, and templating reference.
Lighting consoles
| Product | Protocols |
|---|---|
| MA Lighting grandMA2 | PSN (native). Requires a patched Stage Marker. |
| MA Lighting grandMA3 | PSN (native). OSC for other commands like moving executor faders. |
| ETC Eos (3.3+) | OSC for Augment3D Position |
| ETC Hog 5 | PSN |
| ChamSys MagicQ | PSN (native). Requires Y/Z Swap and PSN Function Normal PSN 1. |
| LightStrike | PSN, OTP, or OSC |
Production tools
| Product | Protocols |
|---|---|
| Vor | PSN, OTP, or OSC |
Audio
| Product | Protocol |
|---|---|
| QLab 5 | OSC (port 53000) |
| ADM-OSC compatible engines | OSC (built-in 2D / 3D templates) |
| d&b Soundscape | OSC (built-in template) |
Media servers
Most media servers accept either PSN or OSC. As a rule of thumb:
- Use PSN when you want continuous position tracking and the server supports it natively (Disguise, Hippotizer, etc.).
- Use OSC when you want event-style triggering (zone enter / Hotkey / button press) or when the server expects a custom address scheme.
For OSC, build a transmitter the same way as the Eos recipe. Address and arg syntax depends on the server – consult its OSC reference.
Console macros via gamepad / keyboard
Beyond continuous position data, OpenFollow can fire one-shot OSC messages on operator input. Common recipes:
- Hotkey → Eos macro.
Trigger: Hotkey [Space], press Address: /eos/macro/901/fire - Gamepad button → Hog comment macro.
Trigger: Controller button BACK, press Address: /hog/hardware/macro Args: 12 - Keyboard → MA3 executor go.
Trigger: Hotkey [G], press Address: /Go Args: "Exec 1"
None of these require a continuous PSN feed; they coexist with whatever streaming output you already have configured. See OSC Transmitters → Hotkey and Controller button for the full trigger reference.