ComfyUI_toyxyz_test_nodes

ComfyUI_toyxyz_test_nodes

This is a custom node that collects the tools I use frequently.

https://github.com/toyxyz/ComfyUI_toyxyz_test_nodes/assets/8006000/8536e96a-514a-48b2-b1aa-8eccbd3fa853

(This video is at 4x speed)

Update

2026/08/25 Add Minimax-H3-prompter node

2026/04/18 Add Draw area mask, ComfyCouple Region multi, Crop area mask node

2026/04/16 - Add Anima support to ComfyCouple Region node

2025/10/30 - Add lora hook support to ComfyCouple Region node

2025/10/21 - Add Openpose Editor Node, Pose Interpolation, ComfyCouple Region, ComfyCouple Mask, Comfy Couple Region Extractor

2025/03/10 - Add Visual area mask node

2024/11/14 - Add Load Random Text From File node

2024/11/04 - Add Export glb node.

2024/11/02 - Add remove noise node for normal map. Added sobel ratio for more accurate Noraml.

2024/10/25 - Add depth to normal node.

2024/08/11 - Add Direct_screenCap node.

2023/11/24 - AddSave image to path node. Add Render preview, Add export video, Add face detection (After the update, you will need to run CaptrueCam/setup.bat one more time.)

2023/11/29 - Add Region Capture. Made the Webcam app UI smaller.

2023/12/01 - Add Ai render overlay

Installation

1. Git clone this repo to the ComfyUI/custom_nodes path.

   git clone https://github.com/toyxyz/ComfyUI_toyxyz_test_nodes

2. Run setup.bat in ComfyUI/custom_nodes/ComfyUI_toyxyz_test_nodes/CaptureCam

Usage

Default workflow (Workflow embedded)

Render preview workflow (Workflow embedded)

Direct Webcam capture workflow (without webcam app) (Workflow embedded)

Minimax-H3-prompter

Builds MiniMax H3 audiovisual prompts from a Shot/Move timeline and optional image, video, and audio references. It generates prompts, not the final AI video.

<img width="2618" height="1571" alt="image" src="https://github.com/user-attachments/assets/ceea6c19-1233-458e-a502-303a13a80115" />

Quick start

1. Choose a model, mode, and duration. Auto selects the mode from your references. Use 5–15 seconds as a practical starting range; the displayed frame count is H3-aligned.
2. Enter the subject, action, setting, and any camera instructions in Prompt. + Shot starts a new take; + Move continues the same Shot without a cut. Drag timeline boundaries to adjust timing.
3. Optionally set Visual style and Camera style for the selected Shot/Move. Visual style controls appearance; Camera style adds handling such as handheld or stabilized movement, without replacing the requested path or speed.
4. Configure Camera Advanced, then select Generate Prompt. Enhance defaults to Normal: None is concise, Normal expands the request, and Strong produces a longer, richer description. Stop cancels generation.
5. Connect generated_prompt and length to your H3 workflow. Enable Auto Run to generate the prompt when ComfyUI executes the node.

Camera and prompt display

Camera options are saved per Shot/Move. Shot size, Shot viewpoint (External, OTS, OTH, POV), and Subject framing control coverage. Camera level sets lens height independently of Angle; Ground + Level view looks horizontally at foot height. Direction chooses the destination, Orbit route chooses the route, Camera roll rotates the frame, and Composition places the target within the image.

Movement range and Speed are qualitative prompt instructions, not preview speed or distance controls. Motion presets apply to a Shot when its following Moves have camera disabled. Disabled intervals hold the preceding state unless user camera text requests otherwise.

Explicit user camera instructions take priority over panel defaults and camera style. The system describes connected physical paths between Move endpoints. The mannequin preview is representative: it does not solve the real scene, user-written targets, or handheld shake, and cannot guarantee the generated video's framing or continuity.

The display dropdown and Copy use the same text area:

• Generated prompt: the latest generated result.
• Raw prompt: system and user input; after generation, includes the actual reference analysis.
• Camera prompt: procedural camera timeline before Qwen applies user-text overrides.

References and models

