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.
| Field | Meaning | Default |
|---|---|---|
| PSN System Name | Name 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 IP | PSN multicast group. Change only for a non-standard group. | 236.10.10.10 |
| Network Interface | Read-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 score1.0. If the person is lost or video stops, it fades to0.0across the Grace period and stays there. - Stale –
0.0when 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.
| Field | Meaning | Default |
|---|---|---|
| OTP output | Master toggle (Send marker positions over OTP). | Off |
| System Number | OTP system, 1–200. Sets the multicast addresses. | 1 |
| Multicast addresses | Read-only: Transform carries positions, Advertisement carries discovery. | 239.159.1.1 / 239.159.2.1 |
| UDP Port | 1–65535. | 5568 |
| Priority | 0–200. Receivers prefer the source with the higher value. | 100 |
| Source Interface | Read-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.
| Field | Meaning | Default |
|---|---|---|
| RTTrPM output | Master toggle (Send marker positions over RTTrPM). | Off |
| Destination Host | IP address or hostname of the receiver. | 127.0.0.1 |
| UDP Port | 1–65535. | 36700 |
| Send Rate (FPS) | Packets per second, 1–240. | 60 |
| Context | 32-bit integer (0–4294967295) in every packet, to tell this station's stream apart at a shared receiver. | 0 |
| Source Interface | Read-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.