https://github.com/vault-developer/comfyui-image-blender

ComfyuiImageBlender is a custom node for ComfyUI. It may be used to blend two images together using a specified blending mode.
https://github.com/vault-developer/comfyui-image-blender

comfyui comfyui-nodes python

Last synced: about 2 months ago
JSON representation

ComfyuiImageBlender is a custom node for ComfyUI. It may be used to blend two images together using a specified blending mode.

• Host: GitHub
• URL: https://github.com/vault-developer/comfyui-image-blender
• Owner: vault-developer
• License: mit
• Created: 2024-07-26T06:37:07.000Z (about 1 year ago)
• Default Branch: master
• Last Pushed: 2025-04-02T19:37:15.000Z (6 months ago)
• Last Synced: 2025-04-02T20:34:20.806Z (6 months ago)
• Topics: comfyui, comfyui-nodes, python
• Language: Python
• Homepage:
• Size: 22.5 KB
• Stars: 20
• Watchers: 1
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-comfyui - **ImageBlender**
• awesome-comfyui - **ImageBlender**
• awesome-comfyui - **ImageBlender**

README

          
## COMFYUI-IMAGE-BLENDER

## About

```ComfyuiImageBlender``` is a custom node for ComfyUI.  

You can use it to blend two images together using various modes.  

Currently, 88 blending modes are supported and 45 more are planned to be added.  

Modes logic were borrowed from / inspired by [Krita](https://github.com/KDE/krita) blending modes.

Features:

- 88 blending modes

- support strength parameter

- support mask parameter

  Supported blending modes:

  


    
Arithmetic group

      


        
addition

        
divide

        
inverse subtract

        
multiply

        
subtract

      

    

    
Binary group

      


        
AND

        
CONVERSE

        
IMPLICATION

        
NAND

        
NOR

        
NOT CONVERSE

        
NOT IMPLICATION

        
OR

        
XNOR

        
XOR

      

    

    
Darken group

      


        
burn

        
darken

        
darker color

        
easy burn

        
fog darken

        
gamma dark

        
linear burn

        
shade

      

    

    
HSI group

      


        
color hsi

        
hue hsi

        
saturation hsi

        
intensity

        
decrease saturation hsi

        
increase saturation hsi

        
decrease intensity

        
increase intensity

      

    

    
HSL group

      


        
color hsl

        
hue hsl

        
saturation hsl

        
lightness

        
decrease saturation hsl

        
increase saturation hsl

        
decrease lightness

        
increase lightness

      

    

    
HSV group

      


        
color hsv

        
hue hsv

        
saturation hsv

        
value

        
decrease saturation hsv

        
increase saturation hsv

        
decrease value

        
increase value

      

    

    
HSY group

      


        
color

        
hue

        
saturation

        
luminosity

        
decrease saturation

        
increase saturation

        
decrease luminosity

        
increase luminosity

      

    

    
Lighten group

      


        
color dodge

        
linear dodge

        
lighten

        
linear light

        
screen

        
pin light

        
vivid light

        
flat light

        
hard light

        
soft light (ifs illusions)

        
soft light (pegtop-delphi)

        
soft light (ps)

        
soft light (svg)

        
gamma light

        
gamma illumination

        
lighter color

        
p-norm a

        
p-norm b

        
super light

        
tint (ifs illusions)

        
fog lighten (ifs illusions)

        
easy dodge

        
luminosity/shine (sai)

      

    

    
Mix group

      


        
normal

        
overlay

      

    

    
Modulo group

      


        
modulo

        
divisive modulo

      

    

    
Negative group

      


        
difference

        
equivalence

        
additive subtractive

        
exclusion

        
arcus tangent

        
negation

      

    

  


## Examples:

  Addition

  

  Darken

  

  Saturation HSV

  

## Comfyui workflow

Feel free to check the example workflow [here](https://github.com/vault-developer/comfyui-image-blender/blob/master/workfow.example.json).  

https://github.com/user-attachments/assets/4b503e6a-cdff-4a3d-ac2b-a482ab0d7d8c

## Installation

You need [comfyui](https://github.com/comfyanonymous/ComfyUI) installed first.  

Then several options are available:

1. You can download or git clone this repository inside ComfyUI/custom_nodes/ directory.  

2. If you use comfy-cli, node can be also downloaded from [comfy registry](https://registry.comfy.org/publishers/vault-developer/nodes/comfyui-image-blender):  

```comfy node registry-install comfyui-image-blender```

3. Comfy-ui manager support will be added when [this pull request](https://github.com/ltdrdata/ComfyUI-Manager/pull/925) is merged.

## Contribution and troubleshooting

This is rough implementation, I will appreciate any feedback.  

Feel free to raise issue if you spot any mistake or have a suggestion.

If you want to contribute, feel free to fork this repository and create a pull request.  

There are still 45 blending modes to be added, so you can help with that.

## Future plans

There are still some things to be done:

- [ ] clean up the code

- [ ] add more blending modes

- [ ] test with PNG images

- [ ] enhance error handling

- [ ] add comfyui manager support