cut
Splits a source file at specified timecodes into sequential segments.
When to use
Use cut when you want to divide a source file into multiple fixed segments at known timecodes. For AI-assisted content cuts based on a transcript, use ai_agent.
In the editor
Add it from the Library (Utility group), or with + add step and a search for cut.
Under Inputs, add source as a file input naming the video you want divided. points is required, and shows as a comma-separated field: type the timecodes to cut at, in HH:MM:SS.mmm form. Each timecode is a boundary, so two points give you three segments. Set Output Level to the level the pieces should land on.
The run timeline shows the pieces laid end to end in order, one clip per segment, which you can then preview and retime individually. If what you actually want is for the cuts to follow what is being said, use ai_agent or deadspace_trimmer instead: this step only cuts where you tell it to.
YAML Example
- id: split_sections
processor: cut
input:
- id: source
file: speaker-footage
params:
points:
- "00:00:30.000"
- "00:01:00.000"
output:
timeline: main
This creates three segments: [start, 30s), [30s, 60s), [60s, end).
Inputs
| ID | Source | Description |
|---|---|---|
source |
file | Source video or audio file |
Params
| Param | Type | Default | Description |
|---|---|---|---|
points |
list | none | Timecodes to cut at, in HH:MM:SS.mmm format. Empty = no cuts (single segment covering the full file). |
Output
EditDecisions: one edit decision per segment, placed sequentially on the output level.
Notes
- Segments are placed end-to-end in order.
- Each cut point creates a boundary; N points produce N+1 segments.