# Streaming Mocap Data into TouchDesigner

[**TouchDesigner**](https://derivative.ca/) is a node-based real-time creation tool developed by Derivative. It is widely used for interactive media, live performances, and exhibitions, allowing creators to quickly build real-time graphics and integrate external systems.

With MOVIN TRACIN and MOVIN Studio, you can stream motion capture data directly into TouchDesigner in real time, enabling to drive visual effects, lighting, and sound using human motion as triggers, making it ideal for live performances and interactive content.

You can also find instructions on streaming motion data and point clouds from MOVIN Studio to TouchDesigner in [**the official TouchDesigner documentation**](https://derivative.ca/UserGuide/Movin3D).

{% stepper %}
{% step %}

### Add an OSC CHOP in TouchDesigner

<figure><img src="https://935889915-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpjitYtIcckwQaYBZMIj0%2Fuploads%2FdI8FHcKiRbQFnli16eGi%2Fimage.png?alt=media&#x26;token=439e6cd7-8658-4dac-9d8c-514a9289b244" alt=""><figcaption></figcaption></figure>

* In your TouchDesigner project, right click in the network editor and select Add Operator.&#x20;
* From the CHOP tab, choose OSC In to add an OSC in CHOP.
* Set the Network Port to 11237&#x20;
  {% endstep %}

{% step %}

### Add a NULL CHOP&#x20;

<figure><img src="https://935889915-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpjitYtIcckwQaYBZMIj0%2Fuploads%2FGFzdjNIqylCp8I3wsYcw%2Fimage.png?alt=media&#x26;token=e181b662-dc55-4809-be47-f72da688fa18" alt=""><figcaption></figcaption></figure>

* Right click again in the TouchDesigner Project and select Add Operator.&#x20;
* From the CHOP tab, choose NULL to add a NULL CHOP.
* Connect the OSC In CHOP you created earlier to the NULL CHOP. [#add-an-osc-chop-in-touchdesigner](#add-an-osc-chop-in-touchdesigner "mention")
* In the Common tab of the NULL CHOP settings, set the Export Method to 'Channel Name is Path:Parameter'.&#x20;
  {% endstep %}

{% step %}

### Import the Same Character in MOVIN Studio and TouchDesigner

<figure><img src="https://935889915-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpjitYtIcckwQaYBZMIj0%2Fuploads%2FbW1wcItuxBFlnD35499w%2Fimage.png?alt=media&#x26;token=13b9967e-0d64-4865-8f95-ce1e74dd1a87" alt="" width="375"><figcaption></figcaption></figure>

* Import the FBX character file you want to use into TouchDesigner.

<figure><img src="https://935889915-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpjitYtIcckwQaYBZMIj0%2Fuploads%2FscePeiWuIl4OTqRtmSBV%2Fimage.png?alt=media&#x26;token=35dffe2e-cf8e-4ed1-ba6b-d5ff091ad0e9" alt="" width="375"><figcaption></figcaption></figure>

* Then, import the same FBX character file into MOVIN Studio.
  * For details on how to import a character, please refer to [import-custom-character](https://help.movin3d.com/movin-studio-usage-guide/import-custom-character "mention")
* **Make sure that the Node Name set in TouchDesigner matches the character Name configured in MOVIN Studio.**&#x20;

{% hint style="warning" %}
If the character name in MOVIN Studio does not match the node name in TouchDesigner,\
live streaming may not work correctly.
{% endhint %}
{% endstep %}

{% step %}

### Start Streaming from MOVIN Studio to TouchDesigner

<figure><img src="https://935889915-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpjitYtIcckwQaYBZMIj0%2Fuploads%2F1u6gi1GzEax3sZpKDpua%2Fimage.png?alt=media&#x26;token=41c22d0e-47f3-4c54-834e-7aff165ef94c" alt=""><figcaption></figcaption></figure>

* Check that the **port number** set in TouchDesigner matches the **port number** configured in **MOVIN Studio**.
* Click the 'Start streaming' Button.
  {% endstep %}

{% step %}

### Enable Export option on the NULL CHOP

<figure><img src="https://935889915-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpjitYtIcckwQaYBZMIj0%2Fuploads%2FTDlzvovHRE4iXY0uvS55%2Fimage.png?alt=media&#x26;token=5970ada1-6568-4750-907b-ffd5beb9b5ce" alt=""><figcaption></figcaption></figure>

* In the TouchDesigner project, enable the Export option by clicking the green circular icon located at the bottom right of the NULL CHOP.

<figure><img src="https://935889915-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpjitYtIcckwQaYBZMIj0%2Fuploads%2FkWlDkS8WhbEshQOsWZMH%2Fimage.png?alt=media&#x26;token=eacb3d8b-6b3a-4392-8261-19d992b41499" alt=""><figcaption></figcaption></figure>

* Once enabled, you will see a gray dotted line connecting the NULL CHOP to the character, indicating that motion data from MOVIN Studio is being streamed to the character in real time.&#x20;
  {% endstep %}
  {% endstepper %}

* On the [MOVIN's official page](https://www.movin3d.com/downloads#movin-studio) , you can download a sample project with all of the steps above already applied. We recommend opening this project to check the setup and learn how it works.

<figure><img src="https://935889915-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpjitYtIcckwQaYBZMIj0%2Fuploads%2FL615tMgFvQ822dmz8227%2Fimage.png?alt=media&#x26;token=a1a2465d-8874-40f9-ab7b-41ee79d17e3a" alt="" width="563"><figcaption></figcaption></figure>


---

# 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://help.movin3d.com/movin-studio-usage-guide/live-streaming/streaming-mocap-data-into-touchdesigner.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.