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.3.tar.gz (7.7 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.3-py3-none-any.whl (9.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: clipwright_bgm-0.3.3.tar.gz
  • Upload date:
  • Size: 7.7 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.3.tar.gz
Algorithm Hash digest
SHA256 7017c3fa8cd32d78ff36779528ca0df53890c6ccdbbbffd314f48f6f5fab3687
MD5 3b854f164d5a68b2019bc5643c83b84f
BLAKE2b-256 1b526633f81c89f8705d2cb148df440f2323a4a970f6e0b367073817e35cfd77

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: clipwright_bgm-0.3.3-py3-none-any.whl
  • Upload date:
  • Size: 9.3 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.3-py3-none-any.whl
Algorithm Hash digest
SHA256 184a7cea5add8c597cf82b4f271f188e3bb5fb5cbbe4fc68f3098d6791105b7a
MD5 1097f5f4b97286dd351e2fbf9ad8fb44
BLAKE2b-256 35bcbf59fd4d6d4e919fdb7e0310b74fd90191fabb3f6a143b6f3371325e567a

See more details on using hashes here.

Provenance

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