reel
Derive a new project from a selected timeline span, trimming head and tail, and apply a vertical canvas only to the derived copy. Preserves cues and cards where valid.
Instructions
Derive a new project at dest holding [start, end) of this timeline.
start/end are render seconds naming the span to keep — the
opposite direction from every other tool; the head and tail are cut
through cut_by_time. Reach for this before setting a vertical canvas
on a film: the canvas is project state, so pass the reel's shape here and
it lands on the copy only.
Media is linked, not copied. Descriptions and reframes carry over. Cues
carry over only where the reel keeps their word — read cues_dropped
head-first, since one pruned just outside the kept span opens the reel
on no picture. Survivors are pinned to the film's in-points
(cues_pinned, or pins_error). Cards are re-authored at the new canvas
(cards_unrecorded names any that cannot be); over_platform_cap says if
it still runs long for a vertical feed.
Nothing after the film is inherited: tail_dropped and music_dropped
name what the film had. An edge on a suspect-duration word — likely a
hidden retake — refuses unless confirm_suspect; read suspect_edges.
plan=True creates nothing.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | Yes | Where it ends, in those same render seconds. `start`/`end` name the span to **keep**, the opposite direction from every other tool here. | |
| dest | Yes | Where the derived project is created. It is a project selector too, not a file, so a bound server confines it to the same tree as `path` rather than letting a reel be written anywhere on disk. | |
| name | No | A name for the derived project. Unset, it is derived from `dest`. | |
| path | No | The project directory to act on. Omit it — the usual case — when this server is bound to a project (started as `proofcut -C DIR mcp`, or inside a project; `ping` says which): it then resolves to that one bound project, a relative path resolves against it, and a path outside it is refused by name. Unbound, `path` is the whole address and omitting it refuses rather than guessing. | |
| plan | No | Resolve the whole call and report what it would do, writing nothing. Prefer it over doing the thing and undoing it. | |
| start | Yes | Where the reel begins, in the seconds **an export plays at** — the same numbers `cut_by_time` takes, read off a watch. | |
| canvas | No | The shape to set on the derived project only, e.g. `1080x1920`. Setting it on the film instead is what deriving exists to avoid — a canvas is project state and would stay. | |
| confirm_suspect | No | Go ahead even though a boundary word claims a suspect duration. Read the echoed words first — a suspect duration usually means whisper hid a retake inside that word, so the edge is not where it reads. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||