Guided Blur (Refine Edge) v1.3

This location is for Registered Users Only.
Perhaps you need to login or register.
Contributor: Rafael Silva
The guided blur is an edge-preserving blur, useful to add fine details to a roto/matte. Similar to the 'Refine Edge' feature from Photoshop.
13.1, 13.0, 12.2, 12.1, 12.0, 11.3, 11.2, 11.1, 11 or later
Linux, Mac, Windows
24 Jan 2022

Guided Blur (Refine Edge)

The guided filter is an edge-preserving blur, useful to add details to the edges of a roto/matte using a second image as a guide.

For those who are familiar with Photoshop, the results are similar to the Refine Edge feature, improving fine detail around the edges.

Guided Filter Example

Use cases

  • Improving edge detail from roto/mattes, especially with difficult to capture details like hair or fur.

  • Keying: blurring a core matte can lead to blobs/webbing around corners and small details. Blurring using the guided filter alleviates this problem.

How to use

  • Connect the alpha/roto to the matte input and a RGB image which we will extract the details, usually the original plate, to the img input.
  • Control the amount of detail using the edge detail slider.

Values close to 0 makes the filter behave like a regular blur.
Values higher than 6 are usually too high, identifying grain as edges and introducing artifacts.
Recommended values are between 2 and 5.

Release Notes


  • Speed-up the gizmo by 30%
  • Now compatible with Nuke 8


  • Fixed error 'unknown command' when loading the gizmo using the function Other > All plugins > Update.


  • Switched the image and input nodes, so it behaves more predictably when disabling the gizmo.
  • Fixed error when using the gizmo with OCIO profiles


The filter was implemented following the technique proposed in the paper:
He, Kaiming, Jian Sun, and Xiaoou Tang. 'Guided image filtering.' In European conference on computer vision, pp. 1-14. Springer, Berlin, Heidelberg, 2010.

Questions or bugs,feel free to shoot me an email: [email protected]'>[email protected]
Rafael Silva -

Please login in order to download these files.


+1 # oliver Nguyen 2020-04-15 01:32
+1 # satish rekapalli 2020-04-15 17:50
0 # fast abst 2020-04-18 01:48
Very useful tool, thanks Rafael!

You need to remove Viewer node inside the group and also remove first line of code: version 12.1 v1

At the moment if nuke has different OCIO it will show an error and also also will popup an error message if nuke version is different.

Copy1 inside the group must be attached B input to the img imput, at the moment it's attached to the matte. At the moment rgb output comed from the matte input, which doesn't make much sence and also if your project has different format then your input it not work correctly. I've tested it and now it works just fine.

Also you should add name on this gizmo
this is the begining of your script:

version 12.1 v1 - this must be removed
Group {
name rs_GuidedBlur - this you should add
inputs 2
0 # Rafael Perez 2020-04-20 13:18
Thanks for the feedback, fast abst

I've applied those changes, also I switched the matte and matte inputs so it behaves more predictably when disabling the gizmo.
0 # silly calvin 2020-05-01 15:06
I'm having trouble opening it in nuke, gives me an error saying "unknown command"

note: i have it in my .nuke folder and i load it by doing "Other > All plugins > Update
+1 # Rafael Perez 2020-05-02 12:37
Hi Silly. I just updated the gizmo, now it should load properly using the All Plugins > Update function. Thanks for the feedback.
0 # Nikolai Wüstemann 2020-05-02 16:02
Wow, this gives me very interesting results! Definitely a handy tool when it comes to keying various stuff.

When loading the Gizmo, my old Nuke 8.0 version gives me this error (it still works after that btw):
BlinkScript1.recompileCount: no such knob
BlinkScript1.78: no such knob
BlinkScript1.rebuild_finalise: no such knob

I always tend to develop on this old version, so my tools are downwards compatible.
+1 # Rafael Perez 2020-05-02 16:14
Hi Nikolai
I tested on Nuke 10, 11 and 12, but thanks for letting me know it works even on Nuke 8.

Give me a few days and I'll try to fix these errors you mentioned.
0 # mohamed gamal vfx 2020-06-07 11:47
thank you
0 # Will Marker 2020-08-20 20:16
thank you! very nice for getting extra detail out of mattes.
0 # Barry Wang 2020-08-28 13:45
That's really a amazing tool! Thanks!

You have no rights to post comments

We have 2345 guests and 50 members online