hold_under
Plays a film clip's audio beneath a specified span of voiceover words, lowering it below the VO level. Replaces or adds a music bed without gaps, and supports planning before writing.
Instructions
Play a film clip's own audio under a span of the VO, under LU below
it (default 13) — no gap, unlike hold_add. The span is VO words
(word_index_start/word_index_end, or phrase_start/phrase_end), and
the audio reads from wherever the shot showing asset has got to at the
span's first word, so asset must be on screen there — cue it first. A
second call at the same (clip_id, word_index_start) replaces the entry;
the music bed goes out across it. plan resolves without writing. Both
boundary words are echoed with neighbours — check them.
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": {
"clip_id": "<clip_id>",
"asset": "<asset>"
},
"name": "hold_under"
}
}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 the matches of `phrase_start`/`phrase_end`: any match at or before this word index is skipped. -1, the default, means from the start. | |
| asset | Yes | The film clip whose audio plays under the voice. It has to be on screen across the span — the audio reads from wherever the shot showing it has got to — so cue it first. | |
| under | No | How far below the VO the film audio sits, in LU. 13 by default. | |
| clip_id | Yes | The VO track whose words the span is measured in. | |
| fade_in | No | Seconds of fade as the film audio comes in. | |
| fade_out | No | Seconds of fade as it goes out. | |
| occurrence | No | Disambiguate `phrase_start`/`phrase_end` by count, **1-based**. Unset, an ambiguous phrase is refused rather than guessed at. | |
| phrase_end | No | Set the span's end by wording instead. | |
| phrase_start | No | Set the span's start by wording instead. | |
| word_index_end | No | Last VO word of the span. | |
| word_index_start | No | First VO word of the span. With `clip_id` it is the entry's address; a second call at the same address replaces it. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||