05 · Refine

The Refine workspace

Refine is for fixing and finishing: mask an object, re-run just that region through a model, blend passes together, or apply depth-of-field with a depth map. Two worked examples below show the full process.

Sessions & the pool

A Refine session holds a pool of related videos: the original source, each enhance stage, and anything you export inside the session. The usual way in is to open a finished project under Projects and click Refine. The source and every stage come along with role badges (SRC, S1, S2…). The video marked A is your working video; mark any other as B to use it as a blend layer.

Refine workspace with session pool, player, and Mix tool — The Refine workspace: session pool on the left, player in the middle, active tool on the right. Here Mix is blending the Stage-1 pass back into the final output at 20%.

Everything you export lands back in the pool and is recorded on the project, so a session can be resumed later. The app sidebar shows your open session while you are elsewhere in the app.

Selections

Every Apply tool honors the current selection; no selection means the whole frame. Three ways to select: drag a Box on the video for a region, set In / Out on the transport for a frame range, or click a mask in the pool to select an object. The chip at the top of the tool rail shows what is selected.

The Apply tools

Mix	Blend the B video into the working video, across the whole frame or inside the selection. Used to pull generative detail back toward the cleaner Refocus pass on faces or text.
Blend	Paste a patch video into the working video at its recorded position and frame range.
Reprocess	Re-run an enhance pass on just the selection and blend the fix back in.
Focus	Depth-of-field render: keeps the focus target sharp, blurs by depth. Needs a depth map.
Edit	Trim, crop, rotate, flip. Exported as a new video in the pool.

Example: fix one object with a mask

A common case: one object in an otherwise good output needs another pass. Here the left giraffe in a finished 4× upscale is re-run through Regenerate-Q without touching the rest of the frame.

1In the pool, click New mask…. Pick a model size (Base+ is a good default; larger tracks more accurately, smaller loads faster), then click the object on the video. SAM2 masks it. Add more clicks to include or exclude regions, or drag a box around the object.
2Use Apply to frames to track the object through the shot: Previous/Next in batches, or To start / To end. The scrubber shows a coverage lane with the frames that have masks.
3Click Save mask set. The mask appears in the pool. Click it any time to make it the active selection.
4With the mask selected, open Reprocess. The card crops to the mask (choose Fixed area or Follow object), and the frame range follows the mask's coverage.
5Pick a Fix for preset. Here it is Detail, which softens the input and then re-runs Regenerate-Q on the crop. Choose what to blend the fix into, and click Run.

SAM2 mask authoring with a giraffe selected by a single click — One click on the giraffe and SAM2 masks it. The floating toolbar switches between include and exclude prompts; Apply to frames tracks the object through the shot.

Reprocess tool cropping to the saved mask with a Regenerate-Q pipeline — Reprocess with the mask as the selection: region and frames follow the mask, the Detail preset runs Soften → Regenerate-Q, and the fix blends back into the working video.

The result appears in two places: a patch video in the pool, with its position and frame range recorded so the Blend tool can place it again later, and (if you chose a blend target) a composited working video with the fix in place. Only the 29 masked frames were re-processed.

Example: depth maps & near-camera masks

Depth maps power two things: the Focus tool (depth-of-field) and depth-based masks, which select everything within a distance range without clicking individual objects.

1In the pool, click Generate depth…. Preview (fast) renders at a downscaled size in seconds; Full res is for final Focus renders. Pick a model: relative ranks near to far, metric gives real distances in meters.
2Tick Show depth over the video to inspect it. Brighter is nearer. Pause and hover to read the depth under the cursor; with a metric map the readout is in meters. Click to set the Focus tool's focus point.
3For a depth mask: open New mask… → Depth tab. Drag the From (far) / To (near) range; the blue preview shows what joins the mask. Add a limit box to restrict it to part of the frame, then Create depth mask and propagate to more frames like any mask.

Depth map overlaid on the video, brighter meaning nearer — A preview depth map over the working video. Brighter is nearer: the foreground branch and giraffes separate cleanly from the trees.

Depth tab of the mask tool selecting near-camera objects in blue — Mask from depth: the From/To sliders select by distance. At 42–100% the near-camera foreground joins the mask (blue). Use it with Mix, Reprocess, or Focus like any other selection.

The Focus tool consumes these maps directly: pick a focus target (a click on the video, a masked object, or frame center), set blur strength, max radius, and the in-focus band, and export a depth-of-field pass.

Tool parameters

Reprocess

Setting	Values	What it does · when to change it
Fix for	Consistency · Detail · Denoise · All settings	What is wrong with the region. Consistency: temporal flicker; frame-interpolates the crop. Detail: bad texture; softens, then Regenerate-Q rebuilds it (it re-runs from the Refocus stage for a cleaner starting point). Denoise: grain; one denoise pass. All settings opens the full pipeline editor, same as Enhance.
Crop	Fixed area · Follow object	Fixed area re-processes one rectangle for the whole range. Follow object moves the crop with a tracked mask.
Soften input (pre-blur)	on · off	Light blur before the model, so Regenerate-Q rebuilds texture instead of preserving the bad texture it was given.
Min overlap W / H	px	Tile-overlap minimums for the crop, same meaning as in Enhance. The card warns when tiles overlap too little; raise the minimums to soften seams.
Blend fix into	pool video · none	Where the fix goes. Pick a video to composite automatically, or choose no target to keep it as a patch and place it later with the Blend tool.

Mix

Setting	Values	What it does · when to change it
Blend in (B)	pool video	The layer mixed into the working video. Mark it with the B badge in the pool.
Blend region	Inside · Outside	Blend inside the selection, or everywhere except it.
Strength	0–100%	0 is all working video, 100 is all blend layer. 15 to 30% is typical for pulling generative detail back toward a cleaner pass.
Crop output / codec	region · Match source	Optionally crop the exported mix, and choose its codec (defaults to matching the source).

Mask & depth

Setting	Values	What it does · when to change it
Model size	Tiny · Small · Base+ · Large	The SAM2 variant. Larger tracks objects more accurately through motion but loads and runs slower.
Apply to frames	batch size · direction	Propagates prompts from the current frame in batches (default 30), or to the start or end, with a Stop button. Re-prompt on a later frame if tracking drifts.
Depth scale	Relative · Metric	Relative thresholds are percentages (0% farthest, 100% nearest). Metric uses real near and far limits in meters.
Limit box	optional	Restrict a depth mask to a drawn region instead of the whole frame.

Focus

Setting	Values	What it does · when to change it
Focus target	point · masked object · center	What stays sharp: click the video (with a depth map showing), or pick a masked object.
Blur strength / Max radius	sliders	How aggressively depth maps to blur, and the ceiling on blur size.
In-focus band	slider	Depth range around the target that stays fully sharp. Widen it to keep a whole subject sharp.
Refine edges	on · off	Guided-filter edge refinement so blur boundaries follow object edges.

Enhance

Library & Settings