clipwright-trim

MCP tool for explicit keep/drop range selection and OTIO timeline generation. Accepts user-defined time ranges in seconds and produces a kept-range OTIO timeline that clipwright-render can use for precise, non-destructive video editing.

Overview

  • Input: Media file (video or audio), output OTIO path, optional keep/drop range specification
  • Process: Validates ranges against media duration (via ffprobe), applies padding, builds a kept-range OTIO timeline using the same structure as clipwright-silence output
  • Output: New OTIO file with KEEP intervals; input media is never modified (non-destructive, readOnly)

MCP Tool

clipwright_trim

Parameters

Name Type Default Description
media string required Input media file path (video or audio)
output string required Output OTIO timeline file path (.otio extension)
options object null TrimOptions (see below)

TrimOptions

Field Type Default Description
keep array[TrimRange] [] Ranges to retain, in enumeration order. Mutually exclusive with drop.
drop array[TrimRange] [] Ranges to remove; complement becomes the kept region. Mutually exclusive with keep.
padding_sec float 0.0 Non-negative padding (seconds) applied to each range boundary. In keep mode, expands outward; in drop mode, shrinks inward.

TrimRange

Field Type Constraints Description
start_sec float >= 0 Range start time in seconds from media start
end_sec float > start_sec Range end time in seconds from media start

Return Value

{
  "ok": true,
  "summary": "Kept 2 clip(s) totalling 45.0 s out of 120.0 s source duration (mode: keep).",
  "data": {
    "clip_count": 2,
    "kept_duration_sec": 45.0,
    "source_duration_sec": 120.0,
    "mode": "keep"
  },
  "artifacts": [
    {"role": "timeline", "path": "/path/to/output.otio", "format": "otio"}
  ],
  "warnings": []
}

Requirements

  • Python 3.11+
  • ffprobe (path resolved via CLIPWRIGHT_FFPROBE environment variable or PATH)
  • ffmpeg is not required (this tool produces OTIO only; rendering is clipwright-render's responsibility)

Usage with MCP

Register in your MCP client configuration:

{
  "mcpServers": {
    "clipwright-trim": {
      "command": "clipwright-trim",
      "env": {
        "CLIPWRIGHT_FFPROBE": "/path/to/ffprobe"
      }
    }
  }
}

License

MIT

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for satoh-y-0323 from gravatar.com satoh-y-0323

Credits

Author: satoh-y-0323

License

MIT

Requires

Python >=3.11

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

clipwright_trim-0.3.0.tar.gz (8.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

clipwright_trim-0.3.0-py3-none-any.whl (10.8 kB view details)

Uploaded Python 3

File details

Details for the file clipwright_trim-0.3.0.tar.gz.

File metadata

  • Download URL: clipwright_trim-0.3.0.tar.gz
  • Upload date:
  • Size: 8.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for clipwright_trim-0.3.0.tar.gz
Algorithm Hash digest
SHA256 b6ed7047e370606b181801b3bee386db93bd5c577b200117ef576d972d48c317
MD5 7d01d2554e7124be6bb1d0991b99f49f
BLAKE2b-256 5c65d62a6b10bb76191d7b90f54c3f3a1076d9f0fe8295717e37a7d10eb17696

See more details on using hashes here.

Provenance

The following attestation bundles were made for clipwright_trim-0.3.0.tar.gz:

Publisher: publish.yml on satoh-y-0323/clipwright

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file clipwright_trim-0.3.0-py3-none-any.whl.

File metadata

  • Download URL: clipwright_trim-0.3.0-py3-none-any.whl
  • Upload date:
  • Size: 10.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for clipwright_trim-0.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 327596fd58094507e0a10ef55f1ae4ae0a32755dc3fd9f2b9942ced2740e4755
MD5 fda1233f53f9029c499eef2d48664f65
BLAKE2b-256 4e7b29b76e8c84a9fa4f6822d3dcd14d2a199c3fca6f09fe88d9f24e9068ce74

See more details on using hashes here.

Provenance

The following attestation bundles were made for clipwright_trim-0.3.0-py3-none-any.whl:

Publisher: publish.yml on satoh-y-0323/clipwright

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page