Modes: T2VA (text), I2VA (first frame), FL2VA (first/last frames), L2VA (last frame), and REF2VA (reference generation/editing).

• Image: First frame, Last frame, Frame, or Subject. Drag Frame anchors to exact timeline positions; first/last anchors stay fixed. Use reference strength for subject retention.
• Video: select editing, continuation, or motion/action timing. Move and trim clips on the timeline; only the visible source interval is used. For motion transfer, identify source-to-target mappings in Prompt, e.g. “red figure = the woman; blue figure = the man.” Motion references include camera behavior but do not copy source appearance or scenery.
• Audio: select the intended reuse role. Loading a video alone does not request audio reuse.

Use aliases with @. Reference order must match downstream H3 slots. Outputs include image_N, frame_N, video_N, and audio_N as applicable.

Qwen3.8 27B supports all modes and Normal/Strong expansion. Each Qwen task reuses one llama-server for reference analysis and final writing, then releases it on completion, cancellation, or failure. Text-only tasks do not load the vision projector. Analysis and writing use separate requests, without accumulating the full image conversation in the final writing context. MiniMax H3 Rewriter Omni supports all modes with its own expansion behavior. Missing models require download confirmation; a managed llama.cpp runtime is installed on first use. Qwen runs with a 16,384-token context shared by input and output: many timeline items or reference analyses can exceed it. Check the execution log for download progress, context warnings, and reference-mapping errors.

Optional camera render

Camera render adds a camera_render IMAGE batch of the preview scene at 1024×1024, 24 fps for the full timeline. Connect it to Save Image or a video combine node. It writes no files itself and uses roughly 1.5 GiB RAM per five seconds. This is a panel-geometry render, not the final AI video; text-only motion, camera style, and Qwen-resolved targets are not simulated.

Cut Video

Trims a ComfyUI VIDEO with one signed frame count while keeping its embedded audio aligned.

• frame_count: positive values keep that many frames from the beginning; negative values keep that many frames from the end (-1 returns only the final frame and -22 returns the final 22 frames); 0 keeps the complete connected media
• invert: when enabled, a positive value excludes that many frames from the beginning and a negative value excludes that many frames from the end
• video: required source VIDEO, including its embedded audio and frame-rate metadata
• outputs: trimmed video, images, audio, and the original input fps, in that order

VIDEO FPS is preserved. The image and audio outputs are extracted from the same selected VIDEO interval. If the absolute frame_count exceeds available frames, the complete source is returned without padding.

Connect Video

Connects two compatible ComfyUI VIDEO inputs into one longer VIDEO. video_1 plays first and video_2 follows it. Both videos must have matching FPS and frame dimensions. Embedded audio is joined in the same order; when only one input contains audio, silence is inserted for the other video so synchronization is preserved. Set smooth_transition above 0 to overlap that many ending frames of video_1 with the opening frames of video_2. During the overlap, video and audio from video_1 fade from 100% to 0% while video_2 fades in. A value of 0 performs a direct join.

Visual area mask

Creates masks for the specified regions. Useful for regional prompting.

Image_width: Specify the width of the mask

Image_height: Specify the height of the mask

area_number: Specify the number of areas to create. Maximum 12.

area_id : Area number to adjust. Starts from 0.

x : X position of the area selected in area_id.

y : Y position of the area selected in area_id.

width : Width of the area selected in area_id.

height: Height of the selected area at area_id.

strength: Strength of the selected area at area_id.

mask_overlap_method: default, subtract - Subtracts the masks from other regions from a single mask.

Update outputs: Update nodes according to the number in area_number.

<img width="1576" height="1591" alt="image" src="https://github.com/user-attachments/assets/dcc54f06-7d5c-4a2c-844c-11f8ec8088ae" />

Draw area mask

Create a mask for regional prompting. Use Ctrl + click to select an area, and Alt + click to remove it.

<img width="1697" height="1526" alt="image" src="https://github.com/user-attachments/assets/7c570775-5ae8-4eea-bb56-67164a0c1f69" />

Openpose Editor Node

Modify each body part of OpenPose

<img width="2140" height="1800" alt="image" src="https://github.com/user-attachments/assets/c54a6c62-a8aa-4418-a8b7-6bd65d5cce82" />

