mixing

Tools for video and audio editing in Python — slicing, fades, audio replace/mix, Ken Burns, thumbnails, subtitles, speech-to-text + filler removal, TTS dubbing, and chapter detection.

pip install mixing

🤖 AI-first: start with the skills & agents

mixing is built to be driven by AI coding agents. The fastest, most reliable way to use it is through the bundled skills and agents in .claude/ — task-oriented playbooks that encode the right functions, the calling conventions, and the gotchas, so an agent gets it right the first time.

Skills (.claude/skills/) — how to use mixing for a task:

Skill	Use it for
`mixing`	Start here — router, architecture, the `output` protocol, extras
`mixing-audio`	slice, fade, crop, concat, overlay, normalize, align, segment audio
`mixing-video`	slice, crop, loop, speed, replace/normalize audio, Ken Burns, thumbnails, subtitles
`mixing-transcript`	transcribe, remove fillers, SRT/prose, chapters
`mixing-dubbing`	TTS re-voicing & SRT translation

Agents (.claude/agents/):

mixing-editor — performs an editing task end-to-end ("edit this media …").
mixing-dev — works on the mixing codebase.

Using Claude Code? These are discovered automatically from .claude/. The architectural contract they share lives in .claude/CLAUDE.md.

Quick start

import mixing  # cheap: no moviepy/opencv loaded yet

assert mixing.has_ffmpeg()  # most ops need ffmpeg on PATH

# --- audio ---
from mixing.audio import Audio

Audio("song.mp3")[10:30].fade_in(2).fade_out(3).save(output="clip.mp3")

# --- video ---
from mixing.video import replace_audio, ken_burns_video

replace_audio("clip.mp4", "music.mp3", mix_ratio=0.7, output="mixed.mp4")
ken_burns_video("cover.jpg", duration=8, output="cover.mp4")

# --- transcript: remove "uh"/"um" (ElevenLabs Scribe + ffmpeg) ---
from mixing.transcript import remove_fillers

result = remove_fillers("talk.mov", "out/")  # uses $ELEVENLABS_API_KEY
print(result.cleaned_media)

Core ideas (learn once)

The output protocol. Every result-producing function takes one output argument whose role is constant and type is open:

crop_video("in.mp4", 5, 15, output="out.mp4")  # file → writes it, returns Path
crop_video("in.mp4", 5, 15, output="clips/")  # dir  → auto-named file inside
crop_video("in.mp4", 5, 15)  # None → saves beside the input
fade_in("in.mp3", output=lambda audio: audio)  # callable → receives the result

Object producers (audio editing) return the in-memory object when output=None, so you can chain and save when ready. Functions that emit several artifacts qualify the destinations (remove_fillers(media, output_dir=…, output_media=…)).

Lazy & tiered. import mixing (and import mixing.chapters / mixing.srt) pull no heavy backends; moviepy/opencv/pydub load only when you touch a name that needs them. Import the facade (mixing.Video) or the subpackage (from mixing.video import Video).

Sliceable media. Audio and Video are lazy, sliceable, context-managed views:

from mixing.video import Video

with Video("movie.mp4") as v:
    v[10:30].save(output="cut.mp4")  # seconds; v[100] returns a single frame

Requirements

ffmpeg on PATH (most operations). macOS: brew install ffmpeg; Debian/Ubuntu: sudo apt install ffmpeg; Windows: download from ffmpeg.org and add bin to PATH.
ElevenLabs API key for mixing.transcript / mixing.dubbing (ELEVENLABS_API_KEY, or pass api_key=). Responses are cached on disk, so re-runs are free and offline.
Google Cloud auth for AI video generation (mixing.video.genai, Vertex AI Veo).

Optional extras

pip install mixing[audio]      # pydub / ffmpeg-python / soundfile
pip install mixing[widget]     # interactive Jupyter audio widget
pip install mixing[gen]        # Google Vertex AI Veo generation
pip install mixing[llm]        # aix — chapter titling + SRT translation
pip install mixing[clipboard]  # get file paths from the clipboard

What's inside

Subpackage	Highlights
`mixing.audio`	`Audio`, `fade_in/out`, `crop_audio`, `concatenate_audio`, `overlay_audio`, `loop_audio`, `duck_audio`, `find_audio_offset`, `find_segments`/`extract_segments`
`mixing.video`	`Video`, `crop_video`, `loop_video`, `change_speed`, `replace_audio`, `normalize_audio`, `overlay_ambient_bed`, `ken_burns_video`/`ken_burns_film`, `concatenate_videos` (+ transitions: `crossfade_transition`, `fade_through_black`, …), `make_thumbnail`, `write_subtitles_in_video`, `SOCIAL_SIZES`
`mixing.video.genai`	`generate_video` (Vertex AI Veo)
`mixing.transcript`	`transcribe`, `remove_fillers`, `srt_for_media`, `words_to_srt`/`words_to_prose`
`mixing.chapters`	`detect_chapters`, `Chapter`
`mixing.dubbing`	`text_to_speech`, `list_voices`, `translate_srt`, `dub_video_from_srt`
`mixing.srt`	`Cue`, `parse_srt`, `dump_srt`, `seconds_to_srt_time`

See the skills for the full, example-driven API of each.

License

MIT

Metadata

Release files for mixing 0.0.41

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mixing 0.0.41
File	Size	Uploaded
mixing-0.0.41.tar.gz	4.0 MB	Sep 4, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for mixing 0.0.41
File	Interpreter	ABI	Platform	Reset
mixing-0.0.41-py3-none-any.whl 236.1 kB Sep 4, 2026	Python 3	none	any	Details

Total release size: 4.2 MB

Release files / mixing-0.0.41.tar.gz

Download URL	mixing-0.0.41.tar.gz
Size	4.0 MB
Tags	Source
SHA-256 checksum How to use checksums	`0ae83790dd3d948cddb4c4b7d14afac755e93704a51218e5d5153ffa4fea8ad3`
BLAKE2b-256 checksum How to use checksums	`c2df982681ea16a547f2462f5a770d06303a0b5a40dda0340809e3ba0433d7e0`
Upload date	Sep 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.9 {"installer":{"name":"uv","version":"0.12.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`

Release files / mixing-0.0.41-py3-none-any.whl

Download URL	mixing-0.0.41-py3-none-any.whl
Size	236.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`3f3816691425ddce2a96c0bf990808864b131bdb9de0c4a08f121b6a2f16583c`
BLAKE2b-256 checksum How to use checksums	`ff10470d98ee3f784684e0446f5f1ac812565325ad76218bd17e78710cc0909a`
Upload date	Sep 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.9 {"installer":{"name":"uv","version":"0.12.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}`