Command · Rough Cut from Script
roughcut.fromScript
Makes a first cut from a script, an outline or bullet points: each line is found in the transcripts of the recordings (fuzzy, Thai too), the best take of it chosen (fewest fillers and false starts, complete sentence, clean audio; alternates kept), and the takes assembled in script order as a new sequence with linked video and audio trimmed to the words with small handles.
- v1
- Capability EditProject
- Tool
roughcut_fromScript
Request
{
"command": "roughcut.fromScript",
"params": {
"prefer": "cleanest",
"text": "# Launch video\nWe built Wabcut for creators.\nIt cuts in seconds, not hours.\n[B-roll: timeline close-up]"
}
}Parameters
brollboolean- Suggest B-roll from the footage for lines with visual cues or that the footage clearly shows, on their own track (default false).
cleanupboolean- Also remove fillers and pauses (transcript.cleanup) from the cut (default false).
cleanupSilencesnumber (0.2..10.0)- With cleanup: the shortest pause removed, in seconds (default 0.8).
filestring- A .txt / .md file holding the script (only where the host allows reading files).
fromSequenceinteger (1..)- Take the lines from the media this sequence uses, and its frame size and rate.
interpretboolean- Let the user's cloud chat model place loose outline bullets first (transcript text only; needs consent; never for a no-cloud project; default false).
markersboolean- A marker at each section heading of the script (default true).
media(integer | string (1..))[], min 1- Media to take the lines from. Default: every media item with a transcript.
minMatchnumber (0.2..0.95)- How closely a take must say the line, 0.2..0.95 (default 0.45).
namestring- The new sequence's name (default "Rough cut: ").
prefer`best` | `cleanest` | `first` | `last`- Which take of a line to use: the best overall (default), the cleanest (fewest fillers and false starts), the first or the last recorded.
split`auto` | `lines` | `sentences`- Beats: "auto" (bullets and short lines whole, prose per sentence; default), every line, or every sentence.
textstring- The script, outline or bullet points (plain text or Markdown).
Discussion
Makes a first cut from a script, an outline or bullet points: each line is found in the transcripts of the recordings (fuzzy, Thai too), the best take of it chosen (fewest fillers and false starts, complete sentence, clean audio; alternates kept), and the takes assembled in script order as a new sequence with linked video and audio trimmed to the words with small handles. Optional: clean-up of fillers and pauses, B-roll suggestions on their own track. Returns the alignment report (per line: the chosen take, its confidence, the alternates). Needs transcripts. One undo step; dryRun previews it.
Run it with wabcut-cli cmd <project> --json, from an MCP client as roughcut_fromScript, or from an extension. See Edit commands for requests, references and results.
See also
roughcut.*
- roughcut.swapTake
Swap Take. In a rough cut made by roughcut.fromScript, plays another recorded take of one line in place of the current one; what follows moves to fit (a ripple).