TouchDesigner Native Plugin (New !)

👋

A new Augmenta plugin for TouchDesigner, designed to receive data from Augmenta's WebSocket output. It supports:

Tracking features (cluster IDs, positions, bounding boxes, speed, etc.)

Point cloud streaming

Zone triggering and control

TouchDesigner plugin : download TouchDesigner examples : download

Requirements Augmenta 1.5+ TouchDesigner 2025+ Windows support only currently. For MacOS, see the legacy plugin:

TouchDesigner OSC Plugin (legacy)

Install

Install the Microsoft Visual C++ Redistributable packages 2022 : https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170

Copy the downloaded files into your Derivative plugin folder located in :

C:\Users\"your-username"\Documents\Derivative\Plugins

When first starting TouchDesigner, you’ll need to accept a few prompts notifying you of the new available Ops.

Copy Augmenta.tox to your palette C:\Users\"your-username"\Documents\Derivative\Palette to have access to the Augmenta base in all your projects.

Setup

TouchDesigner : Enter the Augmenta IP address and port in the augmentaDAT. If you are using the simulator or on the same machine you can enter 127.0.0.1

Adding the IP of the Augmenta server in TouchDesigner

Augmenta : Create a WebSocket output ( Setup → Sources & Outputs → Output → Generic → Websocket )

Adding a Websocket server output in Augmenta

How to use

Available operators

You can find these nodes in the custom operator family.

Node	Description
Augmenta Client	Augmenta Entry Point Connects to the augmenta server and provides data to the other operators.
Augmenta Scenes	Select the scene from which you want to receive data.
Augmenta Clusters	Dynamic array of clusters
Augmenta Zones	Dynamic array of zones
Augmenta Zones	Zones infos : Slider / Pad XY / Presence / Enters / Leaves
Augmenta Point POP	Stream the point cloud from clusters/scenes/zones.
Augmenta Point TOP	Stream the point cloud from clusters/scenes/zones.

Tracking

Cluster Data : IDs, positions, bounding boxes, speed, etc.

Item	Description
id	tracking cluster ID
tx, ty, tz	cluster transform
rx, ry, rz	rotation
sx, sy, sz	cluster size
centroidx centroidy centroidz	centroid of the cluster’s points

Pointclouds / Volumetric

You can receive the point clouds from clusters, scenes or zones. To do this, enter the corresponding Augmenta DAT.

With POP

With TOP (instancing)

Zone triggering and control

You can retrieve zone information from the DAT by enabling "Show Events", or alternatively access only the specific data you need directly from the Augmenta CHOP.

In the example, to visualize the slider, we multiply the size of the zone by the padXY values in order to instantiate it. If you need a precise value for a slider, we recommend using the Augmenta Chop Zone Event operator. You have access to:

Sliders

Pad XY

Presence

Enters

Leaves

Scene

Get scene data. It represents your interactive zone. It is the white box in geometry view.