ComfyUI-VACE-Tools

A single ComfyUI node that replaces ~149 manually wired nodes for generating VACE mask and control-frame sequences.

Installation

cd ComfyUI/custom_nodes/
git clone https://github.com/your-user/ComfyUI-VACE-Tools.git

Restart ComfyUI. The node appears under the VACE Tools category.

Node: VACE Mask Generator

Inputs

Input	Type	Default	Description
source_clip	IMAGE	—	Source video frames (B, H, W, C tensor)
mode	ENUM	End Extend	Generation mode (see below)
target_frames	INT	81	Total output frame count for mask and control_frames (1–10000)
split_index	INT	0	Where to split the source. Meaning varies by mode. Unused by Edge/Join.
edge_frames	INT	8	Number of edge frames for Edge and Join modes. Unused by End/Pre/Middle.

Outputs

Output	Description
mask	Black/white frame sequence (target_frames long). Black = keep, White = generate.
control_frames	Source frames composited with grey (#7f7f7f) fill (target_frames long). Fed to VACE as visual reference.
segment_1–segment_4	Clip segments whose contents depend on the mode (see below). Unused segments are 1-frame black placeholders.
frames_to_generate	INT — number of new frames the model needs to produce (the white/grey region).

Mode Reference

All diagrams show the mask and control_frames layout left-to-right (frame 0 → frame N).

---

End Extend

Generate new frames after the source clip.

• split_index — optional trim: 0 keeps the full clip; a negative value (e.g. -16) drops that many frames from the end before extending.
• frames_to_generate = target_frames − source_frames

mask:           [ BLACK × source ][ WHITE × generated ]
control_frames: [ source clip    ][ GREY  × generated ]

Segment	Content
segment_1	Source frames (trimmed if split_index ≠ 0)
segment_2–4	Placeholder

---

Pre Extend

Generate new frames before a reference portion of the source clip.

• split_index — how many frames from the start to keep as the reference tail (e.g. 24).
• frames_to_generate = target_frames − split_index

mask:           [ WHITE × generated ][ BLACK × reference ]
control_frames: [ GREY  × generated ][ reference frames  ]

Segment	Content
segment_1	Remaining frames after the reference (source[split_index:])
segment_2–4	Placeholder

---

Middle Extend

Generate new frames between two halves of the source clip, split at split_index.

• split_index — frame index where the source is split.
• frames_to_generate = target_frames − source_frames

mask:           [ BLACK × part_a ][ WHITE × generated ][ BLACK × part_b ]
control_frames: [ part_a         ][ GREY  × generated ][ part_b         ]

Segment	Content
segment_1	Part A — source[:split_index]
segment_2	Part B — source[split_index:]
segment_3–4	Placeholder

---

Edge Extend

Generate a transition between the end and start of a clip (useful for looping).

• edge_frames — number of frames taken from each edge.
• split_index — unused.
• frames_to_generate = target_frames − (2 × edge_frames)

The end segment is placed first, then the generated gap, then the start segment — so the model learns to connect the clip's end back to its beginning.

mask:           [ BLACK × end_seg ][ WHITE × generated ][ BLACK × start_seg ]
control_frames: [ end_seg         ][ GREY  × generated ][ start_seg         ]

Segment	Content
segment_1	Start edge — source[:edge_frames]
segment_2	Middle remainder — source[edge_frames:−edge_frames]
segment_3	End edge — source[−edge_frames:]
segment_4	Placeholder

---

Join Extend

Heal/blend two halves of a clip together. The source is split in half; edge_frames from each side of the split form the context.

• edge_frames — context frames taken from each side of the midpoint.
• split_index — unused.
• frames_to_generate = target_frames − (2 × edge_frames)

source layout:  [ part_1 ][ part_2 | part_3 ][ part_4 ]
                           ← edge →  ← edge →

mask:           [ BLACK × part_2 ][ WHITE × generated ][ BLACK × part_3 ]
control_frames: [ part_2         ][ GREY  × generated ][ part_3         ]

Segment	Content
segment_1	Part 1 — first half minus its trailing edge
segment_2	Part 2 — trailing edge of first half
segment_3	Part 3 — leading edge of second half
segment_4	Part 4 — second half minus its leading edge

Dependencies

None beyond PyTorch, which is bundled with ComfyUI.