Pose Interpolation

Generate interpolated poses between two OpenPose poses.

<img width="2408" height="1558" alt="image" src="https://github.com/user-attachments/assets/c76ae523-d09b-4d2a-b21f-447c76fdf36e" />

ComfyCouple Region / ComfyCouple Mask

Regional Prompting Node. Supported models are SD 1.5, SDXL, and Flux, Anima. To disable Auto_inject_flux, you must free the model cache. To use Lora_hook, set skip_positive_conditioning to false. If you connect the ComfyCouple Base Prompt and ComfyCouple Background Prompt to the ComfyCouple Region, they will function as the base prompt and the background prompt.

<img width="3442" height="1324" alt="image" src="https://github.com/user-attachments/assets/1186f43e-4599-4aaa-8f89-6a38eac1fcc1" />

Comfy Couple Region Extractor

Cut out the masked region from the couple region. It can be used in the face detailing workflow.

<img width="2505" height="1667" alt="image" src="https://github.com/user-attachments/assets/5b8871f0-24db-46e8-b69a-4c0e8aa844cf" />

Load Random Text From File

Retrieves the entire text or random lines from a txt file at the entered path.

file_paht : The path to the text file or the path where the files are located

seed : seed for random line

edit_text : Edit tag_(tag) to tag (tag)

get_random_line : Get random line from txt. False for get entire text

get_random_txt_from_path : Randomly use one of all text files located in the entered path instead of one text file.

strength : Adjust the strength of the prompt.

ban_tag : Prompts to exclude.

text : Multi-line text as an alternative to text files

use_index : Gets text from the line corresponding to index instead of a random line.

index : The index of the line.

Export glb

Export a flat .glb file with a color image, normal map, and alpha mask.

You can specify the roughness, metallic, and save path.

Remove noise

guided_first : Apply guided filter first.

Remove noise from an image. Can be used to clean a normal map.

bilateral_loop: The number of times to apply the bilateralFilter. If 0, it is not used.

d/sigma_color/sigma_space : bilateralFilter parameters

guided_loop: The number of iterations of the guidedFilter. If 0, it is not used.

radius/eps: guidedFilter parameters.

Depth to normal

Converts a depth image to a normal map. It works very well with 2D images and DepthAnything v2.

depth_min : Depths lower than this value are replaced with 0.

blue_depth : Adjusts the intensity of the blue channel of the normal map to emphasize depth. The lower this number, the stronger the depth.

sobel_ratio : Makes the Normal map more stereoscopically accurate. Values between 0.1 and 0.3 are recommended.

Direct_screenCap

Captures an image from a specified window or screen.

capture_mode Default : Capture a defined area of the monitor window : Captures the area of the window entered in target_window window_crop : Same as window, but cuts off and captures the area relative to that window.

target_window : Name of the window to capture. You can find its name in the list of windows in the Webcam app.

Load Webcam Image

Load an image from a path.

To use this node with webcam, you must first run run.bat in ComfyUI/custom_nodes/ComfyUI_toyxyz_test_nodes/CaptureCam.

And in the Webcam app, you'll need to select your webcam and run capture with start.

Capture Webcam

Captures an image directly from the webcam selected with 'select_webcam'. (Usually 0)

This is unstable compared to the Load Webcam Image node.

If you're using obs, I recommend using the Load Webcam Image node.

Save image to path

This node saves the generated images to a defined folder path.

Set name to choose the base file name. In the Save method, images are saved without overwriting existing files by appending a number such as comfyui_000001.png. In Overwrite mode, an existing image with the same name is replaced.

Connect the MASK output from ComfyUI's Load Image node to preserve transparency when saving RGBA PNG images.

Connect or enter optional text to save a .txt file with the same name and folder as the saved image.

Load image from path

This node loads an image from a folder path by zero-based index. If index is larger than the number of images, it loads the last image. It outputs the image, mask, and selected image file name without extension.

LatentDelay

Set the delay between image generation.

ImageResize_Padding

Resizes the image while maintaining its proportions and painting the margins with the color you specify.

Webcam app

