Save 4 hours! We auto-setup your workflow! Free!

Drop your workflow.json — we handle every dependency, custom node, and model. Just open the link and run.

Auto-Setup Workflow Json (Free) Now!
ComfyUI > Nodes > comfyui-loadheicimage > Load Image (HEIC)

ComfyUI Node: Load Image (HEIC)

Class Name

LoadImagePlusHEIC

Category
image
Author
esp-dev (Account age: 2574days)
Extension
comfyui-loadheicimage
Latest Updated
2025-12-29
Github Stars
0.0K

How to Install comfyui-loadheicimage

Install this extension via the ComfyUI Manager by searching for comfyui-loadheicimage
  • 1. Click the Manager button in the main menu
  • 2. Select Custom Nodes Manager button
  • 3. Enter comfyui-loadheicimage in the search bar
After installation, click the Restart button to restart ComfyUI. Then, manually refresh your browser to clear the cache and access the updated list of nodes.

Visit ComfyUI Online for ready-to-use ComfyUI environment

  • Free trial available
  • 16GB VRAM to 80GB VRAM GPU machines
  • 400+ preloaded models/nodes
  • Freedom to upload custom models/nodes
  • 200+ ready-to-run workflows
  • 100% private workspace with up to 200GB storage
  • Dedicated Support

Run ComfyUI Online

Load Image (HEIC) Description

Loads standard and HEIC/HEIF images into ComfyUI, correcting orientation and outputting RGB and masks.

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-heif in the Python environment used by ComfyUI with pip install pillow-heif, then restart ComfyUI so the decoder can be registered.
  • Use the image output for ordinary image editing. Connect mask when 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-heif in 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-heif is 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.

Load Image (HEIC) Related Nodes

Go back to the extension to check out more related nodes.
comfyui-loadheicimage
RunComfy
Copyright 2025 RunComfy. All Rights Reserved.

RunComfy is the premier ComfyUI platform, offering ComfyUI online environment and services, along with ComfyUI workflows featuring stunning visuals. RunComfy also provides AI Models, enabling artists to harness the latest AI tools to create incredible art.

Load Image (HEIC)