ComfyUI-Color-Matcher

ComfyUI custom node for color matching between images. Transfers the color distribution from a reference image to source images or video frames.

Features

• Transfer color characteristics from a reference image to source images
• Supports batch processing for video frames (multi-frame input)
• 6 color matching algorithms to choose from

Supported Methods

| Method | Description | |--------|-------------| | mkl | Monge-Kantorovich Linearization | | hm | Histogram Matching | | reinhard | Reinhard et al. color transfer | | mvgd | Multi-Variate Gaussian Distribution | | hm-mvgd-hm | Compound: HM + MVGD + HM | | hm-mkl-hm | Compound: HM + MKL + HM |

Installation

1. Clone this repository into your ComfyUI/custom_nodes/ directory:

   cd ComfyUI/custom_nodes/
   git clone https://github.com/okdalto/ComfyUI-Color-Matcher.git
   

2. Install dependencies:

   pip install -r requirements.txt
   

Usage

Inputs

• image_ref (IMAGE) - Reference image whose color distribution will be transferred
• image_target (IMAGE) - Source image or video frames to apply color matching to
• method (COMBO) - Color matching algorithm to use

Output

• IMAGE - Color-matched result image(s)

Workflow

1. Load a source image (or video frames) and a reference image
2. Connect them to the Color Match node
3. Select a matching method (default: mkl)
4. The output will have the color characteristics of the reference image applied to the source

Credits

• color-matcher library by hahnec - Core color transfer algorithms (GPL-3.0 License)
• ComfyUI-AdvancedLivePortrait by PowerHouseMan - Original project structure this node was built upon

License

This project uses the color-matcher library which is licensed under GPL-3.0.