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.