frames
Extract evenly spaced PNG stills from a demo video or raw take into an output directory for visual review, avoiding manual ffmpeg; returns a jobId to poll.
Instructions
Dump evenly spaced PNG frames from the final video (or the raw take) into output/frames/ for review — look at them instead of hand-running ffmpeg -ss. Needs only the video (no key). Returns a jobId immediately — poll job_status. Rejects if another job is running.
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": {
"dir": "<dir>"
},
"name": "frames"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dir | Yes | demo project directory — pass an absolute path | |
| out | No | output directory (default <dir>/output/frames) | |
| width | No | frame width in px, aspect kept (default 640) | |
| source | No | final = output/final-demo.mp4 (default); raw = the latest raw file; take = the whole recorded take, across the raw files a resumed take is spliced from | |
| everySec | No | seconds between frames (default 3) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | Yes | ||
| jobId | Yes | ||
| status | Yes | ||
| demoDir | Yes | resolved absolute demo directory | |
| logFile | Yes |