Release Notes

3.3.0 12 August 2026

Mask memory — the headline of this release

• The tracked-mask cache now holds roughly 90× more. Masks are stored compressed: a 6K frame takes about 1 MB instead of 59. Within the same memory budget the cache holds on the order of 12,000 frames instead of about 130 — long shots no longer evict themselves, and masks stop disappearing when you scrub back.
• Cache size is set in gigabytes. In the Memory and Undo group: Tracked Mask RAM (GB) — what you set is what you get. The previous percentage setting hit a hidden ceiling on large machines, leaving only two of its thirty-six positions meaningful.
• A warning when the cache runs short. If frames start being evicted during tracking, a warning appears right away rather than after you find a hole in a finished range.
• The init frame is never evicted from the cache, so tracking keeps its anchor.
• Baking no longer writes empty frames to disk. A frame evicted from the cache could previously be written out black and carry a valid signature — meaning it read back as correct next time the project was opened.

Working with objects

• Object letters no longer shift. A label is assigned when the object is created and stays with it: delete A from A B C D and the others keep their letters, while the next new object gets E. Labels used to be recomputed from the list of live objects, so deleting one silently renamed the rest.
• Text search: the threshold slider no longer recreates objects. Moving Score threshold reconciles the new detections against what is already there: matching objects keep their letter, colour, edits and tracking memory. Every slider move used to wipe the whole set and build it again — hence the long wait and the runaway labels.
• Text search: a new shot finds its own objects. A detection result is now tied to the frame's image, not just to its number and the word. A second node using the same word on the same frame number could previously receive boxes from the first shot.

Flame

• Boxes drag smoothly. Dragging no longer waits on a frame recompute: the box updates about three and a half times more often, and it no longer slows down with each additional object.
• Bake range counts frames the way the host's timeline does. A range of 50-100 bakes exactly 50-100; previously the first frame was skipped and one extra was added at the end. The frame number in the baked file name now matches what Flame shows as well.
• ⚠️ Because of this, baked file names have shifted — delete old cache folders on Flame before re-baking, or one folder will end up holding two numbering schemes.

Other

• Linux: the log no longer reports a server start that did not happen. A failed launch is now recorded as a refusal with the system's reason.

3.2.3 8 August 2026

• macOS: macOS 15 Sequoia or newer is required. The requirement previously stated 14 in error: on 14 the models cannot be compiled and no mask appears at all.
• macOS: a normal, double-click installer. Instead of Terminal commands, a disk image with an installer: welcome, licence, Install, one password prompt. The previous version is removed automatically; your licence and model cache are kept. Close your host before installing; if it was open, restart it — otherwise it keeps the previous version in memory.
• Fixed: in Flame, boxes and points sometimes were not drawn. When a node that had been showing the overlay was deleted or replaced, the right to draw stayed with it and the next node responded neither to drawing nor to the mouse; clicking another node and back was the only cure. Most common for users with many OFX plugins installed.
• Fixed: a warning about busy video memory could stay on screen. Waiting for the server is now bounded in time.
• The log survives and says more. It used to be wiped entirely when it outgrew its cap — newest session included; now only the oldest entries are dropped. Each session starts with the machine, the version and an integrity check, and refusals name their reason — so the answer is usually already in the files you send to support.

3.2.2 5 August 2026

• Fixed: the plugin would not open in Flame 2025. The node could be added but stayed empty — no parameters appeared, and Flame's status line read "Plugin com.onyx.aimatte3 not found". While creating the node the plugin restored internal bake state, and on Flame 2025 that step aborted node creation entirely. It no longer can — the node opens, and the state is picked up on the first render instead. Flame 2026 and 2027, Nuke, DaVinci Resolve, Fusion and Natron were never affected.
• Diagnostics for node-creation failures. If a host ever refuses to hand the plugin a parameter or an input, the log now names it in a single line — previously nothing was visible at all.

3.2.1 5 August 2026

