trim

Cuts a source file to specific in/out points.

When to use

Use trim when you have a single source file and want to isolate a specific portion of it before running further processing. For multiple cut points, use cut.

In the editor

Add it from the Library (Utility group), or with + add step and a search for trim.

Under Inputs, add source as a file input naming the video or audio you want cut down. Then set in and out to timecodes in HH:MM:SS.mmm form. Both are optional: leave in empty to start at the beginning, leave out empty to run to the end, and leave both empty to put the whole file on the timeline untouched, which is the simplest way to get a clip into a template.

Set Output Level to where the clip belongs, usually main.

The run timeline shows one clip, positioned at the start of its level. To have it come in later, use a step that places clips at a position, or a stitch step to run several clips in sequence.

YAML Example

- id: clip_intro
  processor: trim
  input:
    - id: source
      file: speaker-footage
  params:
    in: "00:00:03.500"     # optional; defaults to start of file
    out: "00:01:20.000"    # optional; defaults to end of file
  output:
    timeline: main

Inputs

Params

Output

EditDecisions: one edit decision covering the trimmed range.

Notes

• Both in and out are optional. Omit both to pass the full file through, which is the usual way to put an untouched clip on the timeline.
• A missing in means the start of the file; a missing out means the end of it. The file's own duration is read to fill in whichever one you leave out, so the step fails if the file cannot be read.
• in must be before out.
• The clip is placed at the start of its level. To place it later, use a step that positions clips, or stitch to run several clips back to back.
• Timecodes are in HH:MM:SS.mmm format.