# Enabling OSC in MixEffect

Activating OSC support is a three-step process.

1. Enable OSC support in MixEffect.
2. Configuring the OSC server for each switcher in MixEffect.
3. Setting up your OSC-capable device to communicate with MixEffect.

### **Enable OSC Support**

This turns on OSC support throughout all of MixEffect.

1. Tap **Settings** (gear icon) from the **MixEffect Home**.
2. Tap **Automations**.
3. Tap **Enable OSC**.

### Enable OSC Server and Port for a Switcher

Each switcher connection can have its own OSC server. For instance, if you use MixEffect with an ATEM Mini Pro and an ATEM Extreme, you can have both respond to OSC calls when running MixEffect in Split View on an iPad.

> **IMPORTANT**: If you plan to run MixEffect with multiple switchers at the same time, it is recommended to specify a unique port number for each switcher.

1. From the **MixEffect Home**, tap on a switcher.
2. Tap **Edit**.
3. Change the **OSC Port** number. Choose a number over 40000 and less than 65535 to ensure no conflicts with other ports. The default is 49990.
4. Tap **Save**.
5. Tap **Enable OSC Server** to start the server.

The OSC server is now configured and active for your switcher.

<div><figure><img src="https://3777554060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MaiI5oKYEXGU01L5yjC%2Fuploads%2FG85F9ASS3YLibdVFoEIq%2Fenabling-osc-1-230.png?alt=media&#x26;token=eb39cb5a-48e4-483d-97a4-8d8c2011fbf2" alt=""><figcaption></figcaption></figure> <figure><img src="https://3777554060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MaiI5oKYEXGU01L5yjC%2Fuploads%2FWNztpkJiozNeyvl5JXxi%2Fenabling-osc-2-230.png?alt=media&#x26;token=084676ae-3387-45e2-ab63-986e8f5bfd26" alt=""><figcaption></figcaption></figure></div>

### Determining your iOS Device's IP address

In MixEffect version 1.4.0, the current list of IP addresses assigned to your device will be listed next to the OSC Port number in the Switcher Connection detail page. You can also find the IP address or addresses listed in MixEffect Settings > Automation next to the Enable OSC toggle.

You can also find the IP address of your device by following these steps:

1. Go to the Home screen.
2. Tap **Settings**.
3. Tap either **Wi-Fi** or **Ethernet**, depending on which network your device and the ATEM switcher are connected to.
4. Tap the **i** button.
5. Copy the **IP Address** and enter it into your OSC client like Companion.

![](https://3777554060-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MaiI5oKYEXGU01L5yjC%2Fuploads%2FqyEMw3tNwY0TXwcefcFP%2Fimage.png?alt=media\&token=42766662-5ad3-4b1d-8126-ee99164b0f60)

OSC commands will be interpreted **only** when MixEffect is in the foreground of your iOS device.

MixEffect OSC server listens on the port you specified for your switcher. Make sure you have configured your OSC clients to send commands to MixEffect on the correct port.

> **NOTE**: If the OSC server does not appear to respond, try disabling and enabling the server from the Switcher Detail page.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mixeffect.app/automate/osc/enabling-osc-in-mixeffect.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
