retime_add
Add a speed change to a clip's span, defined by start and end words, phrases, or events, with a target render duration. Speeds up or slows down that segment while muting its audio.
Instructions
Play a span of the film faster or slower: "from event sent to event words in 1.0 s".
The span starts at a word, phrase or event of clip_id and ends at one;
it is resolved through the timeline on every build, never stored as
seconds. Everything outside every stretch plays at 1x, with the speed
eased in and out over half a second either side. The film's own audio is
muted wherever it plays off speed; music, sounds, overlays and captions
keep 1x and land where the retime puts their moment. Stretches may not
overlap.
The reply gives the span in Edit seconds and render seconds, its speed,
and the render's new length; plan=true writes nothing. Any retime routes
export through the MLT writer. A film-audio hold cannot share a project
with a retime yet, and the window previews at 1x.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| 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. | |
| after | No | A forward cursor over a phrase's matches: any match at or before this word index is skipped. -1, the default, means from the start. | |
| event | No | Start on this event of clip_id: `name`, or `name#k` when the name repeats. | |
| phrase | No | Start on this phrase's FIRST word, resolved against clip_id's transcript. | |
| clip_id | Yes | The clip whose words or events address the span — the transcript the word indices index, or the recording the events belong to. | |
| seconds | Yes | How long the span plays for in the render. Shorter than the span speeds it up (a 31 s wait in 1.0), longer slows it down. | |
| occurrence | No | Disambiguate a phrase by count when it matches more than once, **1-based** in transcript order among the matches after `after`: 1 is the first, 2 the second. Unset, an ambiguous phrase is refused — listing every candidate's range and text — rather than guessed at. | |
| word_index | No | The word the stretch starts on. One of word_index, phrase or event. | |
| until_event | No | End on this event of clip_id. | |
| until_phrase | No | End as this phrase's LAST word ends. | |
| until_word_index | No | End as this word ends. One of until_word_index, until_phrase or until_event. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||