• Documentation opens straight from the plugin — and works offline. A new Open Documentation button in the Help and Diagnostics group (formerly Server Tools). It opens the copy of the manual installed with the plugin, so it is available on machines with no internet access; if that copy is missing, onyxofx.com/docs opens instead.
• The Server Tools group is now Help and Diagnostics — it still holds the plugin version, the logs folder and detailed logging.
• Licence texts reviewed. The current TensorRT licence edition is now included, wording in the rights section was clarified, and third-party licences were brought in line with what actually ships.

3.2.0 3 August 2026

• macOS support (Apple Silicon). The plugin now runs on Mac — in Nuke, DaVinci Resolve and Flame. Inference runs on Apple's built-in neural engine; no separate GPU required.
• Flame support (Autodesk) — macOS & Linux.
• The Mac build is notarised by Apple — no system warnings on install.

3.1.6 25 July 2026

• Reliable mask writes to disk (Freeze). A write failure no longer loses the frame — it retries automatically, and if the folder is momentarily busy (antivirus, indexer) the write still goes through without destroying the already-finished frame. The failure reason is now written to the log (stage + system message). The red "CANNOT WRITE TO CACHE FOLDER" plate now shows only on a real persistent folder problem, not on a one-off glitch (false alarm removed).
• Fixed a rare host crash when saving a mask to EXR.
• New: red "SOURCE INPUT NOT CONNECTED" plate. When the node has no input wired, a centered warning appears — so a missing mask is not mistaken for a bug. The node stays usable: you can still draw boxes and points, and the plate clears the moment an input is connected.

3.1.5 24 July 2026

• Fixed a silent bake loss on a bad cache folder. A path that cannot be used (a missing drive, a folder with no write permission) used to turn Freeze on while nothing was written to disk. Freeze now checks the path: a dialog names the path and the reason and offers to pick another. Relative paths are allowed. If the folder exists but writes fail (read-only, full disk, network drop), a red "CANNOT WRITE TO CACHE FOLDER" plate shows and clears itself once a write succeeds.
• Object panel: per-node position, panels no longer stack. Several nodes used to pile their panels in one spot — the one underneath was hidden. Each node now remembers its own place and new nodes cascade down-left. Works in both modes, with and without "Pin". The position is saved in the project.

3.1.4 23 July 2026

• Bake the cache by frame range (Freeze → "Limit Bake to Frame Range" + "Bake From / Bake To"). Right under the Freeze button, a checkbox and two fields: when on, only frames inside the range are baked and shown, and frames outside the range pass the source through (no inference runs, nothing is written to disk). Bake a shot in sections into ONE folder — one node bakes frames 1–100, a second node with the same Name Prefix and Cache Folder bakes 101–200; the halves join on disk (read the assembled sequence back with an ordinary Read node). Enabling it sets the range to the scene's init frame (where the object was seeded) — extend it by hand. Tracking banners are suppressed outside the range. The "Overwrite baked masks?" prompt is now range-aware: it does NOT warn when the node writes to frames not yet in the folder (baking in sections), and it honestly states what it MAY overwrite versus what it keeps.
• Object Tools: the active tool is now grayed out and cannot be toggled off by clicking it again. Previously, clicking the already-selected tool could clear its checkbox or lag (needing several clicks). The active tool is now non-clickable, so exactly one tool is always selected.
• Fixed: white alpha on no-mask frames in Matte Overlay / RGB modes. With a partial Freeze bake, after reopening the project, frames with no baked mask (outside the baked range) showed alpha = 1 (white) instead of empty. Now, where there is no mask, alpha = 0 (black / transparent) as it should be. "Matte Only" was already correct.

3.1.3 19 July 2026

