VRChat OSC Trigger icon

VRChat OSC Trigger

Listens for incoming OSC (Open Sound Control) messages via UDP

VRChat OSC Trigger

AI-generated

Summary

Listen for OSC messages over UDP and emit matching messages as n8n items. Optionally forward incoming OSC packets to another UDP host and port.

Inputs

  • Listen Port — UDP port to listen on; defaults to 9001.
  • Filter Mode — Choose all messages, the exact /avatar/change address, avatar parameter addresses, or a custom address pattern. Defaults to all messages.
  • Parameter Filter — For Avatar Parameters mode, match the parameter name using * as a wildcard; defaults to *.
  • Address Pattern — For Custom Address mode, match the complete OSC address; * matches any sequence of characters. Defaults to /avatar/parameters/*.
  • Enable Forwarding — When enabled, forward incoming UDP packets to the configured target; defaults to off.
  • Forward Target Host — Destination host for forwarding; defaults to 127.0.0.1.
  • Forward Target Port — Destination UDP port for forwarding; defaults to 9002.
  • Forward Mode — Forward all raw packets, or only packets containing messages that pass the selected filter. Defaults to Forward All.

Output shape

Emits one n8n item per matching OSC message, including each message in a bundle.

Each item contains json.address, json.args, json.timestamp (Unix time in milliseconds), and json.source with the sender's address and port. OSC blob arguments are returned as base64 strings. Forwarding sends the original UDP packet, including bundles; in Forward Filtered mode, a packet is sent if any contained message passes the filter.

Examples

Example 1: Send VRChat avatar updates to a workflow

Listen on port 9001, select Avatar Parameters, and set Parameter Filter to VRCEmote or another parameter name or wildcard.

Example 2: Listen for a specific OSC address

Select Custom Address and enter a pattern such as /chatbox/input or /avatar/parameters/*Face*.

Example 3: Share OSC traffic with another consumer

Enable forwarding, set the destination host and UDP port, and choose whether to forward all packets or only packets whose messages pass the filter.

Links

Discussion