All tools

video_trim

Screen, windows & UI · macOS · Windows

Effect: write (strongest supported action). Status: gated.

Gated means the tool requires an installed app, a connected account, permission, or runtime availability. Check those requirements on the listed platform before using it.

macOS

Purpose

Trims a video to one or more time ranges (milliseconds), concatenated in order into a NEW file — e.g. keep [{start_ms:0,end_ms:6000},{start_ms:126000,end_ms:223000}] to drop a dead segment. Audio is carried along. Returns the output path + duration. Never overwrites the input in place.

Required inputs

Permissions and confirmation

No explicit confirmation parameter is exposed in this snapshot. This does not grant permission to act: obtain user authorization before any real action.

Full input schema — macOS
{
  "properties": {
    "input": {
      "description": "Path to the source video.",
      "type": "string"
    },
    "output": {
      "description": "Output path (default: <input>_trimmed.mov). Missing parent folders are created.",
      "type": "string"
    },
    "ranges": {
      "description": "Ordered [{start_ms, end_ms}] to keep.",
      "items": {
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "input",
    "ranges"
  ],
  "type": "object"
}

Documentation example

Do not execute this example. These concrete inputs refer to a fictional demonstration dataset. Resolve real handles and obtain user authorization before any real call.

{
  "input": "/Users/demo/Documents/meeting.mov",
  "ranges": [
    {
      "end_ms": 5000,
      "start_ms": 0
    }
  ]
}

Windows

Purpose

Trims a video to one or more time ranges (milliseconds), concatenated in order into a NEW file — e.g. keep [{start_ms:0,end_ms:6000},{start_ms:126000,end_ms:223000}] to drop a dead segment. Audio is carried along. Returns the output path + duration. Never overwrites the input in place.

Required inputs

Permissions and confirmation

No explicit confirmation parameter is exposed in this snapshot. This does not grant permission to act: obtain user authorization before any real action.

Full input schema — Windows
{
  "properties": {
    "input": {
      "description": "Path to the source video.",
      "type": "string"
    },
    "output": {
      "description": "Output path (default: <input>_trimmed.mov).",
      "type": "string"
    },
    "ranges": {
      "description": "Ordered [{start_ms, end_ms}] to keep.",
      "items": {
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "input",
    "ranges"
  ],
  "type": "object"
}

Documentation example

Do not execute this example. These concrete inputs refer to a fictional demonstration dataset. Resolve real handles and obtain user authorization before any real call.

{
  "input": "C:\\Users\\demo\\Documents\\meeting.mov",
  "ranges": [
    {
      "end_ms": 5000,
      "start_ms": 0
    }
  ]
}