Nodes/ComfyUI-Addoor/🌻 Load Image Advanced
ComfyUI Node

🌻 Load Image Advanced

Load an image and get its filename and alpha too

By Eagle-CN·Created 2 years ago·Updated about a year ago· 75
🌻 Load Image Advanced
    • IMAGE
    • MASK
    • FILENAME
    image
    strip_extensiontrue
    rgbafalse

    The built-in Load Image, plus the two things it's always been missing: it hands you the source filename as a string, and it can keep the alpha channel instead of flattening it. If you've ever needed to name your outputs to match their inputs, or you're working with transparent PNGs, this is the loader you actually want.

    Why the extra outputs matter

    The stock loader gives you an image and a mask and that's it. The filename disappears - which is a problem the moment you're batch-processing and want each output named after its input, or you're building an image/caption dataset where the pairing is by filename. Load Image Advanced surfaces that name as a real output you can wire into a saver. And the alpha handling matters for anyone compositing: a lot of PNGs carry transparency, and silently dropping it means you lose the very thing you loaded the image for.

    How it works

    You pick a file from the image dropdown (the same input-folder picker as the built-in loader). strip_extension decides whether the returned filename keeps its .png/.jpg suffix or comes back clean. rgba controls whether the alpha channel is preserved - turn it on to load the image with transparency intact rather than flattened to RGB.

    The inputs

    • image - the file to load, from ComfyUI's input folder.
    • rgba - keep the alpha channel. On for transparent PNGs; off for a normal opaque load.
    • strip_extension - return the filename with or without its extension. On by default (clean name).

    Three outputs: IMAGE (the loaded picture), MASK (from the alpha, like the standard loader), and FILENAME - the reason this node exists. Chain that filename into Image Saver's filename_opt and your outputs come out named to match their sources.

    Common issues

    The alpha toggle is the thing to get right. If you're loading a transparent PNG and it comes out with a solid background, rgba is off - flip it on. Conversely, if a downstream node chokes because it got a 4-channel image it didn't expect, turn rgba back off so it loads as plain RGB. The FILENAME output is only as useful as what you do with it - its whole point is keeping input and output names in sync across a batch, so wire it through. And like the stock loader, the image dropdown reads from ComfyUI's input directory, so upload or drop your file there first or it won't appear in the list.

    Installing ComfyUI-Addoor

    ComfyUI-Addoor (葵花宝典) is a utility and image pack from developer Eagle-CN. ComfyUI Manager: Install Custom Nodes → search "ComfyUI-Addoor" → install → restart. Manual:

    cd ComfyUI/custom_nodes
    git clone https://github.com/Eagle-CN/ComfyUI-Addoor.git
    cd ComfyUI-Addoor
    pip install -r requirements.txt
    

    Restart and find it under 🌻 Addoor / Image.

    Category🌻 Addoor/Image

    Inputs (3)

    NameTypeDefaultDescription
    imageCOMBO1 options: example.png
    strip_extensionBOOLEANtrue
    rgbaBOOLEANfalse

    Outputs (3)

    NameTypeDescription
    IMAGEIMAGE
    MASKMASK
    FILENAMESTRING