Matte Downloader Uninstaller Streamer TV Filter
← Back to Hoides Matte

Documentation

Install Hoides Matte, make your first matte, and look up every control in the panel.

Requirements

1. Install

  1. Download the installer: Hoides_Matte_v1.0.exe (3.5 GB). Its SHA-256 is e58449bddbb590f97fcb04954f020d869ea1740736a63b77142fcfc1fc7e92e7; in PowerShell, Get-FileHash Hoides_Matte_v1.0.exe shows yours.
  2. Run it. It installs the plugin, the AI models and the Nuke integration automatically. Leave Prepare SAM 3.1 for this graphics card ticked: Setup then readies SAM 3.1 for your GPU in a progress window (once per graphics card, usually 3 to 15 minutes), so it works the first time you pick it. You can also run it later from the Start menu: Hoides Matte → Prepare SAM 3.1 for this graphics card.
  3. Launch Nuke and press Tab → type Hoides Matte, or find it under the Hoides toolbar menu.

2. Make your first matte

  1. Connect your plate to the node's Source input and view the node.
  2. In 01 Layers, set Tool to Draw Box and drag a box around your subject. Or, in 02 Find by Text, type something like car into Describe and press Find.
  3. The matte appears straight away as layer 01. Press Play: the layer follows its subject through the shot, starting from the frame you marked it on (its reference frame).
  4. Leave 05 Edges on Refine for soft edges. Then in 06 Write Mattes choose a Folder, switch on Write While Playing and play the shot once to write every frame.

Windows SmartScreen warning? A “Windows protected your PC — unknown publisher” screen is expected for a new independent publisher. Click More info → Run anyway. You can verify the download with the SHA-256 checksum published next to it.

Two Hoides Matte nodes, or plain controls without the numbered panel? Nuke hasn't loaded the Hoides integration yet. Close Nuke and open it again; with an installer from before 13 November, restart Windows once. If your studio sets NUKE_PATH itself, add C:\Program Files\Common Files\OFX\Plugins\HoidesMatte.ofx.bundle\Contents\Resources\nuke to it. Use the node named Hoides Matte; Hoides Matte Legacy only opens scripts made with the earlier Neuro Matte.

3. Free trial

The first time you add a Hoides Matte node, your 7-day free trial starts by itself: no key, no account, no card. Every feature works, so you can test it on real shots.

When the trial ends the node shows a clearly marked disabled frame instead of mattes until a licence key is entered. Your script and layers are left as they are, and activating a key brings everything back at once.

4. Activate your licence

A licence key is made for one machine. To get and activate yours:

  1. Select a Hoides Matte node and open 08 Licence in its panel.
  2. Copy the Machine ID shown there (32 characters) and send it with your order.
  3. You receive a licence key for that machine. Paste it into Licence Key and press Activate.

Status changes to Licensed and mattes work again straight away. The key is checked on the machine itself, now and every time Nuke starts, so activation needs no internet connection. That suits firewalled facility workstations.

5. Move to another machine

Each seat runs on one machine and can move whenever you need. Email us the new machine's Machine ID and we issue a key for it; stop using the seat on the old machine.

Viewer controls & shortcuts

Layers are made and edited in the Nuke Viewer. These work whatever tool is chosen:

ActionHow
Shift + dragDraw a new box anywhere, without switching tools first
Shift + clickRemove Detail: pushes the matte out of that spot
Ctrl + clickAdd Detail: pulls that spot into the matte
Delete / BackspaceRemove the selected layer
Click a box or pointSelect it; square handles appear on a selected box
Drag a handleResize the box (the layer runs again from the current frame)

The Layers card in the top-left corner of the Viewer lists every layer:

Panel reference

The panel's sections are numbered in the order you work.

01 Layers

ControlWhat it does
Tool → Select / MoveClick to select a layer, drag handles to resize
Tool → Draw BoxDrag in the Viewer to start a new layer from a box (up to 20 layers)
Tool → Click PointClick a subject to start a new layer from a single point
Tool → Add Detail / Remove DetailClick to correct the selected layer: add what was missed, or take out spill

02 Find by Text

ControlWhat it does
Describe + FindType what to look for (“car”, “person on the left”) and press Find. The best match on the current frame becomes a new layer
Min Confidence %Matches below this are ignored (default 30). Lower it if Find reports nothing; raise it if it picks the wrong thing

03 Viewer

ShowWhat you see
PlateYour source, untouched
MatteThe matte in white on black
TintedEach layer's colour over the plate (default)
CutoutThe plate kept inside the matte (plate × alpha)
HoldoutThe plate kept outside the matte (plate × (1 − alpha))
Edge BandThe band the edge pass works in

04 Work Area

ControlWhat it does
AreaShared: one area around every layer (best for most shots). Per Layer: each layer gets its own, good for subjects far apart. Full Frame: the whole image (slowest, least detail on small subjects)
Margin %Extra room around the layers. More helps with fast motion
Steadiness %Ignores small frame-to-frame changes so the area does not jitter
Max StretchHow far the area may stretch from square for long, thin subjects
Snap Box to MatteBoxes follow the tracked matte in the Viewer instead of staying where you drew them

05 Edges

ControlWhat it does
Edge PassRefine: ViTMatte works out hair, fur and motion blur. Raw: the segmentation matte as it is, faster
Show Edge BandDraws the band over the result so you can see where the edge pass works
Soften FirstSoftens the matte slightly before the band is built; helps noisy edges
Inner Band / Outer Band (px)How far the band reaches inside and outside the matte. Widen it for hair or heavy motion blur

06 Write Mattes

ControlWhat it does
Write While PlayingWhile on, every frame that plays is written. Play through the shot once to write it all
FormatPNG (8-bit) or EXR (float)
Full 32-bit FloatEXR only; off writes 16-bit half float
File Namematte_#### by default; #### becomes the frame number
Folder + Show FolderWhere the frames go, and a button that opens it

07 Performance

ControlWhat it does
ModelSAM 2.1 (default) is fast. SAM 3.1 is Meta's newer, larger model and takes longer per frame. It runs on TensorRT and is prepared once for each graphics card: Setup does this for you (a few minutes). If that step was skipped, picking SAM 3.1 opens the preparation in its own window while Nuke stays usable. Once prepared, it loads in seconds. Switching re-tracks every layer
GPU EngineFor SAM 2.1 and the edge pass: CUDA by default. TensorRT can be faster once it has built an engine for each image size; building takes a few minutes the first time, then it is cached. Either way, Hoides Matte uses full FP32 precision on every graphics card, so mattes come out the same on GTX and RTX cards

Two tabs? The node shows a plain Hoides Matte tab and a Hoides Matte V1.0 tab. Use the V1.0 one: that is the full panel. Nuke gives every node a tab of its own that cannot be removed, which is why the first one appears.

Scripts from before the rename (the node was called Neuro Matte) open as a Hoides Matte Legacy node with every setting intact. It works the same way; the tool switch shows as five checkboxes there.

Need help?

Email [email protected] with your Machine ID and order reference and we’ll sort it out.