The Refine workspace

Refine is where you fix a finished video: mask an object, re-run just that region through a model, blend passes together, or trim and crop. Open it from a project under Projects (or a video under Videos) with the Refine button. The top bar keeps a back chip to the place you came from; the session survives while you are elsewhere in the app.

The layout has three parts. Files on the left lists everything in the session. The video fills the middle, with a floating toolbar above it and the transport below. Tools open as small panels next to the video; the Reprocess dock opens along the bottom.

There is one working video at a time. Every tool operates on it, and every result is written next to it. Click any video in Session videos to make it the working video. The list is a lineage tree: the original, each enhance stage, and anything made in Refine, each with a role glyph (Original, Refocus, Regenerate-Q, Denoise, Frame interpolation, Mix, Version, Patch, Edit, Imported). Videos that are not linked to the session history sit under Unlinked.

The working row carries three buttons: Mix, Edit, and Patch. They are the direct edits; model runs start from the Reprocess chips above the video.

Every row renames in place: double-click the name or use its pencil. The panel pops out into a floating window from its header, and collapses to an icon rail; each rail icon opens that section as a popover. Removing a row drops it from the session; for videos the app asks whether to delete the file too.

A selection has two halves, and every tool reads both: an area (a drawn box or a saved mask) and a frame range. No area means the whole frame; no range means the whole clip.

Area

