Drive StreamDiffusionTD
drive_streamdiffusionInstalls and configures a StreamDiffusion node in TouchDesigner, connecting a video source, setting generation parameters, and outputting the result via Syphon/Spout or NDI.
Instructions
Wraps the community StreamDiffusionTD.tox (by dotsimulate) into a one-shot Layer 1 setup: locate the .tox via candidate-path discovery, drop it into a fresh baseCOMP, wire a camera/source TOP into its input, set the prompt/strength/cfg/seed custom pars, and optionally re-broadcast the output via Syphon/Spout or NDI. Returns a friendly error when the .tox is not installed. The result envelope includes validated_pars so downstream tools (create_ai_mirror) know which SD pars to bind a control panel to.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tox_path | No | Optional explicit absolute or project-relative override. When set, becomes the only candidate; standard discovery is skipped. | |
| source_top_path | No | File system path to a video/image file to feed into the StreamDiffusionTD container (creates a moviefileinTOP). When omitted, a synthetic noise TOP is created for device-free preview. | |
| prompt | No | Sets the Prompt custom par on the tox. | a vibrant neon cyberpunk portrait, ultra detailed |
| strength | No | img2img denoising strength — sets Strength par. | |
| cfg | No | Classifier-free guidance scale. Low CFG (1–2) is normal for StreamDiffusion/LCM. | |
| seed | No | Random seed. -1 = random per tox convention. | |
| controlnet_weight | No | Sets Controlnetweight when the par is present in the tox build. | |
| t_index | No | Sets Tindex (denoise step list index) when present; omitted = tox default. | |
| output_mode | No | internal = Null TOP only. syphon_spout / ndi = adds an FM-01 sender wired from out1. | internal |
| output_name | No | Sender/source name when output_mode != 'internal'. | tdmcp_streamdiffusion |
| parent_path | No | Parent network for the fresh streamdiffusion_driver baseCOMP. | /project1 |
| expose_controls | No | Reserved for v2 — the tox already surfaces its own UI; this field is accepted but not acted on in v1. |