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.2.tar.gz (7.8 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.2-py3-none-any.whl (9.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: clipwright_bgm-0.3.2.tar.gz
  • Upload date:
  • Size: 7.8 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.2.tar.gz
Algorithm Hash digest
SHA256 d86a6e145d238d5d62aeee18e3ae1d7727757260fb0f263d6148faa94b1359f2
MD5 47edb762f87802849d2e6fa16990b874
BLAKE2b-256 d1ef145f0ee76343d9d7b14469be4003069e0c20483f56f4ad0b07ad060c7653

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: clipwright_bgm-0.3.2-py3-none-any.whl
  • Upload date:
  • Size: 9.5 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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 fa6502b05bca8c772b2ecc220802eb18c610410ed38aea1cfea8b8f7ce065478
MD5 732d6a266adb929ca505c3d4b73fc2dc
BLAKE2b-256 98c763f910a12d0ca7708cd0dece1b95abe810bca155a4afbf2dcb7becd25022

See more details on using hashes here.

Provenance

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