OpenFollow Preview

Manual / Operating

Operator Messages

A station can show short text messages – typically the operator's next cue – as cards on the Operator Screen, pushed in over OSC by a console or show-control system. They use the same receiver as OSC Input, so that receiver must be Enabled for any message to arrive.

Configured in the web UI under Input → Operator Messages. Off by default.

Settings

  • Enabled – master toggle. When off, incoming messages are ignored and nothing is drawn on the Operator Screen.
  • Placement – where the stack of cards appears: Bottom-center or Top-center.
  • Max visible – how many cards show at once, 1–20 (default 5). Anything beyond this collapses into a single +N more line so the overlay never overruns the screen.
  • Route by marker – on by default. A marker-keyed message shows only on the station controlling that marker. Turn it off to show every message on every station regardless of marker. A broadcast message always reaches every station either way.
  • Scale – uniformly enlarges the cards and their text: , 1.25×, 1.5×, 1.75×, or (default ). Card width stays capped at 60% of the screen, so long lines wrap rather than overrun at the larger sizes.

Sending a message

Send to the /message address with up to four positional arguments (OSC type tags ssif). The OSC Dictionary carries the same reference alongside every other inbound OSC address:

/message  <message>  <info>  <markerId>  <seconds>
ArgumentTypeMeaning
messagestringThe main line of text.
infostringOptional second line (e.g. a cue number). Defaults to empty.
markerIdintegerRouting target (see below). Defaults to 0.
secondsfloatAuto-dismiss after this many seconds. 0 keeps the card until it is cleared. Defaults to 0.

Trailing arguments are optional and fill in left to right. The numbers are read leniently – markerId / seconds may arrive as a numeric string ("3", "8.0") or the other numeric type – but a numeric argument that can't be read at all drops the whole message.

Routing by marker

  • 0 – broadcast. Shown on every station. Broadcast cards have no title bar.
  • 1 or higher – marker-routed. Shown only on the station currently controlling that marker; every other station drops it. The card gets a solid title bar in the marker's colour with the marker name on it.

This lets one sender address "whoever is on Marker 3" without knowing which physical station that is. Turn off Route by marker to ignore this and show every message on every station.

Clearing

/message/clear            clears all messages
/message/clear  <id>       clears messages for marker <id>

You can also bind a key or gamepad button under the Input tab to clear the messages on this station – see Gamepad, Keyboard & OSC.

Transport

Messages travel over the receiver configured in OSC Input – unicast straight to a station, subnet broadcast, or the Multicast group set there to reach every station at once.