This script captures the selected webcam and saves it as an image file in real-time.

You can specify the resolution, format, and path of the image to be saved.

If you don't enter a path, it will be saved to the default path.

You can combine a sequence of saved images into a video using the Export button. Set the Save Image to Path save method to Save so each frame gets a unique numbered file name.

To use AI Render, you need a Save Image to Path node.

If you entered a location other than the default path in Save Image to Path, you must select a newly created render image in Select Rendered image.

Run_hide_cmd.vbs : Hide the cmd and run the app.

Webcam : List of camera devices connected to your computer

Width: Sets the width of the image.

Height: Sets the height of the image.

If either the width or height is zero, it will be automatically adjusted to fit the other values entered.

FPS : Set how often the capture occurs. If you enter 0, it is unlimited.

Webcam(Checkbox) : Preview the captured image.

Al Render: Preview the generated image in ComfyUi.

Always on top : Webcam, AI Render is always visible on top. To disable it, you need to close the preview window.

Face detect : Automatically recognize faces and generate masks. It is stored as face_mask.jpg. Use with inpainting.

Keep aspect ratio : Correct the aspect ratio of the image and the capture window.

Capture Path: The path where the captured image will be saved.

Render image: Path to the image generated by ComfyUI. Required to use AI Render.

If you don't enter a path, the default path is used.

Save format: Set the image format to be saved

Overlay alhpa : The alpha value of the overlay image displayed above the region capture window.

Padding: Set how to fill the margins of the image when using Keep aspect ratio.

Export video: Combines the image sequences located in the render image folder into a single video. Enter the desired FPS value.

Clear after export: Deletes the image sequence after the video is exported.

Add region window: Creates a window to specify the region to capture.

The name of the window is the same as entered in Save name. If you enter comma-separated text (e.g., A,B,C), you can use one Region window to capture three images, A, B, and C, alternating between them.

Save name: Set a name for the captured image.

Window list: Select the windows to capture. Other windows will not be captured. If set to Disable, it will be captured as it is displayed on the screen. Window capture is often unstable depending on the program. Be careful when using it.

Reload list: Refresh the list of webcams and windows.

The name of the currently captured and saved image file and the selected Region window are displayed in the Webcam/Ai Render preview window.

If you select 'Region Capture' from the Webcam list, it will capture the region of the window added with 'Add Region window'. If you select 'Window Capture', it will capture the entire window selected in the window list.

https://github.com/toyxyz/ComfyUI_toyxyz_test_nodes/assets/8006000/8723e014-caa5-4e16-8c8c-5c5edac6f141

Hotkeys :

S: Saves the image displayed in the current AI render to the render folder. Activate (click) the AI render window and then use it.

F : Toggles the Region widow (target window list selected) to full window mode. Select the target Region window and then click Use.

A : Select the Region window currently being captured. Enable the AI render or Webcam preview window, then use it.

C: Change the region window. Select the desired Region window and press the key to switch to that window. When used in the Ai Render or Webcam window, the Region windows are switched in the order they were created.

X: If the Region windows were created separated by commas, pressing the key while Ai Render or Webcam is active will switch the name of the captured image.

Q: Copy the image displayed in AI render to the clipboard. Activate AI render and then use.

M: Mask paint toggle. Allows you to paint the mask directly in the Webcam preview window. Paint with the left mouse and erase with the right. You can change the brush size with the mouse wheel. The mask is saved as the captured image name + '_mask'.

N: Erase all painted masks.

Z: Pause image capture. Use for Webcam or AI Render.

P: Displays the AI Render image as an overlay on the currently selected Region window. This is unstable and should be used with caution. It can only be enabled/disabled when capture is stopped and requires a target window to be set. Does not run even if there is no render image to load.

Render preview

Load the image file saved with the Save image to path node. Pressing 'Q' while the window is active will copy the preview image to the clipboard.

Face detection

Detect faces and create masks. Use it for inpainting with the Load Webcam Image node.

Note

The ControlNet preprocessor slows down the process, so I recommend using other tools to prepare the ControlNet image.

If you want ComfyUI to run continuously, use Auto Queue.

For maximum speed, set the VAE to taesd.