2🐕Mask Blurred Black edges

This pack ships three mask-feathering nodes, and if you've landed here you've probably already seen EG_ZZ_BSYH ("Mask Blurred white edges") - EG_ZZ_HSYH ("Mask Blurred Black edges") is its counterpart, sharing the exact same parameter set and differing only in how the blur treats the mask's boundary.

How it works

Same Gaussian-blur feathering mechanism as its sibling: kernel_size and sigma control the blur itself, shrink_pixels and expand_pixels let you contract or grow the mask before the blur runs, all in one pass. The "black edges" naming, as opposed to the sibling's "white edges," points at which value the blur treats as the boundary it's padding against at the mask's edge - that's the one meaningful difference between the two nodes, and it's the kind of distinction that's easier to see than to describe: run the same mask through both and compare the output rather than trying to reason it out from the name alone.

The inputs and outputs that matter

• mask (MASK, required) - the mask to feather.
• kernel_size (INT, default 50, range 3–200, optional) - Gaussian kernel size; larger means a wider soft edge.
• sigma (FLOAT, default 15, range 0.1–200, optional) - blur spread.
• shrink_pixels (INT, default 0, range 0–50, optional) - contract the mask before blurring.
• expand_pixels (INT, default 0, range 0–50, optional) - grow the mask before blurring.

Defaults (kernel_size 50, sigma 15) land well above the light 4–12px feather typical for a clean inpaint seam, so expect a soft result out of the box - pull both down for a tighter edge. Output is a single mask (MASK).

How to install it

ComfyUI Manager: search Comfyui-ergouzi-Nodes. Manual:

cd ComfyUI/custom_nodes
git clone https://github.com/11dogzi/Comfyui-ergouzi-Nodes.git

Restart ComfyUI. Same standing note as the rest of the pack: the author's README marks this English repo as no longer updated, with active development continuing on a Chinese-named sibling pack.

Common issues & troubleshooting

Unsure whether to use this or EG_ZZ_BSYH. There's no documented rule for picking one over the other - they share identical inputs and differ only in edge-padding behavior. The practical approach: run your actual mask through both and keep whichever gives a cleaner transition for your specific composite. Don't spend time reasoning about the name; just A/B it.

Feathered result bleeds too far into surrounding pixels. Standard Gaussian-feather trade-off - high kernel_size/sigma on a small or tightly-cropped mask extends the soft edge into areas you meant to leave untouched. Scale both down relative to your mask size.

Shrink/expand seems to have no visible effect. Both operate before the blur, so a small shrink followed by a wide blur can end up looking similar to no shrink at all once the Gaussian kernel spreads the edge back out. Lower kernel_size first if you want to actually see the shrink or expand take effect in the final mask.