Extensions/Praveen's ComfyUI Tools
ComfyUI Extension

Praveen's ComfyUI Tools

A comprehensive collection of 18+ utility nodes for ComfyUI including image list operations (split/merge), advanced tiling with seamless blending,…

By Praveenhalder·Created about a year ago·Updated 6 months ago· 2
Praveenhalder/praveen-tools
Nodes16
On cloudLocal install
Categoryimage/postprocessing, image/generate
Stars2
Updated6 months ago
Readme

Praveen's ComfyUI Custom Nodes

A collection of utility nodes for ComfyUI focused on image manipulation, tiling, batch processing, and workflow optimization.

Features

📦 Image List Operations

  • Split Image List (3-Way) - Split image batches into three separate lists with customizable ratios
  • Merge Image Lists (3-Way) - Combine three image lists with configurable merge order
  • Select Last Image - Extract the last image from a batch
  • Skip First Image - Remove the first image from a batch

🎨 Image Adjustments

  • Brightness/Contrast/Saturation/RGB - Comprehensive color and tone adjustments with per-channel RGB gain control
  • Diagonal Text Watermark - Add customizable diagonal text watermarks to images

🔲 Tiling & Upscaling

  • Image Tile Split - Divide images into overlapping tiles for processing large images
  • Image Tile Merge - Reconstruct images from tiles with smart blending
  • Overlapping Image List Splitter - Automatically split image batches with overlap
  • Overlapping Image List Merger - Merge overlapping images with seamless blending

🛠️ Utilities

  • Image Dimensions (Multiple of 16) - Set dimensions constrained to multiples of 16
  • Resolution Wan - Quick resolution presets for common aspect ratios
  • RGB Channel Merger - Combine separate R, G, B channels into a single image
  • Black Image Generator - Create blank black images with specified dimensions
  • Load Image (with filename) - Load images and output the filename
  • Extract Filename - Extract filename without extension from file paths
  • Tile Info Display - Debug utility to display tiling information

Installation

Method 1: Clone the Repository

Navigate to your ComfyUI custom nodes folder and clone this repository:

git clone https://github.com/Praveenhalder/praveen-tools.git

Method 2: Manual Installation

  1. Download the Praveen_tools.py file
  2. Place it in your ComfyUI/custom_nodes/ directory
  3. Restart ComfyUI

Requirements

  • ComfyUI
  • PyTorch
  • PIL (Pillow)
  • NumPy

All dependencies are typically included with a standard ComfyUI installation.

Node Documentation

Image List Operations

Split Image List (3-Way)

Splits a batch of images into three separate lists based on customizable ratios.

Inputs:

  • images (IMAGE) - Input image batch
  • split_ratio_1 (FLOAT) - Ratio for first split (default: 0.33)
  • split_ratio_2 (FLOAT) - Ratio for second split (default: 0.33)

Outputs:

  • images_1, images_2, images_3 - Three separate image batches

Merge Image Lists (3-Way)

Combines three image lists into a single batch.

Inputs:

  • images_1, images_2, images_3 (IMAGE) - Three input image batches
  • merge_order - Order to merge: "1-2-3", "1-3-2", "2-1-3", etc.

Outputs:

  • merged_images - Combined image batch

Image Adjustments

Brightness/Contrast/Saturation/RGB

Comprehensive image adjustment with individual channel control.

Inputs:

  • image (IMAGE) - Input image
  • brightness (FLOAT) - 0.0 to 2.0 (default: 1.0)
  • contrast (FLOAT) - 0.0 to 2.0 (default: 1.0)
  • saturation (FLOAT) - 0.0 to 2.0 (default: 1.0)
  • red_gain, green_gain, blue_gain (FLOAT) - 0.0 to 2.0 (default: 1.0)

Outputs:

  • Adjusted image

Diagonal Text Watermark

Adds customizable diagonal text watermarks across images.

Inputs:

  • image (IMAGE) - Input image
  • text (STRING) - Watermark text
  • font_size (INT) - Text size (default: 120)
  • opacity (FLOAT) - 0.0 to 1.0 (default: 0.2)
  • color - Text color selection
  • angle (FLOAT) - Rotation angle in degrees
  • spacing (INT) - Space between repetitions
  • x_offset, y_offset (INT) - Position offset

Tiling & Upscaling

Image Tile Split

Divides large images into overlapping tiles for processing.

Inputs:

  • image (IMAGE) - Input image
  • tile_size (INT) - Size of each tile
  • overlap_percent (FLOAT) - Overlap between tiles (0-50%)

Outputs:

  • tiles (IMAGE) - Batch of tiles
  • tile_info (TILE_INFO) - Metadata for reconstruction

Image Tile Merge

Reconstructs original image from processed tiles with smart blending.

Inputs:

  • tiles (IMAGE) - Processed tiles
  • tile_info (TILE_INFO) - Metadata from split operation
  • crop_percent (FLOAT) - Amount of overlap to crop (0-100%)
  • fade_percent (FLOAT) - Blending zone size (0-100%)
  • blend_mode - "linear", "cosine", or "sigmoid"

Outputs:

  • Reconstructed image

Utilities

Image Dimensions (Multiple of 16)

Outputs width and height constrained to multiples of 16, useful for stable diffusion models.

Inputs:

  • width (INT) - Width in pixels (step: 16)
  • height (INT) - Height in pixels (step: 16)

Outputs:

  • width, height (INT)

Resolution Wan

Quick access to common aspect ratios and resolutions.

Inputs:

  • aspect_ratio - Predefined ratios (1:1, 16:9, 9:16, etc.)
  • megapixels (FLOAT) - Target megapixels (default: 1.0)

Outputs:

  • width, height (INT)

Use Cases

High-Resolution Image Processing

Use the tile split/merge nodes to process images larger than your GPU memory allows:

  1. Image Tile Split - Break into manageable tiles
  2. Process tiles (upscale, denoise, etc.)
  3. Image Tile Merge - Seamlessly reconstruct

Batch Processing Workflows

Split batches for different processing paths, then merge:

  1. Split Image List - Separate into thirds
  2. Apply different effects to each third
  3. Merge Image Lists - Recombine in desired order

Color Grading

Use the Brightness/Contrast/Saturation/RGB node for precise color correction with individual RGB channel control.

Watermarking

Add professional diagonal watermarks with the Diagonal Text Watermark node.

Tips & Best Practices

  • Tiling: Use 20-30% overlap for seamless blending
  • Blending: Cosine mode provides the smoothest transitions
  • Performance: Larger tiles = fewer tiles but more VRAM per tile
  • Crop: Start with 50% crop and adjust if you see seams

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

GPL-3.0 License

Credits

Created by Praveen

Support

If you encounter any issues or have questions:

  • Open an issue on GitHub
  • Check existing issues for solutions

Changelog

Version 1.0

  • Initial release with 18 custom nodes
  • Image list operations
  • Tiling and merging capabilities
  • Color adjustment tools
  • Utility nodes for workflow optimization

Note: This is a custom node collection for ComfyUI. Make sure you have ComfyUI installed and running before using these nodes.