Command · Auto Zoom

autozoom.apply

v1
Capability EditSequence
Tool autozoom_apply

Request

{
  "command": "autozoom.apply",
  "params": {
    "clip": 42,
    "easing": "easeInOut",
    "maxZoom": 2
  }
}

Parameters

clicksboolean: Zoom on clicks (default true).
clipinteger | object (1..)Required: The screen-recording clip: a clip id, or {"track", "time"} for the clip there.
cursorstring: A cursor sidecar's content: Wabcut JSON ({"format": "wabcut.cursor", ...}) or CSV t,x,y[,event].
detect`auto` | `sidecar` | `frames`: Where activity comes from: a cursor sidecar if there is one, else the frames (default); only a sidecar; only the frames.
dwellboolean: Zoom where the cursor comes to rest (default true).
easing`easeInOut` | `linear` | `smooth`: Key interpolation: ease in and out (default), linear, or the smooth optimised path.
fpsnumber (2.0..30.0): Frames analysed per second when detecting (default 10).
holdnumber (0.2..20.0): Seconds to stay zoomed after the last click or keystroke there (default 1.5).
idlenumber (0.2..30.0): Activity closer than this (seconds) in one area shares a zoom; longer quiet zooms out (default 2.5).
maxZoomnumber (1.1..4.0): Largest zoom, 1.1..4 (default 2).
previewboolean: Also return the window over time and the activity, for drawing (default false).
sequenceinteger (1..): Sequence id; only needed when the project has several.
sidecarstring: A cursor sidecar file (only where the host allows reading files).
smoothnessnumber (0.0..1.0): Camera smoothness, 0 (follows closely) .. 1 (moves only when it must); default 0.5.
transitionnumber (0.1..5.0): Shortest zoom in / out / pan, in seconds (default 0.6).
typingboolean: Zoom on typing (default true).

Discussion

Zooms a screen recording in where things happen (clicks, typing, where the cursor rests) and back out when nothing does, like Screen Studio: smooth, editable Position and Scale keyframes on the clip (the AI-9 camera optimiser), never showing outside the frame. Activity comes from a cursor sidecar when there is one, else from the frames. Running it again replaces its keys. One undo step; dryRun with "preview" returns the zoom path.

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

autozoom.apply

Capability EditSequence

Tool autozoom_apply

Parameters

clicksboolean

Zoom on clicks (default true).

clipinteger | object (1..)Required

The screen-recording clip: a clip id, or {"track", "time"} for the clip there.

cursorstring

A cursor sidecar's content: Wabcut JSON ({"format": "wabcut.cursor", ...}) or CSV t,x,y[,event].

detect`auto` | `sidecar` | `frames`

Where activity comes from: a cursor sidecar if there is one, else the frames (default); only a sidecar; only the frames.

dwellboolean

Zoom where the cursor comes to rest (default true).

easing`easeInOut` | `linear` | `smooth`

Key interpolation: ease in and out (default), linear, or the smooth optimised path.

fpsnumber (2.0..30.0)

Frames analysed per second when detecting (default 10).

holdnumber (0.2..20.0)

Seconds to stay zoomed after the last click or keystroke there (default 1.5).

idlenumber (0.2..30.0)

Activity closer than this (seconds) in one area shares a zoom; longer quiet zooms out (default 2.5).

maxZoomnumber (1.1..4.0)

Largest zoom, 1.1..4 (default 2).

previewboolean

Also return the window over time and the activity, for drawing (default false).

sequenceinteger (1..)

Sequence id; only needed when the project has several.

sidecarstring

A cursor sidecar file (only where the host allows reading files).

smoothnessnumber (0.0..1.0)

Camera smoothness, 0 (follows closely) .. 1 (moves only when it must); default 0.5.

transitionnumber (0.1..5.0)

Shortest zoom in / out / pan, in seconds (default 0.6).

typingboolean

Zoom on typing (default true).

Discussion

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