Load Images (Upload) 🎥🅥🅗🅢(LoadImagesFromDirectoryUpload)
**Paragraph 2 (Node Function, 3-4 sentences):**
Load Images From Directory Upload
Paragraph 1 (Brief Description, 2-3 sentences): The Load Images (Upload) node is a core node under the Video Helper Suite category, used for batch loading images from ComfyUI's input directory. Its primary function is to read sequences of images uploaded by users to a specified folder into the workflow, providing source material for subsequent image processing or video generation.
Node Functionality
Paragraph 2 (Node Functionality, 3-4 sentences):
This node scans and lists all subfolders within ComfyUI's input directory (excluding the clipspace folder), allowing the user to select one as the image source. It supports fine-grained control over the loading process, such as setting a maximum load count, skipping initial images, and selecting images at intervals. The node internally validates the directory path's validity and tracks file changes to optimize caching.
Node Parameter Description - Load Images (Upload) 🎥🅥🅗🅢
Connection Inputs (Inputs)
| Parameter Name | Data Type | Required | Default Value | Range/Options | Description |
|---|---|---|---|---|---|
directory | COMBO | Yes | - | - | **: Select the source folder containing the image sequence to be loaded. This list is dynamically generated from the names of subfolders within ComfyUI's input directory. |
meta_batch | VHS_BatchManager | No | - | - | **: Receives a batch manager object used to coordinate batches and metadata for multiple image loading tasks in complex workflows. Type is VHS_BatchManager. |
Control Parameters (Parameters)
| Parameter Name | Data Type | Required | Default Value | Range/Options | Description |
|---|---|---|---|---|---|
image_load_cap | INT | No | 0 | 0 - BIGMAX (Step: 1) | - |
skip_first_images | INT | No | 0 | 0 - BIGMAX (Step: 1) | - |
select_every_nth | INT | No | 1 | 1 - BIGMAX (Step: 1) | - |
Output
| Parameter Name | Data Type | Description |
|---|---|---|
| IMAGE | IMAGE | **: Outputs a batch tensor stacked from all loaded image data. |
| MASK | MASK | **: Outputs a batch tensor stacked from mask data corresponding to the images. |
| frame_count | INT | **: Outputs the total number of frames (images) successfully loaded. |
Usage Scenarios
Paragraph 3 (Usage Scenarios, 2-3 sentences): In workflows for creating image-to-video (Img2Vid), this node can be used to load a folder containing a sequence of keyframes. For tasks requiring batch processing with masks, such as green screen keying, it can load the original image sequence along with its corresponding mask sequence. When testing different image processing effects, it can also be used to quickly load a set of test images for batch application.
Notes
Paragraph 4 (Notes, optional, 1-2 sentences): Image files to be loaded must be pre-uploaded to the specified input directory subfolder via ComfyUI's interface or API. The node only processes folders, not individual files directly.
Load Images (Upload) 🎥🅥🅗🅢 Node Source Code Link
Load Images (Upload) 🎥🅥🅗🅢 node is from the ComfyUI-VideoHelperSuite node package.
Comments
Sign in with GitHub to join the discussion.