Released by Jens Kafitz, 2022 -   | Join us on ,or

RELEASED ON:   August 17, 2022

LAST PATCH ON: May 3rd, 2023 - 5R9.v8

BACKWARDS COMPATIBLE TO: Extension Pack 5 + 5 R2 - 5 R8  

MINIMUM REQUIREMENT (for Mari 4.x):  MARI 4.1v2

MINIMUM REQUIREMENT (for Mari 5.x):  MARI 5.0v3

RECOMMENDED (for Mari 4.x):  Mari 4.7v7 or Mari 4.8v3 or higher

RECOMMENDED (for Mari 5.x):  Mari 5.0v3 or higher

Mari Non-Commercial  is not supported due to restrictions by the Foundry

Mari 6.x  is not supported due to changes in Python Versions



New Feature       Feature Update       Feature available in Nodegraph only    

Mari 4.7 or higher Mari 4.8 or higher   Mari 5.0 or higher   


  • Welcome to Mari Extension Pack 5 R9, the 10th free update of the 5-Series and biggest R-Releases ever in the 5-Series.

    Extension Pack 5 R9 is a major rewrite, updating the Plugin to Python 3.7.7 and QT 5.12.

This version is compatible with both Mari 4.x and Mari 5.x via separate installers

Dozens of new features aimed at improving the User Experience and nearly 60 bugfixes round of this big release - and despite its massive size,

it remains a free upgrade to existing Mari Extension Pack 5 Customers !

For a full overview of the features released in Extension Pack 5 see each dedicated release notes.


Mari 5.x Support

  • Extension Pack 5 R9 has been rewritten to support Python 3.7.7 and QT 5.12, making it compatible with Mari 5.x versions.
  • Extension Pack 5 R9 now ships in a Mari 4.x and a Mari 5.x version
  • By removing legacy compatibility checks for the Mari 5.x Version of Extension Pack 5 R9, multiple tools and nodes will now run faster

Image Manager

  • A new sub-menu 'Open with' has been added to the Image Manager Right Mouse Click Menu.
    It allows you to open an image in 

    • Your File Browser
    • The OS default application associated to the File Format
    • Up to 10 freely configurable applications

By default, if found on your System, Photoshop and Krita will be added to the Application list.

Example of using Open in App in combination with Reload to quickly edit Tileable Textures in Photoshop

  • Auto Reloading changed images from Disc now runs up to 2x faster

Drag & Drop Enhancements

  •  Drag & Dropping an image from Image Manager to the Nodegraph and selecting a Node Type will now auto rename the new node with the format


Example of an automatically named node on creation

  • Drag & Dropping an image containing a UDIM Number in its name/path to Layerstack or Nodegraph, then selecting the 'Image' Node Type, will now
    create an image node that is pre-configured to place the image only in the one UDIM.

    Example of Automatic placement of an 'Image' Node in UDIMs, when the dragged Image contained a UDIM Number

  • In Mari 4.8 or higher, creating more than one Node via a drag and drop action now auto aligns the nodes and sets the port list mode to collapsed

  • In Mari 4.8 or higher, dragging more than 3 images into the Nodegraph or Layerstack, now also allows you to directly create and ingest into Extension pack Material Templates or any material you yourself added to the Shelf.

New Procedural Pattern Nodes

A total of 6 new procedural nodes have been added

Some Examples produced with the Hexagon Node

Some Examples produced with the Polygon Soft Node

Some Examples produced with the Polygon Node

  • Example Looks for Polygon and Hexagon Nodes have been added to the Procedural Tab of the Mask Shelf.

Infinity Tiling

  • A new Node Tiled Infinity was added in Mari 4.6v2 or higher.

    Infinity Tiling will apply a texture to the UVs based on a Hex Grid, with each Cell having a different sample point of the
    original texture, hiding any repeating pattern when tiled.

    The node will work best with input textures that have a chaotic appearance and does not work well with geometric shapes.

Comparison of the same Texture applied via a standard Tiled Node vs the new Tiled Infinity Node

Example of toggling a material template to use infinity tiling

Quicker Layering of multiple Nodes

  • Selecting more than 3 nodes and pressing the 'M' Hotkey to execute a Smart Merge Command will now layer the nodes together using MultiMixer Nodes

Paint & Image Reloading

  • A new 'Reload Paint' Option has been added. Reload Paint is capable of

    • Reloading Paint Node Image Data from their Path on Disc
    • Reloading Image Manager Files for Nodes with Images
    • Reloading Bake Point Data fed into a Node via a 'Bake Point Image' Port
    • Reloading Geo Channels of selected Geo Channel Nodes

  • Paint Node 'Import' and 'Export' Options have been renamed to 'Import Paint' and 'Export Paint'

