OSC

Connect an OSC sender

1. On the SwitchEffect device, open Settings → Automation and turn on Enable OSC.
2. Note the selected UDP port. The default is 49995.
3. Start the switcher. OSC listens while its runtime is running.
4. In your OSC sender, enter the SwitchEffect device’s reachable IPv4 address and that UDP port. Allow local-network access where the OS asks for it.
5. Set a button to send /switcheffect/v1/me/1/cut with no arguments. With your next shot on Preview, pressing it performs a cut.

OSC must be enabled even when a controller knows the IP address. Use a trusted network: OSC is a network control connection, not a pairing-key service like MCP.

Addresses and argument types

Addresses begin with /switcheffect/v1. Most parameterized commands take one OSC string containing name=value&name=value. Send that text as an OSC string, not as separate numeric arguments or an ordinary UDP text packet.

Address:   /switcheffect/v1/me/1/preview/set
Type:      string
Argument:  source=7

source=7 means the numeric input/source ID shown in your switcher’s input configuration. It is not the seventh tile in a multiview. Public M/E, AUX, keyer, media-player, macro-slot, and media-slot numbers are one-based.

Percent-encode reserved characters inside packed values: Evening News can be sent as Evening%20News. A command without parameters normally takes no arguments; supported button commands also accept a press value of 1 or true. Release values of 0 or false are ignored.

Useful controller buttons

Prepare a shot, then take it

/switcheffect/v1/me/1/preview/set
  string: source=7

/switcheffect/v1/me/1/auto
  no arguments

Set Preview first, then trigger Auto when you want to transition. /program/set assigns Program directly; use Cut or Auto when you intend to transition from Preview.

Load a show and run a cue

/switcheffect/v1/run-of-show/load
  string: show=Evening%20News

/switcheffect/v1/run-of-show/cue/run
  string: cue=Welcome

Use unique names for shows, cues, presets, and preset groups. Matching ignores case and normalizes whitespace. Cue lookup uses the loaded show; archived shows cannot be loaded.

Create a presenter title

/switcheffect/v1/run-of-show/title/create
  string: type=lower-third&headline=Rae%20Chang&detail=Host&run=true

The loaded show supplies the title’s saved appearance defaults. Use type=message for a full-screen message. Omit run, or set it to false, to prepare the title without showing it.

Title creation also accepts positional arguments: type string, headline string, optional detail string, optional run value, and optional request-ID string. Use an empty detail string when supplying later arguments without detail.

"lower-third", "Rae Chang", "Host", 1

If your sender retries title creation, supply the same optional UUID request-id for retries of the same request to avoid duplicate titles. Generate a new UUID for a new title request.

Supported commands

Every suffix below follows /switcheffect/v1. Parameters shown with = are packed into one OSC string. Names and numbers in examples are illustrative; replace them for your switcher.

Navigate the app

Use /app/section/set with a section identifier below. A destination must be available in your switcher and not hidden in the app. Camera Control and Telestrator require a running switcher.

For /control-panel/page/set, convert the page’s name to lowercase and replace spaces with dashes. For example, Main Controls becomes page=main-controls. Use unique names that resolve to a single page.

Limits and troubleshooting

The current OSC service accepts individual messages. OSC bundles and wildcard address patterns are not supported. Positional arguments are limited to routes that explicitly support them; other parameterized routes use a packed string. M/E commands currently target /me/1.

There is no OSC reply channel. A sent packet is not confirmation that a command succeeded. Watch the app’s state and controller/service status, and use diagnostics when investigating a rejected command.

• No response: check the device IP, UDP port, network access, Enable OSC, and whether the switcher is running.
• Wrong input: use the configured numeric source ID, not its display position.
• Named item rejected: check for duplicate names, an archived show, or a cue outside the loaded show.
• Blocked control: check feature availability and Settings → Automation → Allowed in View Only → OSC.