Cut By Transcript

cut_by_transcript

Edit a video by its transcript: cut quoted text, cue numbers, or fillers. Also writes the re-timed .srt.

editwritesdestructivesince v0.46.0

00:00PARAMETERS

Name	Type	Description
`input` required	`string`	Path to the source video.
`srt` required	`string`	Its .srt (transcribe; words: true for word timing).
`remove`	`(integer \| string)[]`	Cue numbers, or transcript text quoted exactly (must occur once).
`fillers`	`boolean`	Also cut fillers (um, uh...) that have their own cue.
`dryRun`	`boolean`	Only report the cuts.
`output`	`string`	Optional output path. Defaults under SCREENCAST_HOME/edits.
`overwrite`	`boolean`	Allow replacing an existing file at the output path (default false).

00:05A MINIMAL CALL

cut_by_transcript { "input": "recording.mp4", "srt": "captions.srt" }

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
`cuts` always	`any[]`
`removedSec` always	`number`

00:15SEEN IN