clipwright-bgm

MCP tool to write BGM placement annotations to an OTIO timeline. Records BGM volume, fade, and ducking instructions as metadata on A2 Audio track clips, which clipwright-render realizes as a mix.

Overview

  • Input: Timeline OTIO file, BGM audio file, output path, optional parameters (volume, fade, ducking)
  • Process: OTIO manipulation only (no ffmpeg/external OSS). Adds BGM clip to A2 Audio track and writes clipwright metadata
  • Output: New OTIO file with BGM annotations (input timeline immutable, M5)

MCP Tool

clipwright_add_bgm

Parameters

Name Type Default Description
timeline string required Input timeline file path (existing .otio)
bgm string required BGM audio file path (mp3/wav/m4a/aac/flac/ogg/opus/mp4/mkv/mov/webm)
output string required Output OTIO file path (newly generated, different from input)
options object null BgmOptions (volume_db / fade_in_sec / fade_out_sec / ducking)

Dependencies

Package Purpose
clipwright Shared types, envelope, errors, inspect_media
mcp[cli] MCP server
pydantic Parameter validation

Installation and Startup

uv add clipwright-bgm
clipwright-bgm

Or within a uv workspace:

uv run --package clipwright-bgm clipwright-bgm

Prerequisites

  • Python 3.11 or later
  • ffprobe available on PATH or specified via CLIPWRIGHT_FFPROBE environment variable (used to determine BGM media length)

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.3.4)

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_bgm-0.3.1.tar.gz (7.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_bgm-0.3.1-py3-none-any.whl (9.1 kB view details)

Uploaded Python 3

File details

Details for the file clipwright_bgm-0.3.1.tar.gz.

File metadata

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

File hashes

Hashes for clipwright_bgm-0.3.1.tar.gz
Algorithm Hash digest
SHA256 b58bcebc1b3f979a0bab4ee709a5fb0c33567865d3aef49a894914bf8639819c
MD5 63281451ddcfa99a5eaf1012be0aa20a
BLAKE2b-256 d78e0fb797d23a50675af9023c19746abb721364d98aaba0ae50a6ae8b4bbe8c

See more details on using hashes here.

Provenance

The following attestation bundles were made for clipwright_bgm-0.3.1.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_bgm-0.3.1-py3-none-any.whl.

File metadata

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

File hashes

Hashes for clipwright_bgm-0.3.1-py3-none-any.whl
Algorithm Hash digest
SHA256 8e3117d33e78053e6040e4984d8864206ee6f06682a9d6e8e9ba90492df1e676
MD5 3cf56f29290f6f37447902d5c14d0069
BLAKE2b-256 f6664bd40b44ecbba84f8be8f660b781772dc3e66522609cef0c140043ee016e

See more details on using hashes here.

Provenance

The following attestation bundles were made for clipwright_bgm-0.3.1-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