Set Project Paths

A number of small Improvements have been made to the Set Project Paths Tool:

  • The currently set path for each Variable is now more clearly visible in a separate 'Currently Set' field

  • Quick Tips have been added to the bottom of the UI


  • Python Scripts associated to Hotbox Buttons in Mari 5.x, now require a 

    import mari

    line in their python code, if calling the Mari Python API from within the script, since the parenting of the processes has changed.

    Mari 4.x behavior of Python invoking Hotbox Buttons remains unchanged.

Open Export Locations in File Browser

Substance Bridge

  • The Substance Baker Bridge now supports using Adobe Substance Designer instead of Substance Automation Toolkit for Baking (requires Substance Designer 12.1 or later)

    You can now use either "Substance Automation Toolkit" or "Adobe Substance 3D Designer" (12.1 or higher)
     with the Mari/Substance Baker Bridge !

The 'Transferred Texture from Mesh' Baker currently does not support UDIM Sequences as a Baking Source due to limitations on the Substance Side

Automatic addition of HDRIs to Shelf

Extension Pack enables the user to easily change the Environment Image by dragging an EXR or HDR file to the Canvas. 

To facilitate this workflow. a series of HDRIs are now automatically added to the Mari Shelf in a folder 'Enviornments' in Mari 4.7 or higher.

Extension Pack will now auto create HDRI Shelves for you.

  • Mari's own HDRIs from its installation Folder are automatically loaded into a sorted shelf on startup (can be disabled via Environment Variables)

  • HDRIs from other applications, if found on your computer, are automatically loaded into a sorted shelf on startup (can be disabled via Environment Variables)

  • Any Folder specified in the Paths / Environments Section of the Mari preference will be automatically loaded into shelves under the 'Environments' Group

Easier Access to Projection Modes

  • Projection Modes (Front / Through) and Projection Target (All / Selected) are now exposed as UI Buttons. 
    Which Projection Modes to show and which Toolbar to add them to, is configurable in the Mari Preferences / Painting Tab

  • Toggling between 'Project: Front' and 'Project: Through' is now mapped to [CTRL+F] by default, unless that hotkey is already in use or the action has
    already a user shortcut

Dynamic Paint Buffer Bit Depth

  • Mari Extension Pack allowed previously to link the Paint Buffers Bit Depth to the current channel selection. 
    This has now been extended to work with your active Paint Target, meaning it will work even with Paint Nodes in the Nodegraph.

    As was the case previously the option can be found on the Toolbar Properties of the Transform Paint tool but has been renamed to 'Link Depth to Paint Target'


  • 'Focus Channel Content' if run on a channel containing Materials (shared by multiple channels), will now filter the node selection to only include
    nodes that contribute to the selected channel

  • A new option 'Focus Channel Content (stop after Radios)' has been added to the Right Mouse Click / Nodegraph Menu in the Channels Palette.
    It will only select and frame channel contents in the Nodegraph, up to and including radio nodes, but not include input connections of radio nodes.

Resolution Templates

  • Saving and reapplying of UDIM Layout Resolution Templates is now available in all Patch Resize Menus (e.g. Patches / Resize Patches, Channel / Resize etc.).
    It now supports both channels and nodes (paint nodes, bake points etc.) for storing and reapplying custom UDIM Resolution Layouts

One Click opening of Node Properties

Single Click Node Properties are off by default and you need to activate it yourself in the preferences

Radio Transmitters

  • In Mari 4.7 or higher, Radio Transmitter Nodes now auto inherit the Name of the Node they are connected to, unless the transmitter has been manually renamed

  • Whenever a Radio Transmitter Input is updated, the connected Radio Node Names are now updated to prevent Radio Node Names from going out of date

Swap Nodes/Layers

A number of improvements have been made to the Swap Node / Swap Layer Tool in Mari 5.x

  • Swap Node or Swap Layer with any Material selected, now shows all Materials from the Shelf, as options to swap to.

  • Swap Node or Swap Layer with a standard Nodetype selected, now shows Custom Procedurals from your shelf as well, as options to swap to.

Swap Node Type / Layer Type has many special behaviors, depending on the selected node type.
Please refer to the dedicated help for Swap Node Type / Swap Layer Type to learn more.

Patch Bake to Image Manager

  • Patch Bake to Image Manager now supports both Layerstack and Nodegraph Patch Extraction. If your current selection is inconclusive, you will
    be prompted to specify what to Bake

Quicker Access to Colorspaces

