Command · Auto Reframe

reframe.createSequence

Makes a copy of a sequence at another aspect ("9:16" for vertical shorts, "1:1", "4:5", "16:9") whose video clips keep their subjects in frame: per shot, a smooth virtual camera (still, then steady pans) follows the main subject, all faces, the speaker or an anchor.

• v1
• Capability EditProject
• Tool reframe_createSequence

Request

{
  "command": "reframe.createSequence",
  "params": {
    "aspect": "9:16",
    "mode": "follow"
  }
}

Parameters

anchor(number (0.0..1.0))[], min 2

Anchor mode: the point to keep centred, [x, y] in 0..1 of the picture.

aspectstring

Aspect of the new sequence: "9:16" (vertical), "1:1", "4:5", "16:9" or any "W:H". Default "9:16".

fit`crop` | `letterbox` | `blur`

Where the subjects cannot fit: "crop" anyway (default), zoom out with "letterbox" bars, or zoom out over a "blur"red fill.

heightinteger (16..8192)

Output height in pixels (with width).

marginnumber (0.0..0.4)

Room kept around a subject, as a fraction of the frame. Default 0.04.

mode`follow` | `faces` | `speaker` | `anchor`

What the frame follows: "follow" the main subject of each shot (default), keep all "faces" in, the "speaker" who is talking, or a fixed "anchor" point.

namestring

Name of the new sequence. Default: the source's name and the aspect.

previewboolean

Report the frame path of each clip for drawing (default true).

sequenceinteger (1..)

The sequence to reframe; only needed when the project has several.

smoothnessnumber (0.0..1.0)

0 = follow closely .. 1 = move only when needed. Default 0.5.

widthinteger (16..8192)

Output width in pixels (with height). Default: the source's short side kept.

Discussion

Run it with wabcut-cli cmd <project> --json, from an MCP client as reframe_createSequence, or from an extension. See Edit commands for requests, references and results.