All notable changes to the Nuke Survival Toolkit are documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
2.2.0 - 2026-03-19
Tools (gizmos and Python)
2026
- CardToTrack (AK) v9.0
2024
- aeShadows (AE) v1.0
- FastComplexity_Distort (X_Distort)
- fxT_ChromaticAberration (fxT) v3.1
- Emission (NW) v1.2
- aeRefracTHOR (AE) v1.0
- LightSwitch (TL)
- LightSwitchPuppet template
- ChromaSmear (LJ)
- apEdgeCrush (AP)
- MirrorDimension (TL)
2023
- PointCloudKeyer (IS)
- SpotLight (TL)
- Rings of Power (TL)
- Symmetry (TL)
- SkyMatte
2022
- CardToTrack (AK) updated to v8.0 with NST_cardToTrack.py
- ID_Extractor (TL) with NST_ID_Extractor.py
- ConstantPro (TL)
- HexColor (NW)
- RadialDilate (CF)
2021
- GuidedBlur (RF)
- iErode (PP)
- aeRelight2D (AE)
- iTransform_ae (AE) — later fixed onCreate code for render farm
- ImagePlane3D_v2 (TL) v2.0
- bm_OpticalLightwrap (renamed from bm_Lightwrap)
Other
LOAD_EXPRESSION_MENUconfiguration option inmenu.pyto optionally enable or disable the Expression Nodes AG submenu (default: disabled).
- Icon assets recompressed for ~53% size reduction (~127 KB saved); no visual changes.
ColorGradientUi.pyupdated for Nuke 16+ compatibility and PySide6 migration (GradientEditor MHD).- Menu refactor:
nk_path()andicon_path()helpers, f-strings, improved readability; no user-visible behavior change. - Documentation menu now uses a
Documentationsubmenu withWiki/Docs (Auto),Wiki (Online),Wiki (Offline), andDocs (PDF)commands. The auto command now falls back in order: online wiki -> offline local wiki -> local PDF, with reachability checks and concise missing-target guidance. - Documentation (offline HTML):
Wiki/Docs (Auto)andWiki (Offline)open the bundled wiki via a localhttp://127.0.0.1static server (ephemeral port) so MkDocs Material search works; falls back tofile://if the server cannot start; browser launch is non-blocking (background thread). Reuses the same server when the offline root path is unchanged. - Added dedicated icons for documentation submenu entries (
wiki_default,wiki_online,wiki_offline) and used Nuke nativeStickyNotefor PDF. README.mdnow includes an optional offline documentation install section that points users to release ZIP downloads and the required local path (NukeSurvivalToolkit/NST_Documentation/index.html).- Updated .nk templates: NST_AdvancedKeyingTemplate_Stamps.nk, NST_X_Aton_Examples.nk, deepThickness.nk.
- New icon assets for aeRefracTHOR, aeShadows.
- EdgeDetect, GuidedBlur: corrected icons and attribution (#62).
- iMorph v2 AP (beta) added alongside v1 in menu.
- CardToTrack v9 (AK): Transform menu entries CardToTrack_v9 AK, CProject2 AK, TProject2 AK now use NST_-prefixed gizmos (NST_CardToTrack2, NST_CProject2, NST_TProject2) and NST_cardToTrack_v9.py.
Updated Tools
Nuke 13 compatibility:
- aPCard
- AutoCropTool
- DeepKeyMix
- FrameFiller
- GradMagic
- ImagePlane3D
- LumaGrain
- Matrix4x4_Inverse
- mScatterGeo
- origami
- PlanarProjection (also fixed XAton volumes example)
- Reconcile3DFast
- Relight_Simple
- ReProject_3D
- RotoCentroid
- RP_Reformat
- Sparky
- SSMesh
- viewer_render
- VoronoiGradient
Other updates:
- apeGlow (fixed overscan bug on crop knobs)
- apChroma (internal restructure)
- apChromaMergeNew (internal restructure)
- apDespill: v1 deprecated, v2 promoted as canonical —
NST_apDespill_v2.gizmorenamed toNST_apDespill.gizmo(#63) - apVignette (v0.5: added transform tab, "Apply to White Constant" option)
- bm_CameraShake (v4.0: fewer internal nodes/expressions, curve smoothness control, cleaner UI, experimental auto-motionblur beta) (#39)
- bm_OpticalGlow (v4.1: fixed mix slider with mask input, removed stale
algorithm_codeknob) (#40, #64) - bm_OpticalLightwrap (fixed mix slider with mask input, removed stale
algorithm_codeknob, defaulteffect_onlyto false, renamed menu entry and icon) (#41) - CameraNormals (updated DummyCam to v1.3)
- CellNoise (fixed onCreate center calculation)
- ColorSampler (added option to export constant)
- DeepRecolorMatte (bug fixes, ported later version)
- DummyCam (v1.3, Nuke 13/14+ Camera3 class)
- ExponGlow (fixed bug that deleted luma key when changing iterations)
- Glass (added channel support and mask input)
- InjectMatteChannel (exposed bbox knob)
- LightWrapPro (fixed bounding box in non-final view modes)
- MorphDissolve (added 0→1 / 1→0 options, STmap export)
- SimpleSSS (internal cleanup)
- SliceTool (code cleanup)
- STmapInverse (code cleanup)
- Suppress_RGBCMY (added mask and mix features)
- UV_Map (fixed overscan scaling bug)
- UV_Mapper (internal cleanup)
h_Qt.py— obsolete Qt compatibility shim (no longer needed after PySide6 migration).NST_bm_Lightwrap.gizmo— replaced by bm_OpticalLightwrap.NST_apDespill_v2.gizmo— renamed toNST_apDespill.gizmo(v2 promoted as canonical).- GlobalCTRL, AnamorphicLensBlur — removed from toolkit (no menu entry, not maintained).
- Duplicate
NST_ImagePlane3D_v2.gizmo— identical to v1, single copy retained.
- CellNoise: Blink kernel compile errors on Nuke 15+ (moved globals to #define, replaced abs() with signedness check) (#36).
- apEdgeCrush: BlinkScript compile error on Nuke 16 — replaced global inline
lerp()with#definemacro (#59). - Windows filepath issues: use
Path.as_posix()for all toolkit paths so forward slashes are used on every platform, avoiding backslash escape sequences (e.g.\nin\nk_files) that brokenuke.nodePaste()and file knobs on Windows. - Help documentation link on Windows: use
Path.as_uri()for the documentation PDF URL so drive-letter paths open correctly in the browser. - Documentation online reachability check now handles environments where Python SSL certificate validation fails, preventing false fallback from online docs to PDF.
- Offline MkDocs search was unreliable when the wiki was opened as
file://— mitigated by serving the same folder over localhost when launching from Nuke (Wiki/Docs (Auto) / Wiki (Offline)). - Node class check in
filepathCreateNode: use tuple membership instead of chainedorfor file-node detection (#46). - Replaced bare
except:clauses with specific exception handling (ImportError, RuntimeError) for ColorGradientUi, VectorTracker, and NST_cardToTrack imports (#45). - Menu: corrected bm_Lightwrap node name to bm_OpticalLightwrap (#61).
- Menu: replaced broken DeepToPosition TL with Deep2VPosition MJT (#60).
- Issue #43:
NST_FolderPathis defined insideNST_helper(from__file__) instead of being assigned frommenu.py, so the helper does not depend onmenu.pyhaving run first and avoids import-orderNameErrorrisk.
2.1.1 - 2021-05-19
- Updated NST_ImagePlane3D, NST_apDespill_v2, NST_FrameHoldSpecial gizmos.
- Updated deepThickness.nk script.
2.1.0 - 2021-04-28
Tools (gizmos and Python)
2021
- BokehBuilder (KB)
- LensEngine (KB)
- RankFilter (JP)
- MotionBlurPaint (AG)
- RotoPaintTransform (AG)
- Deep2VP (MJT)
- DVPColorCorrect (MJT)
- DVP_Shader (MJT)
- DVP_ToonShader (MJT)
- DVPrelightPT (MJT)
- DVPortal (MJT)
- FrameHoldSpecial (AG)
- InverseMatrix33 (MJT)
- InverseMatrix44 (MJT)
- apDespill v2 (AP)
- MonochromePlus (CF)
2020
- iMorph v2 (AP)
- LabelFromRead (TL)
- Unify3DCoordinate (MJT)
- SceneDepthCalculator (MJT)
- DasGrain (FH)
- Looper (DB)
- HeatWave (DB)
Other
- New documentation.
- NST_ImagePlane3D, NST_GradMagic, NST_iMorph updates.
- Menu structure updates.
2.0.0 - 2021-03-29
Tools (gizmos and Python)
2021
- GodRaysProjector (CF)
- MonochromePlus (CF)
- RainMaker (MR)
2020
- ImagePlane3D (TL) v2.0
- FrameFiller (MJT)
- Edge (RB)
- Reconcile3DFast (DR)
- GlueP (LS)
- AutoFlare2 (NKPD)
- DeepMerge_Advanced (BM)
- bm_MatteCheck (BM)
- bm_NoiseGen (BM)
- bm_Lightwrap (BM)
- SimpleSSS (MHD)
- KeyChew (NKPD)
- AdditiveKeyerPro (TL)
- apeGlow (AP)
- iBlurU (NKPD)
- DeepFromDepth
Other
- ReadGeo class support in NST_helper.
- PerspectiveBB reset points button.
- UV_Map, injectChannelMatte tab rename.
- Menu restructure and submenus.
- Nuke 13 compatibility updates across multiple gizmos.
- Major init.py restructure.
- Documentation updates.
- ImagePlane3D crop1, DirectionalBlur CopyBBox, bm_MatteCheck grey_amt.
- Menu bugs.
- NST_Reconcile3DFast.
1.1.1 - 2020-10-05
- Updated NST_AutoFlare2 gizmo.
1.1.0 - 2020-10-04
Tools (gizmos and Python)
- AutoFlare2 (NKPD)
- FrameFiller (MJT)
- Edge (RB)
- Reconcile3DFast (DR)
- GlueP (LS)
- DeepMerge_Advanced (BM)
- bm_MatteCheck (BM)
- bm_NoiseGen (BM)
- bm_CurveRemapper (BM)
- bm_Lightwrap (BM)
- SimpleSSS (MHD)
- KeyChew (NKPD)
- Dev branch merge; bm_Lightwrap replaced prior NST_bm_Lightwrap; various tool updates.
1.0.1 - 2020-09-26
- Sparky DB updated to v1.5.
- README updates.
1.0.0 - 2020-09-23
Tools (gizmos and Python)
- Initial curated gizmo collection.
Other
- Portable tool menu for Foundry Nuke.
- Installation via init.py plugin path.