Nodes/Boyonodes/Boyo Load Image Batch (Input Folder)
ComfyUI Node

Boyo Load Image Batch (Input Folder)

Step through an input folder one image at a time — dropdown included

By DragonDiffusionbyBoyo·Created 2 years ago·Updated 26 days ago· 16
Boyo Load Image Batch (Input Folder)
    • image
    • filename_text
    mode
    seed0
    index0
    labelBatch 001
    subfolder
    pattern*
    allow_RGBA_output
    filename_text_extension

    Sometimes you don't want all the images in a folder at once - you want one at a time, in sequence, with your batch loop advancing through them. That's Boyo Load Image Batch. It loads a single image from a subfolder of ComfyUI's input/ directory and, in incremental mode, advances to the next file each time it executes. Think of it as a per-iteration image iterator for batch processing, and the reason you'd pick it over a plain Load Image is the subfolder dropdown: no typing paths, which keeps things reliable on Linux and cloud boxes.

    It's explicitly modeled on WAS's Load Image Batch, so if you've used that, this is a familiar shape with a Boyo skin.

    The inputs that matter

    • mode - single_image (load by explicit index), incremental_image (advance through the folder each execution), or random (seeded pick).
    • index - which file to load in single_image mode (0-based, by sorted order).
    • seed - used for the random mode, so you can reproduce a given pick.
    • subfolder - dropdown of input subfolders. Drop your files in ComfyUI/input/<subfolder>/ and it shows up here.
    • pattern - glob filter, default *. *.png if you only want PNGs.
    • allow_RGBA_output - keep the alpha channel or flatten to RGB.
    • label - just a batch name tag, mostly cosmetic.

    Optional filename_text_extension controls whether the filename output includes the extension.

    Outputs: image (the loaded frame) and filename_text (the matched filename, handy for wiring into a save node or metadata).

    Install

    Part of Boyonodes. ComfyUI Manager → search "Boyonodes", or:

    cd ComfyUI/custom_nodes
    git clone https://github.com/DragonDiffusionbyBoyo/Boyonodes
    

    Restart. No extra pip packages.

    How incremental actually works

    Here's the clever bit: in incremental_image and random modes the node's IS_CHANGED returns NaN, which forces ComfyUI to re-execute it every queue run instead of caching the result. That's what makes it step forward through the folder with a batch loop instead of returning the same image forever. If you ever feel like it's "stuck," check the mode - single_image is deliberately static. Also note it only matches the pattern in the chosen subfolder; if you get a silent (None, "") back, the folder or pattern is wrong.

    CategoryBoyo Nodes/IO

    Inputs (8)

    NameTypeDefaultDescription
    modeCOMBO3 options: single_image, incremental_image, random
    seedINT00–18446744073709550000
    indexINT00–150000
    labelSTRINGBatch 001
    subfolderCOMBO1 options: 3d
    patternSTRING*
    allow_RGBA_outputCOMBO2 options: false, true
    filename_text_extensionoptCOMBO2 options: true, false

    Outputs (2)

    NameTypeDescription
    imageIMAGE
    filename_textSTRING