comfyui-hsl-mask-node

HSL Range → Mask — ComfyUI Custom Node

Pick a range of colours by Hue / Saturation / Lightness and get back a clean mask where every matching pixel is white and everything else is black.

---

Installation

1. Copy the hsl_mask_node folder into:

   ComfyUI/custom_nodes/hsl_mask_node/
   

   The folder must contain both files:

   custom_nodes/
   └── hsl_mask_node/
       ├── __init__.py
       └── hsl_mask_node.py
   

2. Restart ComfyUI.

3. The node appears in the node browser under: image → masking → HSL Range → Mask

---

Inputs

| Input | Type | Range | Description | |---|---|---|---| | image | IMAGE | — | Any image from the pipeline | | start_hue | FLOAT | 0 – 360 | Start of the hue range (degrees) | | end_hue | FLOAT | 0 – 360 | End of the hue range (degrees) | | start_saturation | FLOAT | 0 – 100 | Minimum saturation (%) | | end_saturation | FLOAT | 0 – 100 | Maximum saturation (%) | | start_lightness | FLOAT | 0 – 100 | Minimum lightness (%) | | end_lightness | FLOAT | 0 – 100 | Maximum lightness (%) |

Output

| Output | Type | Description | |---|---|---| | mask | MASK | White where colour matches, black elsewhere |

---

Tips

• Isolate reds that cross the 0°/360° boundary: set start_hue = 340, end_hue = 20. The node handles the wrap-around automatically.
• Pipe the mask into a MaskToImage, InvertMask, or use it with VAE Encode (inpaint) for targeted inpainting.
• Combine multiple HSL masks with a MaskComposite node to select several colour families at once.

---

Requirements

• ComfyUI (any recent version)
• Python standard library only (colorsys, numpy) — no extra pip install needed.