TouchDesigner native plugin (new)

👋

New Augmenta native 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

Available operators

You can find these nodes in the custom operator family.

Node	Description
Augmenta Client	Main Augmenta node DAT connects to the augmenta server and provide all data to the CHOP, TOP and POP operator.
Augmenta Scenes	Select the scene for 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.

TouchDesigner plugin : download TouchDesigner examples : download

Requirements Augmenta 1.5+ TouchDesigner 2025+ Windows support only currently, see legacy plugin for mac

TouchDesigner (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

Download the version according to your architecture.

Copy the 3 folders inside Plugins Folder to Derivative plugin folder located in :

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

Launch demoscene.toe, accept the prompt that pop up when launching TD. This corresponds to the 3 new nodes you will get access.

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

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	speed vector
centroidx centroidy centroidz	centered position

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 tzone 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.

With Notch

You can also use TouchDesigner with Notch ! See the dedicated page 👇

Notch in TouchDesigner with Augmenta