# ComfyUI-TD **ComfyUI-TD** is a **[ComfyUI](https://github.com/comfyanonymous/ComfyUI) to [TouchDesigner](https://derivative.ca/)** custom node for **real-time streaming** of generated data. It supports sending **images**, **videos**, **point clouds** (**traditional PLY** / **Gaussian Splatting PLY**), and **audio** from ComfyUI into TouchDesigner. - - Chinese README: [README_zh.md](README_zh.md) | ![](Image/image.gif) | ![](Image/Video.gif) | |:-------------------------:|:-----------------------------------:| | ![](Image/PointCloud.gif) | ![gaussian.gif](Image/gaussian.gif) | | ![](Image/audio.gif) | ![logo.png](Image/logo.png) | # [🇨🇳 中文 README](README_zh.md) ## User Notice - Some nodes in **ComfyUI-TD** are ported and optimized based on [ComfyUI-Tooling-Nodes](https://github.com/Acly/comfyui-tooling-nodes/tree/main). - **ComfyUI-TD** must be used in conjunction with the **ComfyUI2TD.tox** component (the plugin has been uploaded to the `tox` folder). - Please ensure the **ComfyUI2TD.tox** component is updated to **v_5.1.x** or higher. - This version features a complete code refactor, supporting video and 3D model (point cloud) data transmission. - The WebSocket interface has been rewritten to effectively resolve issues where data (images) might not return properly when using cloud-based ComfyUI under poor network conditions. - Starting from **v_5.1.x**, the **ComfyUI2TD.tox** component's preset workflows use ComfyUI-TD nodes and no longer rely on [ComfyUI-Tooling-Nodes](https://github.com/Acly/comfyui-tooling-nodes/tree/main). - The legacy **ComfyUI2TD.tox** component was developed based on the [TDComfyUI](https://github.com/olegchomp/TDComfyUI) project. Thanks to olegchomp! - If you need to use cloud-based ComfyUI, you can choose [Xiangongyun](https://www.xiangongyun.com/register/YALSMH) servers; the [matching image](https://www.xiangongyun.com/image/detail/5f185465-ef11-42e5-ba21-3ee07acb5403) is ready. --- ## Instructions ### Video Tutorials Please watch the following videos in order (Videos are in Chinese): 1. [ComfyUI2TD_v 5.1 New Version Tutorial *Must Watch* (Bilibili)](https://www.bilibili.com/video/BV1BqQ8YDEJq/?share_source=copy_web&vd_source=3900738a289821efe0ce52f9c9fb663f) 2. [ComfyUI2TD Basic Tutorial (Bilibili)](https://www.bilibili.com/video/BV18t4oeNEgj/?share_source=copy_web&vd_source=3900738a289821efe0ce52f9c9fb663f) 3. [Cloud Deployment ComfyUI Xiangongyun Tutorial (Bilibili)](https://www.bilibili.com/video/BV1RxUyYyEeU/?share_source=copy_web&vd_source=3900738a289821efe0ce52f9c9fb663f) ### Installation #### Method 1: Manager Installation Use [ComfyUI-Manager](https://github.com/ltdrdata/ComfyUI-Manager?tab=readme-ov-file) to search for **ComfyUI-TD** and install it directly. ![Manager nodes](Image/Manager.png) #### Method 2: Manual Installation Download and unzip this project into `X:\ComfyUI_windows_portable\ComfyUI\custom_nodes`. #### Method 3: Git Clone Install using the git command: ```bash cd custom_nodes git clone https://github.com/JiSenHua/ComfyUI-TD.git ``` #### Method 4: Injection Installation In conjunction with the **ComfyUI2TD.tox** component, use the `InjectFile` function to automatically inject nodes into `X:\ComfyUI_windows_portable\ComfyUI\custom_nodes`. --- ## Node Descriptions |

| |:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Hy3DtoTD** | | - This node supports converting GLB models generated by **Hunyuan3D_V2** into point cloud data and returning it to **TD** for parsing, generating the corresponding CHOP component.
- Requires [ComfyUI-Hunyuan3DWrapper](https://github.com/kijai/ComfyUI-Hunyuan3DWrapper) node.
- If you encounter difficulties installing, consider using the cloud [**Xiangongyun** image](https://www.xiangongyun.com/image/detail/5f185465-ef11-42e5-ba21-3ee07acb5403).
- The **ComfyUI2TD.tox** preset workflow **Hunyuan3DV2_PointCloud** provides a basic usage example for this node; the corresponding `.js` workflow file is in the `workflow` folder.
- The latest [ComfyUI-Hunyuan3DWrapper](https://github.com/kijai/ComfyUI-Hunyuan3DWrapper) has changed all model workflows to `trimesh`.
- It is recommended to install [ComfyUI_essentials](https://github.com/cubiq/ComfyUI_essentials) to avoid errors when running preset workflows.
- `broadcast` parameter (default off): When enabled, generated point cloud data will be broadcast to all connected WebSocket clients. | |

| |:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Comfy3DPacktoTD** | | - This node supports converting GLB models generated by **3DPack** into point cloud data and returning it to **TD** for parsing, generating the corresponding CHOP component.
- Requires [ComfyUI-3D-Pack](https://github.com/MrForExample/ComfyUI-3D-Pack) node.
- If you encounter difficulties installing, consider using the cloud [**Xiangongyun** image](https://www.xiangongyun.com/image/detail/5f185465-ef11-42e5-ba21-3ee07acb5403).
- The **ComfyUI2TD.tox** preset workflow **3DPack_xxx_PointCloud** provides a basic usage example for this node; the corresponding `.js` workflow file is in the `workflow` folder.
- **Hunyuan3D_V2** in **3DPack** and **Hunyuan3DWrapper** are not interchangeable; please ensure you use the corresponding transmission node.
- `broadcast` parameter (default off): When enabled, generated point cloud data will be broadcast to all connected WebSocket clients.
- **Note**: Currently, the Xiangongyun cloud image has only been tested with **TRELLIS**, **Hunyuan3D_V2**, **TripoSR**, and **StableFast3D**. Other 3D models have not been verified. Please report any issues in the Issues section. | |

| |:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **3DGStoTD** | | - This node supports returning PLY model data generated by **3DGS** (**Gaussian Splatting**) to **TD** for parsing, thereby generating the corresponding CHOP components.
- Please ensure that the **ComfyUI2TD.tox** component has been updated to **v_5.3.x** or later.
- To use this node, you must install the [ComfyUI-Sharp](https://github.com/PozzettiAndrea/ComfyUI-Sharp) node.
- If you encounter difficulties during installation, you can choose to use the cloud-based [**Xiangongyun** image](https://www.xiangongyun.com/image/detail/b4be23a3-0ce2-41ce-b06e-e9211ca1b31d?r=PYF5ZQ).
- The **3DGS Gaussian Splatting** preset workflow in **ComfyUI2TD.tox** provides a basic usage example for this node. The corresponding `.js` workflow file has been uploaded to the `workflow` folder.
- `broadcast` parameter (default off): When enabled, generated video data will be broadcast to all connected WebSocket clients.
- The preview component for **Gaussian Splatting** in **ComfyUI2TD.tox** was created using **Tim Gerritsen**’s work; special thanks. The plugin can be downloaded via [this link](https://derivative.ca/community-post/asset/gaussian-splatting/69107). | |

Name	Type	Description
IMAGE	IMAGE	—
MASK	MASK	—

LoadTDImage

Inputs (1)

Outputs (2)