clipwright-silence

MCP tool for silence detection and OTIO timeline generation. Detects silent intervals in a media file and writes a KEEP-interval timeline (.otio) that clipwright-render can use for automated cut editing.

Overview

  • Input: Media file (video or audio), output OTIO path, optional detection parameters
  • Process: Runs the ffmpeg silencedetect filter (default) or Silero VAD (opt-in) to find silence intervals, inverts them to KEEP intervals, applies padding and merging, and writes an OTIO timeline
  • Output: New OTIO file with KEEP intervals; input media is never modified (non-destructive, readOnly)

MCP Tool

clipwright_detect_silence

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 DetectSilenceOptions (see below)

DetectSilenceOptions

Field Type Default Description
silence_threshold_db float -30.0 Volume threshold (dB) for silence detection (silencedetect backend only; must be ≤ 0)
min_silence_duration float 0.5 Minimum duration (seconds) to classify as silence (silencedetect backend only; must be > 0)
padding float 0.1 Padding (seconds) added to both sides of each KEEP interval. Overlapping intervals are merged
min_keep_duration float 0.0 KEEP intervals shorter than this value (seconds) are discarded after padding and merging
backend string "silencedetect" Detection backend: "silencedetect" (ffmpeg) or "vad" (Silero VAD / ONNX)
vad_threshold float 0.5 VAD backend only. Speech probability threshold (0.0–1.0); values ≥ this are speech
vad_min_speech_duration float 0.25 VAD backend only. Minimum speech segment duration (seconds)
vad_min_silence_duration float 0.1 VAD backend only. Minimum silence gap (seconds) between speech intervals

Dependencies

Package Purpose
clipwright Shared types, envelope, errors, subprocess runner
mcp[cli] MCP server
pydantic Parameter validation
onnxruntime Silero VAD inference (VAD backend)

Installation and Startup

uv add clipwright-silence
clipwright-silence

Or within a uv workspace:

uv run --package clipwright-silence clipwright-silence

Prerequisites

  • Python 3.11 or later
  • ffmpeg and ffprobe available on PATH, or set via environment variables:
    • CLIPWRIGHT_FFMPEG — path to the ffmpeg binary
    • CLIPWRIGHT_FFPROBE — path to the ffprobe binary
  • For the vad backend: onnxruntime is bundled as a dependency; no additional binary is required

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

Provides Extra

vad

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_silence-0.4.0.tar.gz (14.9 kB view details)

Uploaded Source

Built Distribution

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

clipwright_silence-0.4.0-py3-none-any.whl (17.9 kB view details)

Uploaded Python 3

File details

Details for the file clipwright_silence-0.4.0.tar.gz.

File metadata

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

File hashes

Hashes for clipwright_silence-0.4.0.tar.gz
Algorithm Hash digest
SHA256 7cfb42315c7f8dab3105c74e7019d9876f8f85a9fc1bcb1a65e30c531c715853
MD5 7226d88cdb77767fe462242c02ec73e4
BLAKE2b-256 4ad4a32167d27cc82a5dc3796d5cb77f5b4bc9d41bdb4a46896e8eb3ed4943a6

See more details on using hashes here.

Provenance

The following attestation bundles were made for clipwright_silence-0.4.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_silence-0.4.0-py3-none-any.whl.

File metadata

File hashes

Hashes for clipwright_silence-0.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 327b629c294badae05f9e8c6c2d954cc854f1ee030b56e99612293f899dc431e
MD5 1a46a91d1178218966bedcefaafb9cd6
BLAKE2b-256 01add9e89f8a4c7543ac1d2b13a5b73990d6f83ee6c17f3f18178f21330b101e

See more details on using hashes here.

Provenance

The following attestation bundles were made for clipwright_silence-0.4.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