Skip to content

Multi-mask compositing node for ComfyUI with blend modes + preview. This node allows the creation masks with multiple levels in ComfyUI.

License

Notifications You must be signed in to change notification settings

shawnlau23-coder/GPT5-MaskTools

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

2 Commits
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

GPT5 Mask Tools

A lightweight ComfyUI node for blending multiple masks together with adjustable strength per mask.
Useful for compositing hand-painted or region-based mask layers directly inside ComfyUI β€” without needing Photoshop, Krita, or external editors.


✨ Features

  • Accepts 1 to 5 mask inputs
  • Each mask has its own strength slider (0.00 to 1.00)
  • Masks are composited using Max / Add / Multiply / Lighten / Darken blend modes
  • Outputs a single final mask
  • Supports overlapping paint regions cleanly
  • Works directly with the built-in Mask Editor node

πŸ–₯ Example Use Case

You can paint:

  • Hair region
  • Clothing region
  • Background elements
  • Highlight areas
  • Shadow regions

Then feed each mask into this node to produce a unified multi-level mask for:

  • Image-to-Image refinement
  • Region control
  • Flux / SDXL selective guidance
  • Depth shading workflows
  • Layer-based artistic control

🧩 Node Placement

Place the folder into:

Place the folder into:

ComfyUI/custom_nodes/GPT5-MaskTools

Then restart ComfyUI.

The new node appears under:

Mask β†’ GPT5 Mask Blend


πŸ” Blend Modes

Mode What it Does
Max Takes the highest mask value (default). Best for layering painted regions.
Add Adds masks together. Useful for soft layering.
Multiply Darkens intersections. Good for weight-based masking.
Lighten Similar to Max but smoother transitions.
Darken Keeps common intersection darkness. Experimental/artistic.

πŸ›  Development / Credits

Created by: shawnlau23-coder
Node Logic + Implementation: GPT-5 (ChatGPT)

If you improve the node, please submit PRs β€” this is designed to be community-extendable.


🌱 Future Possibilities (Optional Ideas)

(Not implemented β€” but easy to add if needed)

  • Per-mask invert toggle
  • Soft-edge / feathering control
  • Live node thumbnail preview
  • Region boundary auto-blur

We intentionally did not add these to avoid clutter β€” the goal is clean & focused mask compositing.


βœ… License

MIT β€” free for personal and commercial use.

About

Multi-mask compositing node for ComfyUI with blend modes + preview. This node allows the creation masks with multiple levels in ComfyUI.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages