Skip to content

Cryptomatte

Cryptomatte
Mask

Decodes Cryptomatte ID matte data baked into a render engine’s EXR into a pickable object matte, selected by clicking directly in the preview.

A rendered beauty pass decoded through a Cryptomatte layer: every object becomes a stable pseudo-random color, giving a pixel-perfect ID matte for any element in the scene without hand-masking.
A two-panel before/after: the rendered beauty image, and a colorful pseudo-random-per-object ID mosaic decoded from the file's CryptoInstance Cryptomatte layer, where each object in the scene is a distinct flat color.

Cryptomatte turns per-pixel object, material, or asset ID data from a 3D render into a matte you build by picking, with no re-rendering. Point Cryptomatte File at a Cryptomatte-enabled EXR, or drag the file from your file manager onto the field.

The node finds the manifest whether it is embedded in the layers or saved as a sidecar JSON next to the file, and reads multipart renders, including files whose Cryptomatte layers span several EXR parts. When the file has more than one layer, such as one per object and one per material, choose which to decode with Crypto Type.

A Blender still life of a jug, vases, a bowl and fruit in the Preview, with the vase picked by Cryptomatte and tinted yellow over the dimmed render

Blender names each Cryptomatte pass after its view layer, so a render’s Crypto Type reads ViewLayer.CryptoObject, ViewLayer.CryptoMaterial, or ViewLayer.CryptoAsset (with your view layer’s name in place of ViewLayer). Pick one and the node decodes it like any other. With nothing wired into Beauty, Highlight uses the Combined pass of that same view layer, so a Blender multilayer EXR is enough on its own to see the pick against the render.

A file that declares a Cryptomatte but carries none of its passes says which type has no passes, rather than reporting that nothing is declared.

The Blender still life in Colored IDs while Add is armed, the cursor over the vase with a tooltip naming it, and the Vase entry in the Matte List

Pick directly in the preview. A hover tooltip names the object under the cursor before you click.

ToDo this
Add one objectArm Add in the panel and click, or Ctrl+Click
Remove one objectArm Remove and click, or Ctrl+Alt+Click
Add every object a rectangle touchesCtrl+Shift+drag
Remove every object a rectangle touchesCtrl+Alt+Shift+drag
Cancel an armed pick or a sweepEscape or right-click

A sweep is a single undo step however many objects it picks up. While a pick is armed, the preview switches to Colored IDs so you can see exactly what you are clicking.

The Matte List shows every selection as a removable entry, with an add-by-name field that autocompletes from the file’s manifest. With no manifest, picking still works and entries show as raw hex IDs instead of names.

Output picks what the Image output shows. The separate Matte output always carries the selection, whatever the mode.

  • Colored IDs (the default): a stable random color per object, with picked objects highlighted yellow and the rest dimmed. It shows everything in the file before you start picking.
  • Matte: the selection as a grayscale matte.
  • Highlight: the beauty image’s brightness with the selection highlighted the same way. It uses a wired Beauty input, or the beauty layer inside the same EXR when nothing is wired, so it works standalone on a production render.
  • Premultiplied: the beauty image cut out by the selection. It needs a wired Beauty input for a correct, color-managed cutout, and stays unavailable until one is connected.

Invert flips the Matte and Premultiplied results and the Matte output, never the yellow selection highlights, so picking stays legible either way.

Pins

BeautyPixels
InputOptional
ImagePixels
Output
MatteMask
Output

File

Cryptomatte FileText

Path to the source EXR carrying Cryptomatte layers (cryptomatte/<key>/name plus rank-layer header attributes)

Watch FileToggle
Default: false

Automatically reload when the file changes on disk. Checks once per second

Cryptomatte

Crypto TypeText

Which declared Cryptomatte layer to decode (CryptoObject / CryptoMaterial / CryptoAsset / ...).

Leave it empty to take the first layer found in the file.

Selection

Matte ListText
Default: []

JSON array of selected object names (from the manifest) and/or raw "<hexid>" entries, for example ["bench","character"].

Edit by hand here, or with the picking UI on the Parameters panel and the preview canvas.

Output

OutputChoice
Default: Colored IDs Range: Matte / Colored IDs / Highlight / Premultiplied

What the Image output emits, independent of the Matte pin (always the selection coverage, Invert-applied):

  • Matte: the accumulated selection as a grayscale matte.
  • Colored IDs: a stable pseudo-random color per object (the default, useful for picking); selected objects highlight yellow and unselected objects dim.
  • Highlight: the beauty image's brightness (a connected Beauty input, OVERRIDING the file's own beauty layer when one carries it, else the file's own beauty); selected objects highlight yellow and unselected areas dim.
  • Premultiplied: the connected Beauty input multiplied by the selection matte (wire one for a color-managed result); with nothing wired, falls back to the matte itself.
InvertToggle
Default: false

Invert the matte: the Matte and Premultiplied outputs and the Matte pin.

Selection highlights are never inverted.

  • Ctrl+Click and Ctrl+Alt+Click work whenever the node is selected, with no need to arm a pick first.
  • Turn on Watch File to reload the EXR automatically when a re-render overwrites it.
  • Feed the Matte output to Mask Boolean or Mask Refine to combine or clean up selections.