If you ever worked with an ACES Colorspace Configuration file, you know how long the list of available configurations is.

  • All Extension Pack Tools allowing color space selection now use a filtered dropdown box, giving you quicker access to the desired colorspace

No more browsing through long lists of colorspaces 

Quicker Access to Lights

Extension Pack already allows you to change the Light Rotation via Hotkeys without having to go to the Lights Palette. 

With Extension Pack 5 R9 a new default Hotbox is added to the F4 Hotkey , allowing you to 

    • Rotate Lights
    • Change Light Intensity
    • Toggle the Background and change its Blurring
    • Toggle Shadows


  • A new Sync Channel Selection Option has been added to the Channels Palette, which will sync your current channel selection across all objects.

  • Screenshot all Channels now has its own settings dialog and syncs the channel selection across all objects in your scene.

  • You can now mark multiple image manager images as reference images so they are excluded from the Remove Unused Images Tool

  • Smart Rename when run on Bake Points with Filters, now applies the Filter Name to the Bake Point

  • Channel Component Selection has been added to the gl_cross Node

  • Added a mask port to the  Grade+ Node, to mask out the grading effect without the need for extra nodes

  • In Mari 5, Extension Pack now saves and restores the current Root Nodegraph Position and Zoomlevel per Project

  • In Mari 5, Extension Pack now manages the Nodegraph Tabs on a per Object Level. Open Nodegraph Tabs that do not belong to the current Object
    are closed and previously open Tabs belonging to the active object are reopened

  • Windows TDR Checks on Mari Startup can now be permanently disabled via the Environment Variable MARI_EP_PREVENT_TDR_CHECK

  • Python Tools are now available in the Main WIndow / Python Menu.

  • The following Node types have been added to the list of nodes, accepted by the Mari Material Ingest Tool, when ingesting into a Material Template.
    This in in addition to all other Node types already supported by Mari itself as well as Extension Pack.

The Material Ingest Tool can dynamically fill nodes with images, if the node name corresponds to the Material Stream Name.
By default Mari only supports nodes of type Triplanar and Tiled.

Extension Pack already added support for other nodes in the past and this version adds additional missing node types

    • Sphere Map
    • Sphere Map Projector
    • Flow
    • Camera Projection


Crashes with Locators

  • Fixed a Mari Crash when repeatedly switching back and forth between a dynamic locator and an object

