Zoom and Pan
zoomCreate animated pans and magnification into recorded screen activity, then return to full view using keyframes or automatically planned from logged clicks and screen changes.
Instructions
Smooth animated zoom-and-pan into the action and back out, from keyframes or planned from logged clicks or screen changes.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"input": "<input>"
},
"name": "zoom"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| input | Yes | Path to the source video. | |
| dryRun | No | Return the planned keyframes only (editable, pass back). | |
| events | No | Events log (default: the input's .events.jsonl); must match the input's timing and size, so use the original recording. | |
| follow | No | Without keyframes: clicks (from the events log of start_recording events: true) or changes (where the screen changed). auto (default): clicks if logged, else changes. | |
| output | No | Optional output path. Defaults under SCREENCAST_HOME/edits. | |
| holdSec | No | Auto mode: stay zoomed this long after activity (default 2). | |
| maxZoom | No | Auto mode: the furthest it zooms in (default 2.5). | |
| keyframes | No | Views reached by time t: a source rectangle (x, y, width, height), or { t, full: true } to zoom out. Omit to plan them (see follow). | |
| overwrite | No | Allow replacing an existing file at the output path (default false). | |
| transitionSec | No | How long each zoom/pan eases (default 0.6). | |
| highlightColor | No | Ring color (default #FF4545). | |
| highlightClicks | No | Ring each logged click (default false). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| keyframes | Yes |