OSC

Updated: 4 Dec 2023

Introduction #

Notch allows you to send and receive simple OSC data over the network for interacting with your project. When running as standalone, you can also control the play head remotely.

Receiving OSC #

Setting up your project to receive OSC. #

1. Open the Project Settings via menu Project -> Settings
   1. In the OSC pane
   2. Check the box: OSC Enabled
   3. Enter the network UDP port number that the OSC data is to be received on
2. Click OK

Notch will listen to network traffic on all network adapters, using the specified port number.

To check you are receiving data with this network configuration:

1. Open the Connection Monitor pane with View -> Connection Monitor
2. The pane will show you how many packets of data have been received on the listening OSC port in real time

Only one process/Block can use a specific port number at a time. Either consolidate your effects into a single Block OR use different port numbers for each Block.

Using received OSC data #

You can manipulate numeric and text string values in the nodegraph by utilising two nodes:

• OSC Modifier for numeric values
• OSC Text for text string values

If you wish to use OSC values in your JavaScript scripts, then setup a receiving node (as above) and read the value from the node using GetFloat()

The incoming OSC values will only be processed when the play head is playing

Sending OSC #

Setting up your project to send OSC #

1. Open the Project Settings via menu Project -> Settings
2. In the OSC pane
   1. Check the box: OSC Enabled
   2. Enter the network UDP port number that the OSC data should be transmitted on
   3. Enter the Target IP address that OSC data should be transmitted to
3. Click OK

The receiving and transmitting OSC port is the same

Sending OSC data from Notch #

You can send numeric values (as floats) over the network using the OSC Output node.

The outgoing OSC values will only be sent when the play head is playing

OSC Transport Control #

When running as standalone you can remotely control the play head via OSC.

Setting up your project to receive OSC Transport Commands #

1. Open the Project Settings via menu Project -> Settings
2. In the OSC pane
   1. Check the box: OSC Enabled
   2. Check the box: Transport Enabled
   3. Enter the network UDP port number that the OSC data is to be received on
3. Click OK

To check you are receiving data with this network configuration:

1. Open the Connection Monitor pane with View -> Connection Monitor
2. The pane will show you how many packets of data have been received on the listening OSC port in real time

OSC Transport commands have no effect in Builder. They only work in an exported Standalone.

OSC Transport Commands #

Layer switching via OSC will not work when Keyboard Transport is enabled (for Standalone).