ComfyUI Node: VideotoTD

VideotoTD:

The VideotoTD node is designed to facilitate the conversion of a series of images into a video format, which is then transmitted to TouchDesigner, a popular visual programming environment. This node is particularly beneficial for AI artists who wish to integrate their image-based creations into dynamic video presentations or installations. By leveraging this node, you can seamlessly encode images into a video stream and broadcast it, allowing for real-time visual experiences. The node's primary function is to encode images using FFmpeg, a powerful multimedia framework, and then send the resulting video to TouchDesigner via a WebSocket connection. This integration enables artists to explore new creative possibilities by combining AI-generated content with interactive and immersive media environments.

VideotoTD Input Parameters:

images

This parameter expects a collection of images that will be converted into a video. The images should be provided in a format that the node can process, such as a tensor. The quality and coherence of the final video heavily depend on the input images, so ensure they are of high quality and properly sequenced.

frame_rate

The frame_rate parameter determines the number of frames displayed per second in the resulting video. It is a floating-point value with a default of 8, a minimum of 1, and increments in steps of 1. A higher frame rate results in smoother motion but requires more images and processing power, while a lower frame rate may produce a choppier video.

quality

This integer parameter controls the quality of the video output, with a default value of 75. It ranges from a minimum of 15 to a maximum of 100, with increments of 1. Higher values yield better video quality but may increase file size and processing time, whereas lower values reduce quality and file size.

broadcast

The broadcast parameter is a boolean that determines whether the video should be sent to all connected clients or a specific one. By default, it is set to False, meaning the video is sent to a specific client. Setting it to True will broadcast the video to all clients, which is useful for collaborative or multi-display setups.

VideotoTD Output Parameters:

None

The VideotoTD node does not produce any direct output parameters. Instead, its primary function is to process the input images into a video and send it to TouchDesigner. The success of this operation is indicated by the absence of errors during execution.

VideotoTD Usage Tips:

• Ensure that the input images are of high quality and properly ordered to achieve the best video output.
• Adjust the frame_rate and quality parameters to balance between video smoothness and file size, depending on your project's requirements.
• Use the broadcast parameter to control whether the video is sent to a single client or multiple clients, based on your setup needs.

VideotoTD Common Errors and Solutions:

Error sending video: <error_message>

• Explanation: This error occurs when there is an issue with sending the video to TouchDesigner, possibly due to network issues or incorrect client configuration.
• Solution: Check your network connection and ensure that TouchDesigner is properly set up to receive the video stream. Verify that the client ID is correct if not broadcasting.