UDP Message Target
UDP Message Target properties for Script Engine. Sends short text messages over UDP, either as raw datagrams or wrapped in OSC (Open Sound Control). Useful for triggering scenes in MadMapper and other VJ tools, controlling stage lighting consoles over OSC, signalling automation systems on a local network, sending cuepoint markers to recording or replay devices, or integrating with show-control software that expects UDP triggers. Messages are fire-and-forget — UDP does not confirm delivery.
| Property | Type | Access | Description |
|---|---|---|---|
Address |
string |
get/set |
IPv4 address of the device to send to. Use the unicast address of a single device (for example 192.168.1.50), a subnet broadcast address (for example 192.168.1.255) or a multicast address. 127.0.0.1 targets a UDP listener on the same machine. |
Port |
int |
get/set |
UDP port the receiving device is listening on. [min=1024, max=65535]. Common defaults: 8000–9000 for OSC, 6454 for Art-Net, 8010 for MadMapper. Check the receiver's documentation for the expected port. |
UdpProtocol |
Protocol |
get/set |
How the message is wrapped on the wire. Pick OSC when targeting MadMapper, lighting consoles or any device that speaks Open Sound Control. Pick UDP for raw text datagrams to custom listeners that just want the bytes as-is. |
Message |
string |
get/set |
The text payload to send. For OSC, this is typically an address path such as /cues/MyBank/scenes/by_cell/col_1. For raw UDP, send whatever string the receiver expects. Setting this from the Script Engine and then triggering SendMessageCommand lets a script send dynamic cuepoints during a show. |
SendMessageCommand |
Command |
get |
Sends the current Message to Address:Port using the selected UdpProtocol. Each invocation sends one datagram. There is no acknowledgement, so if the receiver is offline the call still appears to succeed. |
MiniLog |
FormattedMessage |
get/set |
Latest status or error message from the target (read-only, debug). Shows when the last message was sent or what went wrong if it could not be sent. |
Inherits from: AbstractTarget.
See also: UDP Message Target in Targets — user-facing introduction, screenshots, and section summaries.