Image List Loader (Soze)

There's a real difference in ComfyUI between an image batch (one tensor, N images stacked, all processed together as a block) and an image list (N separate items, each one flowing through the graph on its own). Some nodes want the first, some want the second, and mixing them up is a common source of confusing errors. Image List Loader loads a whole folder as the second kind - a genuine LIST output - which is what you want when downstream nodes need to process each image individually rather than as a stacked batch.

How it works

Point it at a folder, tell it which files to grab with a glob-style filter, and pick a sort order. It loads everything matching and returns all of it as a single list-typed Images output - ComfyUI then fans that list out to whatever's connected next, running once per item if the downstream nodes support list inputs, the way a for loop would.

The inputs and outputs that matter

• folder_path - required. The directory to scan.
• file_filter - required, default *.png. A glob pattern, not a regex - swap the extension for *.jpg, or widen it if your folder mixes formats.
• sort_method - required, dropdown: numerical (default) or alphabetical. Numerical matters if your files are named like img1.png, img2.png, ... img10.png - alphabetical sort would put img10 before img2, which numerical sort avoids.
• Output: Images - an IMAGE output, but flagged as a list, not a batch. Feed it into nodes built to handle list inputs; if you actually want a stacked batch tensor instead, this isn't the node for that (look at the pack's other folder loaders, which load one image per index and are meant to be driven by ComfyUI's queue count instead).

How to install it

Via ComfyUI Manager - search "Quality of Life Nodes for ComfyUI" or "Soze" - or manually:

cd ComfyUI/custom_nodes
git clone https://github.com/SozeInc/ComfyUI_Soze.git
pip install -r ComfyUI_Soze/requirements.txt

Restart afterward. No models, no GPU dependency beyond whatever your downstream image nodes already need.

Common issues & troubleshooting

Downstream nodes complain about receiving a list instead of a single image. That's the expected behavior of this specific node - it's built to output a list, not one image. If the rest of your graph isn't list-aware, either add a node that reduces the list back to a batch, or use one of the pack's index-driven single-image folder loaders instead if you meant to process one file per queue run.

file_filter returns nothing. Remember it's a glob pattern, not a regex - *.png matches any filename ending in .png, but something like .*\.png$ (regex syntax) won't work here. Keep it to simple wildcard patterns.

Files load in the wrong order. If your filenames don't contain numbers ComfyUI can sort naturally (say, they're named by content rather than sequence), numerical sort won't help - switch to alphabetical, or rename your files to a consistent zero-padded numeric scheme if order genuinely matters for what you're doing downstream.