# OSCReceiver

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

![](https://2803540508-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-L_2-aJC2gpx8goxEoBZ%2F-M8pMT8LskP-_JJk37Cx%2F-M8pN8FpiQOsli--Gcqz%2Fimage.png?alt=media\&token=ec18c565-1111-44a1-b1f8-0a5ad1534c07)

## How To Use

### Configuration

First you need to enable this plugin using the [Settings](https://docs.scenic.tools/guide/views/settings) 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 ](https://docs.scenic.tools/guide/external-configuration)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)

![](https://2803540508-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-L_2-aJC2gpx8goxEoBZ%2F-M8pTORDAP-mHCQ52nW0%2F-M8pUirA0bZ34nR1vOM8%2Fimage.png?alt=media\&token=619e6922-cf31-43dc-86b4-808097a1ccb4)