Track Destabilize

Every stabilized workflow hits the same moment: you've got a beautiful, motionless, fully regenerated version of your subject, and it's wrong, because the shot is supposed to move. Track Destabilize fixes that. It takes your processed, stabilized frames, reapplies the original camera and object motion, and composites the result back into the moving plate. It's the second half of the stabilize → process → destabilize round-trip, and the half people forget to plan for when they first fall in love with Track Stabilize.

How it works

Stabilize warped every frame into a locked canvas and recorded the transform. Destabilize simply inverts that exact same stored matrix - the round-trip is exact by construction, so a stabilized-and-destabilized shot with nothing done in between comes out visually identical to the source. Then it composites: your processed frame is warped back onto the plate and blended by a mask, with feather softening the edge so the generated region melts into the original footage instead of showing a hard cut.

Inputs and outputs

• images - the stabilized, processed frames coming out of your generative step.
• track_data - the track_data output from Track Stabilize, not the raw one from Planar Track. That output carries the canvas info Destabilize needs. Wire in a bare track and you get an error telling you exactly that.
• feather (default 3) - how far the blend edge softens, in pixels. Too low and you see the seam; too high and you get a halo.
• original_images (optional) - the untouched plate. Provide it and Destabilize composites your processed result over the original footage. Leave it out and it just dumps the destabilized frames, plate and all.
• mask (optional) - a blend mask in stabilized space saying where your processed content should win. Ran your generation on a face or an object? Feed the matching mask so only that region gets composited back and the rest of the frame stays 100% original.

Output is a single images stream at the original plate size.

Installing it

Part of the same pack - search PlateTrack in Manager, or clone + pip install -r requirements.txt. No models, CPU-friendly.

Where people get burned

• Feeding it a raw track. If you see a "track has no stabilize info" error, you grabbed the wrong track_data - take the one Stabilize emits.
• Forgetting original_images and getting the whole stabilized canvas pasted back as a rectangle. The round-trip is exact, but the plate should be your background; supply it.
• Over-feathering on a moving shot. The feather is applied after eroding the mask inward precisely so it never samples outside the valid warp region - that's deliberate, and it means you can crank it a bit without pulling in garbage.

Set up correctly, Destabilize is the node that turns "a locked crop that looks amazing" into "amazing and moving like the real shot." Which is the entire reason you tracked in the first place.