Crashes with Export Manager

  • Channels created using the Channels from Node Tool, would crash Mari when exported using the standard Mari Export Manager.
    (they would export fine using Extension Pack's Exporter)

Substance Baker Bridge

A number of smaller fixes have been made to the Substance Baker Bridge:

  • Reset Buttons on Sliders in some Baker Settings were cut off by the dialog borders and not easily clickable

  • Setting the 'Ignore Backface' Setting in the 'Ambient Occlusion from Mesh' Baker to 'From High Def Mesh Settings, while simultaneously having
    'Self Occlusion' on 'Always', would generate a thicker occlusion than expected.
    To avoid this, the 'Self Occlusion' Setting will now be forced to 'From High Def Mesh' as well, if the 'Self Occlusion' Setting is set to 'From High Def Mesh Setting'

  • Having the 'World Space Normal' Baker as part of a preset (manually created or automatically maintained presets e.g. 'Last Used Settings'), would cause an
    error when loading the preset

Node Rename

  • The Node Multi Rename Tool's Search and Replace Function and Remove Suffix Function no longer worked

  • Smart Rename Nodes no longer ignored Dot Nodes in Mari 4.7 and higher


  • Quick Unproject Tools would give a deprecation warning in the python console, due to colorspace handling changes in some Mari Versions

  • Quick Unproject from View would incorrectly set the resulting Image colorspace to 'Mari Working Color Space'

Missing Icons on Linux

  • Default Object 'Cylinder' was missing an icon on Linux

  • Some dialogs with Preset fields, were not displaying the 'Rename' Icon on Linux

  • The Mask Shelf was missing the 'Reset Filter' Icon on Linux

Channel Layers

Duplicate Channels

  • Duplicate Channel would not rebuild all 'Shared Layers' if a Material Layer was present in the duplicated channel

Gabor Noise

  • The Gabor Noise, when created in a Layerstack, was incorrectly creating a connection from the Layer beneath to the 'Manifold' Port of the Node

Triplanar Nodes

Material ID from Selection Groups

  • Channels created by Material ID from Selection Groups were not tagged as Scalar by default

  • It was possible to select 'Geo Channels' as targets, in Mari Versions were Geo Channels not yet existed as a feature

Patch Bake to Image Manager

  • The resulting Image from a Patch Bake to Image Manager Operation did not always have the same color space settings as the source channel
    it was baked from

Jump to Node

  • Jump to Node Input printed an error in the Python Console when there was no node connected to any input port

Height Blend

  • Height Blend did not auto connect to selected Materials when the materials displacement output port was not called 'Disp'

  • Height Blend did not auto connect to the Mask of a Multi Channel Merge Node, if one of the selected materials to blend, had the 'Current Material' Viewer attached to it

Tiled (Extended)

  • Certain combinations of Rotation and Mirroring in the Tiled (Extended) Node, could break Normal Map Reorientation

Clone Stamp Tool

dragged to the Canvas. The Paint Through Tool will now no longer auto activate, when the current tool is the 'Clone Stamp' Tool.

Swap Node/Layer Type

  • Using Swap Nodes to swap between Material Templates no longer transferred all attributes

  • Using Swap Nodes to swap between Material Templates did not always correctly convert between Roughness and Glossiness. 

  • The resulting Node Name of a Swap Nodes/Layer Operation could be overly long when swapping some standard Mari Nodes

  • Swapping from an 'Unreal' Material Template to another Shader Model left the 'Unreal' Tag in the Node Name.

Copy/Paste Layer Attributes

Radio Nodes

  • Inserting a new node between a Radio Transmitter and a connected Radio Node did not update the Radio Node's Label to reflect that the Radio
    Connection had changed

Function Nodes

The change only has an effect on newly created versions of the Node.

Material Templates

  • If Material Templates were located in a non-writable location, Mari would print out several error messages on Mari Startup

Image Manager

  • Remove Unused Images would not remove an unused image, if another copy of the identical image was in the image manager and in use in a node.

  • Export Selection did not open the File Browser in the Default Location set for Images/References 

  • Auto Reloading changed Images from Disc would sometimes load in multiple copies of the image

Duplicate & Flatten Channels

Export Custom Channel Selection

Nodegraph Grid Snapping

  • Extension Pack was forcing the Nodegraph Grid Width and Height Preferences to 0,  if Mari was launched with factory-settings, causing

a Crash when toggling the Grid on

  • Extension Pack was forcing the 'Show Grid' option to off on each Mari Restart.

Channels from Node

  • Creating a new Channel Preset in Channels from Node Tool no longer worked in Mari 4.8

  • There were overlapping UI elements when using an OCIO Colorspace File with very long Colorspace names (e.g. ACES)


  • Fixed a crash when caching a Node via the Nodegraph


  • In Mari 4.8, some sliders and check boxes of the default Hotbox 'Brush Settings' no longer had an effect

  • With certain Hotbox Settings, typing in a Hotbox Slider Value field would print out errors in the Python Console 

Drag & Drop

  • In Mari 4.8, Images imported into a shelf via the 'Import Items' Right Mouse Click Menu, did not work with Extension Pack's Drag and Drop Actions
    (e.g. Drag to Nodegraph, drag to Canvas etc.)

  • In Mari 4.8, dragging more than one Image from the Image Manager to the Nodegraph or Layerstack did not create multiple Node Instances.

Bake Point Images

  • Nodes with a 'Bake Point Image' Input Port no longer auto inherited images from connected bake points in Mari 4.8



  • Loading or resetting View Layouts would remove custom Extension Pack UI Buttons like the Substance Baker Bridge.
    Fix requires Mari 4.8v3 or higher.


5 R9.v2 - August 20th, 2022

  • Loading of custom Environment Map Paths on Mari Startup could fail and hang if Thumbnail or Cache Data was contained in the Folder

  • In Mari 5, the Light Hotbox kept resetting itself to the default F4 Hotkey on Mari restart, even when changed by the User

5 R9.v3 - September 5th, 2022

  • Licensing the Mari 4 Version of Extension Pack 5 R9 via Environment Variable no longer worked and could cause Extension Pack 5R9 to not load

  • Some files on Linux had incorrect permissions when written

  • In some cases Material Template installation on Mari Startup could get stuck in a loop

  • Reload Paint can now reload Geo Channels

5 R9.v4 - September 25th, 2022

  • On Windows Machines, pointing the Environment Variable MARI_EP_LICENSE_FILE_PATH directly to a (unmounted) network location no longer worked

and required network drive mounting as workarounds.

  • Drag and Drop of Images from Shelf to Layerstack no longer worked in Mari 4.7 Versions

  • Dragging a manually imported Shelf Image into Layerstack or Nodegraph would print a python error.

5 R9.v5 - November 23rd, 2022

  • Some Image Types from the shelf could cause an 'Image not Found' error when applied to a Node via Drag & Drop

  • Adding more than 7 Applications to the 'Open with ...' Image Manager dialog did not work and would cause Mari to error on start

  • In some cases using 'Align Nodes' would stop the Undo History Recording

  • Indie and Freelance Licenses were incorrectly identified as Studio Licenses in the Licensing Dialog.

  • In Mari 5, the Hotbox 'Aiming' no longer pre-selected a button unless the aiming line was crossing a button or the cursor was over the button.

  • mari.ExtensionPack.node.getNodeCategory() would error on certain nodes

  • For Mari 4.8 and higher, a warning has been added when trying to use a Bake Point Image Port while your current geo does not have a UDIM 1001

  • Additional Log Info and Solutions were added, when the user encountered a SSL Certificate error during licensing

5 R9.v6 - January 16th, 2023

  • Saved custom Brushes were deleted from the shelf on each Mari restart

  • The Environment Variables MARI_EP_PREVENT_MARI_HDRI_LOADING and MARI_EP_PREVENT_3RDPARTY_HDRI_LOADING were no longer respected

  • Node Align Right could give a python error in some cases

  • Some Extension Pack Dialogs (e.g. Connect to Radio Transmitter) had their contents cut off when setting a larger custom font size via the Mari Preferences 

  • Patch Bake to Image Manager could fail if the node to bake had characters in its name that the operation system cannot write into a filename

  • Due to a Mari Bug, some tools were showing already deleted channels (e.g. Channel Exporter). Interacting with those deleted channels could cause Mari to crash.
    A workaround for the bug has been implemented to prevent these Channels from appearing in Extension Pack tools.

  • In Mari 5, Node Align Right sometimes aligned nodes to the 'average center' of the node selection instead of the far right.

  • In Mari 5, the 'Garbage Collection' command in the Extension Pack / Project Menu gave a python error

5 R9.v7 - April 21st, 2023

  • The Text Tool registered to the Mari Tools Toolbar caused a segmentation fault crash on Mari Exit. Until a fix is supplied by the Foundry, the Text
    Tool has been relocated to the Extension Pack Toolbar. You can also use on the other Tools Toolbar Layouts shipping with Extension Pack ,which still include the Text Tool.

  • Extension Pack Actions registered to the Right Mouse Click Context Menu of the Image Manager could cause a segmentation fault crash on Mari Exit

  • Export Custom Channel Selection could error and hang when no "Raw" or "Utility - Raw" Colorspace was found in your OCIO file.
    Extension Pack will now try to resolve this issue on its own, and if unable give you a warning message

  • Export Custom Channel Selection could error and hang when processing Bake Points containing invalid, non-existent UDIM NUmbers in their Bake Range

  • [MARI 4.8+] Export Custom Channel Selection would export the wrong channel information, if the the channel to export was connected to a multiChannel Output Node,
    and an export mode other than "Full Resolution" and "Default Bit Depth" was chosen

  • [MARI 4.7] Dragging an Image from the Image Manager to a Layerstack no longer created a new Layer, even after selecting a layer type from the popup dialog

  • Dragging items from the Mask Shelf into the Nodegraph would sometimes place the preset at the inverted nodegraph position (e.g. Y Coordinate of 1000 would become -1000)

  • when multiple users were using Mari on one machine, file ownership clashes could prevent Extension Pack from loading

  • Deleting a single Mari Default HDRI Image from the Shelf would install that previously deleted HDR over and over on each Mari restart, creating duplicates

  • The "Setting up Extension Pack" Progress Bar got launched with "Installation of Mari HDRIs" even if all Mari HDRIs were already installed (the progress bar went straight to 100% percent completion though). Extension Pack will now check first if showing the progress bar is necessary for default Mari HDRIs

  • The "Setting up Extension Pack" Progress Bar would not close until after the Extension Pack Splash Screen was closed

  • mari.ExtensionPack.bakePoints.smartBakeHierarchy() Python method produced an error

  • [MARI 5+, LINUX] The SSL_CERT_FILE Environment Variable is now automatically set for the environment, Mari is run in, if the OS SSL Certificate is located at
    This is to avoid licensing issues that have come up in the past, because of Mari's built in, outdated SSL Certificate shipping with its Linux Version.
    If you already have set a SSL_CERT_FILE Environment Variable no action is taken.

5 R9.v8 (Hotfix) - May 3rd, 2023

  • The previous fix to the application crash on exit had to be partially reverted, as it introduced mid-session crashes when interacting with the Mari Image Manager


  • If you have previously downloaded the Help Files for offline usage you should replace it with the new one using the method described here