QBug-Batch: ComfyUI Custom Nodes

A collection of useful utility nodes for ComfyUI to facilitate batch processing and workflow automation.

中文文档

Project Vision

QBug-Batch aims to solve the batch processing challenge in ComfyUI workflows. Our vision is to help users:

• Efficiently generate multiple outputs by combining different scenes, characters, and parameters
• Reduce the time spent on manually adjusting workflows for each variation
• Automate repetitive tasks that would otherwise require multiple manual interventions
• Improve productivity by allowing systematic exploration of parameter combinations

By providing specialized nodes for batch operations, we help ComfyUI users save time and focus on creative aspects rather than technical adjustments.

Quick Start

Please import the following example workflow into ComfyUI to get started:

• crossjoin-example

Nodes

ListFiles

A node that lists files from a directory with optional sorting and filtering capabilities. The node outputs a comma-separated list of files that can be used by other nodes.

Features:

• Lists all files from a specified directory
• Supports file extension filtering
• Supports alphabetical and date-based sorting
• Outputs files as a comma-separated string

CrossJoinSelector

A powerful selector node that implements nested loop behavior for iterating through multiple inputs.

Features:

• Supports up to 5 input lists
• Simulates nested loop behavior
• Each input has an optional limit parameter to control iteration count
• Maintains state between executions
• Perfect for batch processing with combinations of parameters

Usage Example:

input_1: "pic1,pic2,pic3"
limit_1: 0 (no limit)
input_2: "1,2,3,4,5,6,7,8,9,10"
limit_2: 3

This configuration will iterate through all items in input_1, and for each item, will go through 3 items from input_2 before moving to the next input_1 item.

NoPreviewSaveImage

A node that saves images without showing a preview, useful for batch processing.

Installation

Custom Nodes Manager

Search for qbug-batch in the Custom Nodes Manager to install

Repository Cloning

1. Clone this repository into your ComfyUI custom_nodes directory:

cd ComfyUI/custom_nodes
git clone https://github.com/your-username/qbug-batch.git

2. Restart ComfyUI to load the custom nodes.

Detailed Node Parameters

ListFiles

Input Parameters:

• directory: Directory path to list files from. If empty, defaults to ComfyUI's input directory.
• file_types: File types to filter, comma-separated (e.g., *.png,*.jpg,*.jpeg,*.webp).
• recursive: Whether to search subdirectories recursively (boolean).
• sort_by: File sorting method, options:
  • name: Sort by filename
  • size: Sort by file size
  • modified_time: Sort by modification time
• sort_order: Sorting order, options:
  • asc: Ascending
  • desc: Descending
• separator: Separator for the output file list, defaults to comma.

Output:

• file_list: String of full file paths joined by the specified separator.

CrossJoinSelector

Input Parameters:

• separator: Separator in input lists used to split strings into items.
• reset: Whether to reset the iteration state (boolean).
• input_n: The nth input list (required).
• limit_n: Iteration limit for the nth input (0 means no limit).

Output:

• output_n: Selected item from the nth input in the current iteration.

NoPreviewSaveImage

Input Parameters:

• images: Images to save.
• filename_prefix: Prefix for saved files, defaults to "ComfyUI".
• save_metadata: Whether to save metadata to PNG files (boolean).

Output:

• No return value, but saves images to ComfyUI's output directory.
• Saved files use the format: {filename_prefix}_{counter:05}_.png.

Use Cases

• Character Generation: Combine different characters with various backgrounds, poses, or styles
• Style Exploration: Test a single image across multiple artistic styles or parameters
• Model Evaluation: Run the same prompts across different models to compare results
• Parameter Tuning: Systematically explore different parameter combinations to find optimal settings

License

MIT License