OpenFollow Preview

Manual / Show Control

Output Protocols

OpenFollow can broadcast marker positions on multiple protocols simultaneously. PSN, OTP, and RTTrPM each have a single global configuration; OSC is composed of as many independent OSC Transmitters as you need, each with its own destination, message template, and trigger.

PSN – PosiStageNet

Multicast UDP. Configured under Output → PSN Output.

FieldMeaningDefault
PSN System NameName advertised to receivers (info packet, sent at 1 fps). Read-only here; it is the station name, set under General → Station Settings.OpenFollow <adjective>-<animal> (generated on first boot)
PSN Multicast IPPSN multicast group. Change only for a non-standard group.236.10.10.10
Network InterfaceRead-only; shows the interface PSN is sent from (Auto-detect unless pinned). Set under General → Network Interface Assignment; PSN follows the Station default row. Shown in Advanced network mode only.Auto-detect

PSN broadcasts every controlled marker at 60 fps for data packets and 1 fps for info packets, on the standard PSN port 56565. Marker IDs are integers ≥ 1; ID 0 is reserved as "ignored" on the wire. There is no per-marker enable/disable – to silence a marker, remove it from the controlled markers. On managed switches, PSN multicast needs IGMP snooping with a querier on the VLAN.

Alongside position, each tracker carries its speed as a vector – the direction and rate the marker is actually travelling, reading zero when it stops – a timestamp, and a validity flag that clears until the marker has a position. A station that receives PSN from another OpenFollow passes that sender's timestamp, status, and speed through unchanged, and derives speed from successive positions when a sender publishes none.

Tracker Status

Each tracker carries a status from 0.0 to 1.0:

  • Person detection off, or AI Assisted – 1.0.
  • Fully Automatic – how much detection vouches for the position. A sighting at the Detection sensitivity threshold reads 0.5, a perfect score 1.0. If the person is lost or video stops, it fades to 0.0 across the Grace period and stays there.
  • Stale – 0.0 when this station has not updated the marker for one second.

The timestamp stops advancing when the marker stops being updated. grandMA3 colours a tracker by packet arrival, not by status.

OTP – Object Transform Protocol

Multicast UDP transform-oriented protocol per ANSI E1.59. Configured under Output → OTP Output. Currently experimental.

FieldMeaningDefault
OTP outputMaster toggle (Send marker positions over OTP).Off
System NumberOTP system, 1–200. Sets the multicast addresses.1
Multicast addressesRead-only: Transform carries positions, Advertisement carries discovery.239.159.1.1 / 239.159.2.1
UDP Port1–65535.5568
Priority0–200. Receivers prefer the source with the higher value.100
Source InterfaceRead-only; the interface OTP leaves from, set under General → Network Interface Assignment. Advanced network mode only. A pinned interface that is down stops OTP until it returns.–

Multicast addresses are derived from System Number per E1.59 §15.19: transform packets go to 239.159.1.<system>, advertisements to 239.159.2.1. Change System Number to put OTP on a different group.

OTP point numbers map 1:1 to OpenFollow marker IDs: marker 1 appears as OTP point 1.

RTTrPM – Real-Time Tracking Protocol (Module)

Unicast UDP, used by some immersive audio engines. Configured under Output → RTTrPM Output. Experimental – the section appears only while RTTrPM output is ticked under General → Station Settings → Advanced Settings → Features.

FieldMeaningDefault
RTTrPM outputMaster toggle (Send marker positions over RTTrPM).Off
Destination HostIP address or hostname of the receiver.127.0.0.1
UDP Port1–65535.36700
Send Rate (FPS)Packets per second, 1–240.60
Context32-bit integer (0–4294967295) in every packet, to tell this station's stream apart at a shared receiver.0
Source InterfaceRead-only; set under General → Network Interface Assignment. Advanced network mode only. A pinned interface that is down stops RTTrPM.–

OSC – Open Sound Control

OSC drives media servers, audio engines, show control, and OSC-capable lighting consoles. Instead of a single global address scheme, OpenFollow composes any number of independent OSC Transmitters, each with its own destination, message template, and trigger.

Destinations (host, port, protocol, framing) are defined under Output → OSC Destinations; transmitters under Output → OSC Transmitters. Five built-in templates are available: ETC Eos, ETC Eos (User 99), ADM-OSC 2D, ADM-OSC 3D and d&b absolute.

Full reference: OSC Transmitters.