# TouchOSC

TouchOSC is an app that provides wireless input and output.

You can get it here:

{% embed url="https://hexler.net/products/touchosc" %}

## Step 1: Set Up TouchDesigner to Get OSC Input

Open TouchDesigner and press TAB to pull up the OP Create Dialog. Under the green CHOP tab, search for and select OSCin. Click to place.

![](https://4077345522-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MFloEXqUun2rk6R28rU%2F-MMIPw9Kbnl8slF5H_Ir%2F-MMIR05vPB8Xudc9wfpk%2Fimage.png?alt=media\&token=b1a56e30-4c7e-4de0-a1a9-2cd03fe0f231)

In your parameters, click the arrow to the right of the field for Local Address and select the first option.

![](https://4077345522-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MFloEXqUun2rk6R28rU%2F-MMIPw9Kbnl8slF5H_Ir%2F-MMIRLQvmqyKjgb8jgkI%2Fimage.png?alt=media\&token=16263c10-7ec5-4d5a-a195-331bc019c67e)

{% hint style="info" %}
If you do not see the parameters, press the P key to toggle it on.
{% endhint %}

## Step 2: Set Up TouchOSC

Open the app and tap "OSC" to access the communication options. Note: You might have "Not configured" the first time you use the app instead of an IP address.

![](https://4077345522-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MFloEXqUun2rk6R28rU%2F-MMIPw9Kbnl8slF5H_Ir%2F-MMIStnUyauEvZbI1abB%2Fimage.png?alt=media\&token=dd66d293-f009-46c3-b047-73686f7e8626)

Type in the IP address (local address) show in the TouchDesigner OSCin CHOP's parameters.

Set the outgoing port to a number (doesn't really matter) that does not match the incoming port number.

![](https://4077345522-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MFloEXqUun2rk6R28rU%2F-MMIPw9Kbnl8slF5H_Ir%2F-MMIT_QosMjcBPHAjsRB%2Fimage.png?alt=media\&token=916991f8-aefb-40ce-93da-1699e7e06d18)

In TouchDesigner, change the Network Port to match the outgoing port in TouchOSC.

![](https://4077345522-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MFloEXqUun2rk6R28rU%2F-MMIPw9Kbnl8slF5H_Ir%2F-MMIUGEPPxIo35oigwpd%2Fimage.png?alt=media\&token=22c30644-8e7d-4bcf-83d6-7d63e14b4f7b)

Go back to the settings menu in TouchOSC.

Tap "TouchOSC Bridge" to bring up more settings.

Put "localhost" as the host if it is not automatically filled in.

![](https://4077345522-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MFloEXqUun2rk6R28rU%2F-MMIPw9Kbnl8slF5H_Ir%2F-MMITrPwzYRZc-Ou28ku%2Fimage.png?alt=media\&token=c6c8f850-8cfe-4f9a-bcd7-fc77c68f65a4)

Go back to the settings menu and tap "Done."

If everything is working, you should now see values in TouchDesigner that change when you rotate your phone:

![](https://4077345522-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MFloEXqUun2rk6R28rU%2F-MMIPw9Kbnl8slF5H_Ir%2F-MMIUay4ZURWIE9yKmtm%2Fimage.png?alt=media\&token=2eedf101-1f15-4534-9840-30b7aadefb6d)

## Step 3: Using TouchOSC

The default channels are data from the accelerometer in your phone.

TouchOSC also has interfaces! The channels for each part of the interface will appear once you use them.

Example:

![How the first interface looks with changed values.](https://4077345522-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MFloEXqUun2rk6R28rU%2F-MMIPw9Kbnl8slF5H_Ir%2F-MMIVWmuQP1Yfz1MO5NP%2Fimage.png?alt=media\&token=261d0ff2-3844-414f-8ffc-d3777435a151)

![How these changes are reflected in TouchDesigner.](https://4077345522-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MFloEXqUun2rk6R28rU%2F-MMIPw9Kbnl8slF5H_Ir%2F-MMIVOz3teIuEn-32UeL%2Fimage.png?alt=media\&token=06069a38-dc12-461b-bb9d-e00e29bd5a26)

Once you have these channels appearing in the OSCin CHOP, use a green Select CHOP to choose one or more of the channels.

Once you connect the Select CHOP, use the arrow to the right of the Channel Names field to select the channels you want to include.

![](https://4077345522-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-MFloEXqUun2rk6R28rU%2F-MMIPw9Kbnl8slF5H_Ir%2F-MMIWDGGv7r6H6pz7ATh%2Fimage.png?alt=media\&token=8e151858-251f-43c1-91cd-32b8ea7c89b5)

After that, you can use the value in the Select CHOP to affect other nodes, meaning you can control nodes (color, sound, distortion amount, etc.) with your cell phone!