• New "Reset Track" button (Scene Cleanup group). Clears only the tracking — the AI's computed masks and memory — for a clean re-track from the init frame when a track went wrong after re-seeding or refining. Objects, seed points and refines are kept (unlike Reset Scene, which removes objects). Does not touch the Bake cache; grayed out while Bake is on.
• Object panel and boxes stay visible off the tracked range. Under the "GO TO INIT" banner (e.g. after duplicating a node), the object panel, the AI CROP badge and the object boxes now stay on screen — the panel's Reset button is reachable, and the badge and boxes no longer flicker.
• Red "GPU NOT SUPPORTED" banner on an unsupported GPU. If the card cannot run the plugin (no NVIDIA CUDA GPU, or a card older than RTX 2060 / pre-Turing), a red "GPU NOT SUPPORTED" banner with the detected card name appears in the center of the viewer. It is a warning — the node stays usable — so it is clear why there is no result (previously the plugin fell back to CPU silently). No banner on a supported RTX 2060+.

3.1.2 19 July 2026

• Correct handling of anamorphic material in Fusion. For non-square-pixel material (PAR ≠ 1) in Fusion Studio and the Fusion page in DaVinci Resolve, horizontal stretching of the overlay (box, crop, labels, dashes) and off-frame displacement of the mask are eliminated — geometry is derived from the actual pixel aspect ratio. Nuke, Natron and Flame are unaffected.
• Correct object-panel (OM) proportions in Fusion. On anamorphic material, horizontal stretching and displacement of the panel are eliminated, and cursor hit-testing on its controls is restored.

3.1.1 17 July 2026

• A "Reset Scene" button on the object panel. A round button in the "OBJECTS" title bar: press-release to wipe the scene (same as the Reset Scene parameter). Move off the button before releasing to cancel.
• A screen-pinned object panel no longer flies away. A pinned panel ("Pin Object Panel On Screen") can now be dragged anywhere on screen — it won't go off the edge or drift while zooming.
• Overlay appearance settings are saved globally. The overlay scale and colours ("Overlay UI Color", "Mask Overlay Color") are remembered on your computer and apply to every project — no re-tuning per project. The mask colour is no longer keyframe-animatable.
• Nuke before v16: the panel is no longer clipped by the top toolbar strip.

3.1.0 17 July 2026

• Input colour switch: "Apply sRGB LUT". A new "Input Color" group sits at the very top of the parameters, with a checkbox that is on by default — existing projects behave exactly as before. If your project is ACES or you manage colour yourself, turn it off and feed the colour in your own way (e.g. through OCIO): previously the input was always pushed to sRGB, so on an ACES project SAM3 saw distorted colour and segmentation behaved differently. Out-of-range values are clamped to 0–1 in either mode. Change it on the init frame (like the Crop parameters).
• License activation through a proxy. For studios on an isolated network (no direct internet): the License panel now has "Use Proxy", "Proxy Server", "Proxy Password" and a "Save Proxy" button with a status line. License activation and deactivation go through the specified company proxy (with a login and password if it requires them). With the checkbox off, everything works directly as before.
• Objects at the frame edge are no longer eaten away. When an object runs partly past the frame border, the mask now stays clean right at the edge (previously it could erode at the border).
• Stability in multi-threaded hosts. Fixed rare crashes caused by thread race conditions — between frame rendering and the UI / node teardown, and in the cold-start server exchange. The plugin is more reliable.
• New option: "Pin Object Panel On Screen". The "UI Appearance" group has a new checkbox that pins the object panel to a screen corner, so it stays in place while you zoom and pan (off by default: the panel moves with the image as before). The setting is saved on your computer and applies to every project.

• The INIT FRAME line in the object panel is clickable. Hover it — it turns green; click — the playhead jumps to the init frame. Same as the "Go to Init Frame" button, but on the canvas. Inactive on the init frame itself, and in DaVinci Resolve too — that host does not perform playhead jumps, so the button is hidden there as well. _Side note:_ the panel now drags by the "OBJECTS" title bar only — the INIT/TRACKED lines became a click target.

Point and mask-cleanup refinements:

1. Point Detail Level — 'Auto' removed, per-point size everywhere. The "Point Detail Level" dropdown no longer has "Auto" — four explicit sizes (Tiny detail / Object part / Large object part / Whole object). "Add Point Object" defaults to Whole object, the FG/BG Refine tools to Object part. Most importantly, every point (point object and refine point) now keeps its own size on the init frame too — previously a refine point's size only took effect on tracked frames. Projects from an earlier version open cleanly (values migrate automatically). Point Detail Level shows the selected point's size. When you select a point, the "Point Detail Level" dropdown now reflects that point's own size, so you can see its level at a glance (previously there was no feedback).

