Skip to content

README.md

Latest commit

 

History

History
104 lines (75 loc) · 3.72 KB

README.md

File metadata and controls

104 lines (75 loc) · 3.72 KB

ComfyUI Batch Image Processing

Custom nodes for batch processing images through ComfyUI pipelines. Load a directory of images, run your workflow once, and have each image processed and saved automatically.

Installation

Clone this repository into your ComfyUI custom nodes directory:

cd ComfyUI/custom_nodes
git clone https://github.com/dchuk/comfyui-batch-image-processing.git

Restart ComfyUI. The nodes appear under the batch_processing category.

Nodes

Batch Image Loader

Loads images from a directory one at a time for batch processing.

Inputs:

  • directory - Path to folder containing images
  • filter_preset - All Images, PNG Only, JPG Only, or Custom
  • custom_pattern - Glob patterns when using Custom filter (e.g., *.png,*.jpg)
  • iteration_mode - Continue (resume) or Reset (start over)
  • error_handling - Stop on error or Skip on error
  • start_index - Starting position (0-based)

Outputs:

  • IMAGE - Current image tensor
  • INPUT_DIRECTORY - Source directory path
  • INPUT_BASE_NAME - Filename without extension
  • INPUT_FILE_TYPE - File extension (png, jpg, etc.)
  • FILENAME - Full filename
  • INDEX - Current position (0-based)
  • TOTAL_COUNT - Total images in directory
  • STATUS - Human-readable status message
  • BATCH_COMPLETE - True when all images processed

Batch Image Saver

Saves processed images with configurable naming and format options.

Inputs:

  • image - Image tensor to save
  • output_directory - Destination folder (wire from INPUT_DIRECTORY or leave empty for ComfyUI output)
  • output_base_name - Base filename (wire from INPUT_BASE_NAME)
  • output_file_type - Format: png, jpg, jpeg, or webp (wire from INPUT_FILE_TYPE)
  • filename_prefix - Text to prepend (include your own separator, e.g., upscaled_)
  • filename_suffix - Text to append (include your own separator, e.g., _2x)
  • quality - JPG/WebP quality 1-100 (PNG ignores this)
  • overwrite_mode - Overwrite, Skip, or Rename existing files

Outputs:

  • OUTPUT_IMAGE - Passthrough of input image (for preview nodes)
  • SAVED_FILENAME - Name of saved file
  • SAVED_PATH - Full path to saved file

Batch Progress Formatter

Formats progress information as human-readable text.

Inputs:

  • current_index - Wire from INDEX
  • total_count - Wire from TOTAL_COUNT

Outputs:

  • PROGRESS_TEXT - Formatted as "X of Y (Z%)"

How It Works

ComfyUI doesn't have native looping. These nodes implement a queue-per-image pattern:

  1. First execution: BatchImageLoader reads the directory, loads image #0, and queues another workflow execution
  2. Subsequent executions: The loader increments its index, loads the next image, and queues again
  3. Final execution: When all images are processed, BATCH_COMPLETE becomes true and no new execution is queued

Each image flows through your entire pipeline before the next one starts. This means:

  • Only one image is in memory at a time
  • If ComfyUI crashes, already-saved images are safe
  • You can interrupt anytime without losing completed work
  • Any downstream nodes work normally (upscalers, ControlNet, etc.)

The UI updates live during processing via WebSocket broadcasts, so you see current progress without refreshing.

Example Workflow

[Batch Image Loader] → [Your Processing Nodes] → [Batch Image Saver]
         ↓                                               ↓
  [Progress Formatter] → [Show Text]              [Preview Image]

Wire the loader's outputs to the saver's inputs:

  • INPUT_DIRECTORY → output_directory
  • INPUT_BASE_NAME → output_base_name
  • INPUT_FILE_TYPE → output_file_type

This preserves original filenames. Add prefix/suffix for variants (e.g., photo.jpg → upscaled_photo_2x.jpg).

License

MIT