Plan each place's crop
plan_reframePlans per-platform video crops before rendering by finding shots and following motion, writing crop.json and preview sheets for review or adjustment.
Instructions
Use it when the user wants to see a video's crop for each place before it renders. Plans what reframe_video renders, without rendering: finds the shots of a finished video and, for each place's shape, a window that follows what moves in each shot, or a padded shot where a crop would cut too much. Writes crop.json, every shot with its window for each shape, sheet.png, each shape's window drawn on every shot's frames (a solid outline for a crop, a dashed one for a padded shot), with more shots in sheet-2.png and on, and FORMATS.md, which the result shows with the command that renders the plan. Look at the sheet, move a window that misses in crop.json, then give that crop.json to reframe_video as crop. A plan in a folder of an earlier render keeps its files. For the files themselves in one job, use reframe_video instead. The reframe playbook (makersmcp_playbook) has the whole job. (reframekit 0.1.3, on this machine.)
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": {
"video": "<video>"
},
"name": "plan_reframe"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| for | No | The places to plan for, in one run at most 12: any of tiktok, reels, shorts, youtube, x, linkedin, feed, square, all (the default) or a size like 1080x1350, as reframe_video takes them. | |
| fps | No | The files' frame rate (default: the video's own), for the render command the plan gives. | |
| pad | No | What a padded shot sits on: blur (default), black, white, a color like #0f172a, or brand, which needs brand. The render command the plan gives carries it. | |
| crop | No | An edited crop.json whose shapes to keep: the plan adds the windows of a place whose shape it has none of. It takes no cuts or steps, and no mode but fit. | |
| cuts | No | Every shot change, in place of those found: seconds like 3.2,7.5, or a JSON file of seconds, of frames with their fps, a launch film's film.timeline.json or a demo's steps.json. | |
| lufs | No | The loudness the files will have in LUFS (default -14), for the render command the plan gives. | |
| mode | No | follow crops each shot where what moves is, and pads a shot a crop would cut (default follow); center crops from the middle; pad shows every shot whole; fit keeps the picture's own shape. | |
| trim | No | Set to false never to cut a file to its place's length. The render command the plan gives carries it. | |
| brand | No | A brand kit, its folder, brand.json or _brand.yml, for padded shots on its page background color. make_brand_kit makes one. | |
| cover | No | The moment each place's cover shows, in seconds like "4.5" (default: picked). | |
| steps | No | The steps.json of the demo this video is, when it is not beside the video under its name. | |
| video | Yes | The finished video, any file ffmpeg reads, like film.mp4 from a launch film or demo.mp4 from a demo. The film.timeline.json or steps.json beside it, under its name, gives its shots. | |
| out_dir | No | Folder to save into, absolute or relative to /app. Default: <video-folder>/reframekit-<video-name>, where <video-name> is the name of video without its extension and <video-folder> is the folder video is in. A run replaces the files an earlier run of this kit left there, so give each version its own out_dir. | |
| seconds | No | Keep at most this long in each place's video, cut at a shot change: seconds like "30", or "1:30". The render command the plan gives carries it. | |
| wait_seconds | No | How long to wait for the result, counted from the start of the call, before returning a job_id to wait on. Some clients end a call after 60 or 240 seconds; 45 is safe in all of them. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kit | Yes | ||
| docs | No | The notes the text shows, and where each one is. | |
| next | No | What to do next, as the Next line says. | |
| tool | Yes | ||
| files | No | ||
| folder | No | Where the kit saved its files. | |
| job_id | Yes | ||
| passed | No | For checks: whether the check passed. | |
| status | Yes | ||
| continued | No | True when this call continued the job of an identical call whose answer did not reach the client, instead of starting another. | |
| exit_code | No | ||
| last_line | No | What the kit was doing last. | |
| expires_at | No | When the download links stop working. | |
| next_action | No | ||
| elapsed_seconds | Yes |