Extract Clips

clip

Extract several frame-exact segments, each to its own file. For one segment, trim does the same.

editwritesdestructivesince v0.3.0

00:00PARAMETERS

Name	Type	Description
`input` required	`string`	Path to the source video.
`segments` required	`object[]`	{start, end} segments in seconds; each becomes its own file. at least 1 items
`segments[].start` required	`number`	≥ 0
`segments[].end` required	`number`	> 0
`output`	`string`	Optional output path. Only honored for a single segment; multi-segment output lands under SCREENCAST_HOME/edits.
`overwrite`	`boolean`	Allow replacing an existing file at the output path (default false).

00:05A MINIMAL CALL

clip { "input": "recording.mp4", "segments": [{"start": 0, "end": 1}] }

The required arguments only, with placeholder values. Everything else takes its default.

00:10WHAT COMES BACK

Structured content (structuredContent), alongside a text summary:

Field	Type	Description
`outputs` always	`string[]`
`count` always	`integer`	≥ -9007199254740991, ≤ 9007199254740991