Nodes/ComfyUI-Koolook/Easy Image Batch (Koolook)
ComfyUI Node

Easy Image Batch (Koolook)

A ComfyUI node in Koolook/Image with 18 inputs and 4 outputs.

By malkuthro·Created 11 months ago·Updated 23 days ago· 7
Easy Image Batch (Koolook)
  • keyframes_insert
  • keyframe_batch
  • source_batch
  • image1
  • image2
  • image3
  • image4
  • image_batch
  • alpha_batch
  • selected_image_batch
  • selected_frames
total_frames81
cut_start_frame1
placeholder_colorBlack
invert_alphafalse
source_frames
image1_frame5
image2_frame9
image3_frame13
image4_frame17
width512
height512
CategoryKoolook/Image

Inputs (18)

NameTypeDefaultDescription
total_framesINT811–1024Length of the output cut window in frames.
cut_start_frameINT11–999999First VFX frame represented by output index 0. All frame numbers are 1-based.
placeholder_colorCOMBOBlackFill color for empty frames in image_batch. Alpha output is controlled separately.
invert_alphaBOOLEANfalseOff: selected frames are black/0 and empty frames are white/1. On: selected frames are white/1 for compositing.
source_framesSTRINGOptional 1-based VFX frame list to pick from source_batch (in insert mode, the destination positions). Separators: commas, spaces, tabs, or newlines. Inclusive ranges like 14-17 expand to 14,15,16,17.
image1_frameINT51–9999991-based VFX frame number for image1; the connected image is placed here on top (no effect when the slot is unwired).
keyframes_insertoptIMAGEConnect a packed sequence of frames to INSERT them onto the timeline at the positions from the frame list (source_frames): 1st frame -> 1st number, 2nd -> 2nd, ... Connected image1-4 still composite on top of the inserts. The background depends on source_batch: if source_batch is NOT connected, the gaps are filled with placeholder_color (offset/reconstruct mode); if source_batch IS connected, the inserts are composited over the source frames in the cut window (insert-over-source mode). With an empty frame list and no slots nothing is placed: a clean placeholder batch (no source_batch) or a clean source-batch passthrough (with source_batch).
keyframe_batchoptIMAGEDeprecated alias for keyframes_insert (the input was renamed before release). Use keyframes_insert; this alias keeps pre-rename workflows loading. Ignored when keyframes_insert is also connected.
source_batchoptIMAGE
image1optIMAGE
image2optIMAGE
image2_frameoptINT91–9999991-based VFX frame number for image2; the connected image is placed here on top (no effect when the slot is unwired).
image3optIMAGE
image3_frameoptINT131–9999991-based VFX frame number for image3; the connected image is placed here on top (no effect when the slot is unwired).
image4optIMAGE
image4_frameoptINT171–9999991-based VFX frame number for image4; the connected image is placed here on top (no effect when the slot is unwired).
widthoptINT5121–8192Fallback output width. Used ONLY when no image input provides dimensions (e.g. a fully empty node producing a clean placeholder batch). Ignored whenever an image source is connected.
heightoptINT5121–8192Fallback output height. Used ONLY when no image input provides dimensions (e.g. a fully empty node producing a clean placeholder batch). Ignored whenever an image source is connected.

Outputs (4)

NameTypeDescription
image_batchIMAGE
alpha_batchMASK
selected_image_batchIMAGE
selected_framesSTRING