OpenFollow Preview

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

ProductProtocols
MA Lighting grandMA2PSN (native). Requires a patched Stage Marker.
MA Lighting grandMA3PSN (native). OSC for other commands like moving executor faders.
ETC Eos (3.3+)OSC for Augment3D Position
ETC Hog 5PSN
ChamSys MagicQPSN (native). Requires Y/Z Swap and PSN Function Normal PSN 1.
LightStrikePSN, OTP, or OSC

Production tools

ProductProtocols
VorPSN, OTP, or OSC

Audio

ProductProtocol
QLab 5OSC (port 53000)
ADM-OSC compatible enginesOSC (built-in 2D / 3D templates)
d&b SoundscapeOSC (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.