Pick Box in the pointer pill (or a panel's Select area) and drag on the video. Esc cancels. Once drawn, a row of chips floats under the box:

To use a mask as the area, click it under Masks in Files. The active area is echoed at the top of each tool panel.

Range

Click Clip on the transport to open the Range bar: numeric In and Out fields, In here / Out here to take the playhead, the frame count, Clear, and Done. The lane under the scrubber is the same range: drag to select, drag its edges to trim, drag the band to slide it, double-click to reset. With a range set the Clip button reads f 120–180.

Reprocess re-runs models on the selection and writes the result as a patch video. Start from the chips above the video. Each chip is a saved pipeline; hover one to see what it runs and on what. Click it and the dock opens in its short form with Where, When, and Output rows and a Run button.

If you are not sure which fix you need, open the ▾ next to the chips and choose Choose by symptom…. The picker asks What looks wrong? and shows one card per fix, headlined by the symptom:

The dock

The full dock sits bottom-center, over the transport, or as a popover under the chips (the ⌄⌄ / ⌃⌃ button switches; the choice is remembered). The header names the working video and holds Preset ▾ (switch fix, adjust a preset's pipeline, delete a custom one), Defaults (save the current settings as what Reprocess opens with), Settings (the full pipeline editor, every model setting, drag to reorder), minimize to the short form, and close.

The footer shows the plan check. When the pipeline cannot land back on the working video 1:1 (wrong frame count, wrong scale) it explains why and offers one-click fixes such as Add VFI ×2, Auto headroom, or Add Regenerate-Q. Warnings (an offline engine, a missing model, re-running Regenerate-Q on Regenerate-Q output) list here as well. Progress runs in the footer and in a strip above the transport.

Blend back or patch only

A run always makes a patch video; it lands under Patch videos with its position and frame range recorded. With Blend back on, the run also pastes the patch into the chosen target, gated to the mask when there is one, and the result joins Session videos as the next Version of that target. With Patch only, nothing else changes; blend it later with the Patch tool.

Managing fixes

Customize… in the ▾ menu pins, reorders, edits, and deletes fixes, and hides or shows the chip bar. Pinned fixes are the chips. New fix… opens the editor empty; Save as preset there keeps a pipeline you built.

A mask set holds one or more objects, each tracked across a frame range. Masks are the area for Mix, Reprocess, and Edit, and they gate a blend so only the object changes.

Create, track, correct

1. 1Open Mask ▾ → Objects. The pointer switches to Include. Click the object on the video; SAM2 masks it on this frame. Drag a box around it instead if a click grabs too little. Exclude clicks remove areas.
2. 2Tune what a click grabs with Pick in the pointer pill: Auto, Object, Part, or Detail. Auto-detect finds every distinct object on the frame (or inside a drawn box as Detect in box). Undo removes the last prompt; the trash clears everything.
3. 3The masking bar over the transport names the mask, lists its objects as chips (click a chip to prompt that object, click its name to rename it), and picks the SAM2 model size (Tiny, Small, Base+, Large: larger tracks better, loads slower). The f a–b button opens the Range bar to set which frames to track.
4. 4Click Track f a–b & create. The object is tracked across the range and the mask is saved. The bar switches to Saved ✓ and reports how many frames carry masks; the green lane over the scrubber shows coverage.
5. 5Scrub through. Where the mask is wrong, add include or exclude points on that frame, then click Re-track f a–b. Tracking restarts from the corrected frames and updates the saved mask. Done closes the bar.

Saved masks live under Masks in Files. The pencil re-opens one for more prompts and a re-track. While a mask is being authored, its objects also list in Files, where they can be merged into the active object or removed. From a drawn box, the Segment, Detect, and Save as mask chips make a mask without opening the tool.

Masks from depth

Mask ▾ → From depth opens the Mask tool on its Depth tab. Pick a depth map, then drag From (far) and To (near) (percentages for a relative map, meters as Near and Far limits for a metric map). Blue shows what joins the mask on this frame. To limit it to part of the frame, choose Depth limit box in the pointer pill and drag. Create depth mask creates it on the range from In/Out, or on the current frame; Apply to frames extends it before, after, to the start, or to the end.

A depth map is a video where brightness encodes distance. It powers depth masks and the depth overlay. Open Depth ▾ → Generate a depth map:

Depth ▾ → Show depth over the video overlays the active map. Pause to see it; brighter is nearer. With the Depth tool open, hovering reads the distance under the cursor, in meters for a metric map. The eye on a map under Depth maps toggles the same overlay.

The depth-of-field Focus render is not exposed in this release; depth maps are used for masks and inspection.

The three buttons on the working row are direct edits. Each opens a panel beside the video, reads the current selection, and writes a new video into the session.

Mix

Blend another session video into the working video. Pick the blend layer and a strength (0 is all working video, 100 is all blend layer; 15 to 30 pulls generative detail back toward a cleaner pass). The layer previews on the video while the panel is open. Mix area attaches a mask or a drawn box, then chooses Inside or Outside and whether to crop the output to the selection. Clipping limits it to a frame range. Export writes <working>_mix via a save dialog.

Edit

Trim to the selection range, crop to the selection box, rotate by 90° steps, and flip horizontally or vertically. The Crop chip under a drawn box opens Edit with the crop ticked. Render writes <working>_edit.

Patch

Paste a patch video back onto the working video at its recorded spot. Choose the patch; it previews as a box on the video. Drag the box to move it, or use Edit placement for exact numbers and a frame range. Everything outside the box and range stays the untouched working video. The result is the next Version of the working video (<base>_v2, _v3, …), named and placed from the panel. Reprocess with Blend back does this step for you.

Compare at the top of Files wipes two session videos against each other. Pick Left and Right, swap them, and drag the wipe. Zoom to 8× for pixel inspection; while zoomed, a toggle decides whether dragging pans or moves the wipe. Space plays and pauses, Esc closes.

Sides are synced by timestamp, so a frame-interpolated output lines up with its source. A trimmed clip (a patch, a trimmed edit) is placed at its offset on the source timeline: its label reads starts at 0:04 until the clock reaches it, and ended (holding its last frame) once it runs out while the longer side plays on.

Everything a session makes is written into one folder beside the working video's family, <base>_refine/, where <base> is the file name without any _vN suffix. Refining clip_v2 keeps writing into clip_refine/.

Mix and Edit exports use a save dialog instead. Names are editable everywhere they are shown; a rename moves the file and its sidecars and updates the project record, so the session reopens with the new name. Artifacts from earlier releases in their old locations are still found and editable.

Reprocess dock

Mask

Mix

Edit

Patch