Skip to content

Installation

This page will give an explanation on how to install MagicDefocus2.

Before you start, please make sure all your drivers are up-to-date.

Installation is the same on each operating system, as each download will contain all supported Nuke versions + all operating systems. This is all included in one package.

It is similar to any gizmo install that you've probably done previously.

Extracting the download

Extract the downloaded zip file to a location you'd like to install the plugin. This can be anything, but it is common to use the .nuke folder.

This folder can be found here:

  • C:\Users\Your Username\.nuke

  • ~/.nuke

  • /Users/YourUsername/.nuke

For more information from the Foundry visit their documentation: https://support.foundry.com/hc/en-us/articles/207271649-Q100048-Locating-the-default-nuke-directory

init.py installation

If there is no init.py file in your .nuke folder, simply copy the one provided in the downloaded zip file and you're done!

Else, copy the following contents into your init.py file: 

nuke.pluginAddPath("./magicdefocus2")

If you've chosen to install MagicDefocus into a different location than the .nuke folder, adjust the path to the absolute path of the installation directory:

nuke.pluginAddPath("the/path/to/the/installation/here")

Environment variable installation (alternative)

This is an alternative approach, without modifying the init.py, but by setting the NUKE_PATH environment variable.

  1. Add a NUKE_PATH environment variable to your system.
  2. Set the value to the absolute path to the inside of the magicdefocus2 folder. E.g. my/path/to/my_installation/magicdefocus2/

Installation successful 🎉

If installation succeeded, you will be greeted by a purple hat in the Nuke menu bar.

installation success

Next-up : installing the node-locked or floating license.

Common issues

Windows

There might be this warning when the license manager is opened (VCRUNTIME140.dll is missing):

VCRuntime140.dll

This is due to Microsoft Visual C++ Redistributables not being installed. You can install them from their website: Visual C++ Redistributable for Visual Studio 2015