Nodes/ComfyUI-VideoHelperSuite/Load Images (Upload) πŸŽ₯πŸ…₯πŸ…—πŸ…’
ComfyUI Node Runs on cloud

Load Images (Upload) πŸŽ₯πŸ…₯πŸ…—πŸ…’

Upload a folder of frames as an image batch

By KosinkadinkΒ·Created 3 years agoΒ·Updated 3 months agoΒ· 1,727
Load Images (Upload) πŸŽ₯πŸ…₯πŸ…—πŸ…’
  • meta_batch
  • IMAGE
  • MASK
  • frame_count
β—„directoryβ–Ύβ–Ί
β—„image_load_cap0β–Ί
β—„skip_first_images0β–Ί
β—„select_every_nth1β–Ί

This is the upload-button version of Load Images. It reads a whole subfolder of images from ComfyUI's input directory, in order, and hands them over as one IMAGE batch - the same thing a video loader produces, just sourced from a folder of stills instead of a movie file. Use it when you have a render sequence, exported frames, or an image set you want to push through one pass together. It's from Kosinkadink's VideoHelperSuite, the standard video-I/O pack, and there's a "choose folder to upload" button so you can drop a whole directory in from the browser.

The practical use is exactly what you'd guess: batch a folder of frames through an upscale or ControlNet pass, then send the result to Video Combine to rebuild the video. Because it loads from ComfyUI's own input folder rather than an arbitrary path, it's the version that works cleanly on hosted and cloud setups where filesystem paths are locked down.

How it works

You upload a folder; it lands under ComfyUI's input directory and appears in the directory dropdown. On load, VHS filters to real image files - jpg, png, ppm, bmp, tif, webp - sorts them by filename, and batches them. Filename order is sequence order, so zero-pad your numbers.

The inputs and outputs that matter

directory is the dropdown of uploaded subfolders, with the upload button beside it. The optional knobs:

  • image_load_cap - max images loaded (batch size). 0 loads everything; cap it for large folders.
  • skip_first_images - skip this many from the front, so you can walk a long sequence in chunks by incrementing it.
  • select_every_nth - keep 1 of every N images to thin a dense set.

There's also an optional meta_batch for wiring in a Meta Batch Manager on very large sequences.

Outputs: IMAGE, MASK (alpha if present), and frame_count.

How to install it

ComfyUI Manager: search ComfyUI-VideoHelperSuite, install, restart. Or:

cd ComfyUI/custom_nodes
git clone https://github.com/Kosinkadink/ComfyUI-VideoHelperSuite

then restart. No weights to download.

Common issues & troubleshooting

Frames out of order. String sorting puts img_10 before img_2. Zero-pad the filenames (img_0002) before uploading.

My folder isn't in the dropdown. Refresh the node or reload the page after uploading - ComfyUI rescans input on refresh. Also confirm you uploaded a folder of images, not loose files at the input root.

Loaded fewer than expected. image_load_cap may be set, or the folder holds non-image files that got filtered.

Big folder crashes ComfyUI. Cap image_load_cap, and for sequences too long to fit in RAM, connect a Meta Batch Manager to process them in slices.

CategoryVideo Helper Suite πŸŽ₯πŸ…₯πŸ…—πŸ…’

Inputs (5)

NameTypeDefaultDescription
directoryCOMBO1 options: 3d
image_load_capoptINT00–9007199254740991β€”
skip_first_imagesoptINT00–9007199254740991β€”
select_every_nthoptINT11–9007199254740991β€”
meta_batchoptVHS_BatchManagerβ€”

Outputs (3)

NameTypeDescription
IMAGEIMAGEβ€”
MASKMASKβ€”
frame_countINTβ€”