2. Remove Sprinkles — speckle cleanup is now per-object, not whole-frame. Previously small-island removal was computed over the whole merged frame mask at once, so a large neighbour inflated the total and a small whole object could fall under the threshold and vanish entirely. Now cleanup runs per object (each by its own size), so a small intact object survives while speckle is still removed. The default is lowered from 1000 to 100 px.

3.0.9 8 July 2026

• Backward tracking no longer drops the object. Previously, tracking forward, returning to the init frame (“Go to Init”) and then tracking backward could briefly lose the object for 1–3 frames before it recovered. The crop window now correctly resumes at the right edge — no drop. Verified with single and multiple objects, in both crop modes (Union and Per-Object) and in both directions.
• Cleaner cold start. On a first launch (or after clearing the cache), when engine preparation takes a few minutes, the plugin no longer spawns a redundant second server process or floods the log with errors — startup is more stable and clean (no more double GPU warm-up).

3.0.8 8 July 2026

• The scene's init frame is now visible. An Init Frame line under the Mode dropdown (Tracking Mode group) always shows the frame the scene's tracking started on.
• "Go to Init Frame" button. Jump to the init frame in one click. Works in Nuke and Fusion Studio; disabled in DaVinci (the host does not let a plugin move the playhead).
• Plugin version in Server Tools. The installed version now shows as the first line — handy to quote when contacting support.
• Object Manager. In the "INIT FRAME" and "TRACKED FRAMES" lines the label is flush left and the number flush right, so the number is easier to spot.

3.0.7 7 July 2026

• Better detection quality — detection and tracking are now steadier.
• Reset + text no longer hangs — after Reset Scene a new text prompt is created again and no longer stalls at the detection stage.
• Refine points now show which object they belong to — each refine point has a label (square + object name); in refine mode the selected object is focused and the others reveal on hover; the point diamond is slightly larger.
• On-canvas object labels — text objects are labelled with the found word ("BREAD 1"), point objects show "POINT 1" above the box; refine points are smaller.
• Colored group logo.

3.0.6 5 July 2026

• Fixed a text-prompt input bug in DaVinci / Fusion.
• Improved tracking accuracy.
• Refine corrections now hold on the following frames — previously a point correction could slip.
• Default text-detection threshold 0.3 → 0.4. Fewer false positives on similar-coloured objects.

3.0.5 2 July 2026

• Refine points: moving, adding and deleting a point now honestly recomputes the frame's mask; deleting all points restores the tracked mask.
• A refine click outside the frame now widens the processing window (using the UI padding) — you can extend the object when the frame has slipped; works for point objects too.
• On the init frame, an FG point placed outside the drawn box now grows the box itself — the starting prompt covers the whole object for cleaner segmentation.
• No Init mode: editing the box on a frame now re-seeds the scene — the mask follows the box.
• Switching tracking modes (Locked / Dynamic / No Init) inside the tracked range no longer resets your track.
• Mask Prompt: the input mask can now be corrected DURING tracking — move your roto while parked on a frame and a correction key is set exactly there (the mask applies on that frame, tracking continues from it); an animated/interpolating roto does not spawn extra keys. Keys show as diamonds on the MASK row, a diamond click removes the key, and keys survive project reopen.
• Show Trimap now displays when working through the Refiner Direct input — both with and without AI objects.
• Per-Object Crop: refine clicks on the second and further objects are no longer lost.
• Object Manager: the visibility circle fills green when an object has visibility animation keys.
• Installer (Windows): upgrading no longer wipes the warmed TRT cache — after an update the plugin starts right away, no engine re-warm (the cache is validated at launch and rebuilt only when truly stale: runtime, GPU or driver changed).
• Documentation: added the Node Inputs section — all four node inputs (Source, Mask Prompt, Refiner Direct, Mask Composite).