> ## Documentation Index
> Fetch the complete documentation index at: https://xrlive.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# OSC Integration

> Control xRLive from external show-control systems via OSC

OSC (Open Sound Control) lets you trigger xRLive presets remotely from a lighting console, media server, or any OSC-capable software — hands-free during a show. Each saved preset exposes an OSC address that loads it instantly when the message arrives.

## Set the OSC port

The OSC port is configured in [Network Setup](/launcher/devices/network-setup). Set it to the port used by the console or software that will send the OSC messages, so both ends match.

## Preset OSC addresses

Every preset you save has an OSC address built from the visual and preset names:

```
/xrlive/[visualname]/[presetname]
```

* **`[visualname]`** — the visual's name as shown on its card.
* **`[presetname]`** — the preset's name that you saved.

xRLive **normalizes** both parts automatically: it **removes spaces** and converts them to **lowercase**. This keeps the address predictable and avoids typos.

For example, a preset named **Blue Sparks** on the visual **Magic particles** becomes:

```
/xrlive/magicparticles/bluesparks
```

| In xRLive                                           | OSC address                         |
| --------------------------------------------------- | ----------------------------------- |
| Visual **Magic particles** → preset **Blue Sparks** | `/xrlive/magicparticles/bluesparks` |
| Visual **Motion Tracking** → preset **Intro**       | `/xrlive/motiontracking/intro`      |

## Triggering a preset

Send an OSC message to the preset's address from your console or software, and xRLive loads that preset immediately — the same as clicking it in the preset bar.

<Note>
  The preset must already be saved for the visual. Presets are created in the operator dashboard — see [Presets](/launcher/visuals/presets).
</Note>