Nodes/ComfyUI_yanc/๐Ÿ˜ผ> Blur
ComfyUI Node

๐Ÿ˜ผ> Blur

A simple, maskable blur for backgrounds, softening, or fake depth of field

By ALatentPlaceยทCreated 2 years agoยทUpdated 2 years agoยท 80
๐Ÿ˜ผ> Blur
  • image
  • mask_opt
  • image
โ—„intensity0.00โ–บ

There's nothing clever going on here - it's a blur node - but the reason it earns a place in a lot of graphs is the optional mask input. A plain global blur is rarely what you actually want; a selective one is.

How it works

Blur takes your image and softens it by an amount you control with intensity. Feed it a mask and it only blurs where the mask says to, leaving the rest of the image untouched. That's the whole feature: everyone's got a blur filter, not everyone's is maskable out of the box.

The practical use is faking depth of field without a depth model: run a background-removal or segmentation node on your subject, invert the resulting mask so it covers everything except them, and wire that into mask_opt. Your subject stays sharp, the background goes soft, and you get a portrait-lens look for the price of one extra node. Reverse the logic and you can just as easily soften skin in a masked region instead.

The inputs and outputs that matter

  • image (IMAGE) - required, runs on decoded pixels.
  • intensity (FLOAT, 0โ€“1, step 0.01, default 0) - blur strength. This is a normalized 0โ€“1 dial, not a pixel radius, so think "how much" rather than "how many pixels."
  • mask_opt (MASK, optional) - leave it disconnected and the blur applies to the whole image; connect one and only the masked area blurs.
  • image out - feed to the next node or Save Image.

How to install it

Via ComfyUI Manager: search "yanc" or "ComfyUI_yanc" and install, then restart. Manually:

cd ComfyUI/custom_nodes
git clone https://github.com/ALatentPlace/ComfyUI_yanc

then restart ComfyUI. No extra dependencies, no models - a filter node, same as the rest of this pack's post-processing suite.

Common issues & troubleshooting

Blur isn't confined to where you expect. The classic ComfyUI trap: your mask needs to match the image's resolution, or you'll hit a shape-mismatch error (or in some setups, silently wrong output). If your mask came from a different-resolution source - a preview thumbnail, a differently-sized crop - resize it to match the image first.

Intensity at 1.0 barely looks different from 0.5. This is a normalized dial, so the top of the range is a strong blur, not an infinite one. If you need heavier softening than the max gives you, chain two Blur nodes rather than expecting the slider to go further than it does.

Nothing's blurred at all. Check intensity isn't sitting at its default of 0 - same trap as this pack's other post-processing nodes (Bloom, Brightness, Contrast) where the neutral default means "off," not "subtle."

CategoryYANC/๐Ÿ˜ผ Image/๐Ÿ˜ผ Post Processing

Inputs (3)

NameTypeDefaultDescription
imageIMAGEโ€”
intensityFLOAT0.000โ€“1โ€”
mask_optoptMASKโ€”

Outputs (1)

NameTypeDescription
imageIMAGEโ€”