Load Image (HEIC):
LoadImagePlusHEIC loads an image from ComfyUI’s input folder for use in an image workflow. It supports common formats such as PNG, JPEG, WebP, BMP, and GIF, and can open HEIC or HEIF files when the required decoding dependency is available. The node applies the image’s orientation information so a photo taken on a phone appears the right way up, converts its visual content to RGB, and preserves transparency information separately where available. It can also process multiple frames from an image file, making it useful for both still images and supported multi-frame files.
Load Image (HEIC) Input Parameters:
image
Choose the file you want to load from the image selector, which also supports image upload. The choices are the supported files currently found in ComfyUI’s input folder, filtered by the extensions PNG, JPG, JPEG, WebP, HEIC, HEIF, BMP, and GIF; the available options therefore depend on the files in your installation. This selection determines the image content, orientation, transparency, and any frames the node processes. There is no numeric minimum or maximum, and the source does not specify a default file.
Load Image (HEIC) Output Parameters:
image
The loaded visual content as an IMAGE value. Each accepted frame is oriented using its embedded orientation information, converted to RGB, and represented with color values from 0 to 1. If a file contains multiple frames of the same dimensions, the node combines them into a batch, except for MPO files, for which it returns only the first accepted frame. Frames whose dimensions differ from the first accepted frame are skipped. This is the output to connect to nodes that process or display the picture.
mask
A MASK value associated with the loaded image. Where a frame has transparency, the mask is calculated from its alpha information: fully transparent areas have a value of 1, and fully opaque areas have a value of 0. Palette-based images with transparency information are handled as well. If no transparency is found, the node returns a zero-filled 64 × 64 mask rather than a full-size mask. Check that downstream nodes can use that mask size before relying on it for masking work.
Load Image (HEIC) Usage Tips:
- Select an existing file from the image menu or upload one into ComfyUI’s input folder. If a newly added file is missing from the menu, refresh the node’s available file choices.
- For HEIC or HEIF photos that will not open, install
pillow-heifin the Python environment used by ComfyUI withpip install pillow-heif, then restart ComfyUI so the decoder can be registered. - Use the
imageoutput for ordinary image editing. Connectmaskwhen you need transparency-based masking, remembering that transparent areas receive higher mask values. - For multi-frame files, use frames with matching dimensions if you need them together as a batch; frames of a different size are skipped. The node has no frame-selection or resizing setting.
- If you need a mask matching a fully opaque image’s dimensions, create or resize that mask downstream: this node returns a 64 × 64 zero mask when the image has no transparency.
Load Image (HEIC) Common Errors and Solutions:
HEIC/HEIF support is not available. Install dependency: pip install pillow-heif
- Explanation: The selected file is recognized as a HEIC or HEIF path, but the node could not register the decoder needed to open it.
- Solution: Install
pillow-heifin ComfyUI’s Python environment and restart ComfyUI. Make sure the installation command runs in the same environment that launches ComfyUI.
Failed to open HEIC/HEIF image. Ensure pillow-heif is installed: pip install pillow-heif
- Explanation: The node found the selected HEIC or HEIF file but could not open it. The full message also shows the filename and the underlying decoding error.
- Solution: Confirm that
pillow-heifis installed in ComfyUI’s environment, then try opening the file in another image application to check whether it is valid. If the file is damaged or uses an unsupported encoding, export a fresh copy in a compatible format.
Failed to open image: <filename>
- Explanation: The selected non-HEIC image could not be opened. The full message includes a more specific underlying error.
- Solution: Check that the file is a valid image and that its extension matches its actual format. Try exporting it again as PNG or JPEG, then select the new file.
Invalid image file: <filename>
- Explanation: Input validation could not find the selected file at its annotated ComfyUI input path.
- Solution: Confirm that the file still exists in the expected input location, then select it again from the node’s image menu or upload it again.
Image not found in input path: <filename>
- Explanation: The file was no longer available when the node attempted to load it.
- Solution: Restore or re-upload the image and reselect it. This can happen if a file was moved, renamed, or deleted after you chose it.
No frames could be decoded from image: <filename>
- Explanation: The file opened, but the node did not produce any usable image frames.
- Solution: Check the file in another image application and export a fresh PNG, JPEG, or other supported copy before loading it again.
This node must run inside a ComfyUI environment (missing folder_paths/node_helpers).
- Explanation: The node cannot access the ComfyUI components it needs to locate and process images.
- Solution: Run the node inside a working ComfyUI installation rather than as a standalone Python script, and check that the installation contains its required ComfyUI modules.
