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.0.tar.gz (7.3 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.0-py3-none-any.whl (9.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: clipwright_bgm-0.3.0.tar.gz
  • Upload date:
  • Size: 7.3 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.0.tar.gz
Algorithm Hash digest
SHA256 2b2039b52e4969802595ed969b96e7898b8d6df69ff0a64c4e5d5301783b658f
MD5 ffa11fbd90da95c6fc8d8fb6277adf45
BLAKE2b-256 9a759711636263aec56019ca12e6c2be37ab0a6bde25d7ef6a53e7e79632934d

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: clipwright_bgm-0.3.0-py3-none-any.whl
  • Upload date:
  • Size: 9.0 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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 5ff837656109dc3735d66ed05527437146b9b97852ca1bf2325b5fabcb91f0ca
MD5 d3a8f9340a1ea5144962d7fd292f53a0
BLAKE2b-256 ba5576895a4c59c55b12b19a0b58a2c64ef7f9ed948f6d5d7b8947c4b814a4ab

See more details on using hashes here.

Provenance

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