> For the complete documentation index, see [llms.txt](https://docs.scenic.tools/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.scenic.tools/plugins/oscreceiver.md).

# OSCReceiver

This plugin provides you with the means to handle incoming OSC messages using extra Blocks.

![](/files/-M8pN8FpiQOsli--Gcqz)

## How To Use

### Configuration

First you need to enable this plugin using the [Settings](/guide/views/settings.md) menu.

Right after enabling the plugin, Schéma starts listening for OSC messages.

The default configuration is:

* IP (local bind address): **0.0.0.0**
* Port: **4444**
* Enabled: **true**

Use the [JSON configuration ](/guide/external-configuration.md)files to change these settings. Using *Enabled: false* will disable receiving while keeping the blocks available you. The settings format is available below:

```
{
    "OSCReceiver": {
        "IP": "0.0.0.0",
        "Port": 4444,
        "Enabled": true
    }
}
```

### Blocks

Once you have everything configured to your liking, it's time to bring out the Blocks.

{% hint style="warning" %}
"/" characters in OSC addresses are automatically replaced with "." to keep with Schéma's naming conventions.
{% endhint %}

You can enter addresses manually (with . instead of /) or more conveniently select it from the list. Whenever Schéma receives an OSC message, its address will be appended to the selection list.

#### Source.Value.OSC

Receives a float value at the specified address (*Name*).

*Default* specifies the value that is generated before the message is received for the first time.

#### Source.Value.OSCReceived

Bangs upon receiving any OSC message at the specified address (*Name*).

Turning *Simulate* on will generate a value bang.

## Examples

Trigger flashes using [Orca](https://hundredrabbits.itch.io/orca)

![](/files/-M8pUirA0bZ34nR1vOM8)