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 addbinto PATH. - ElevenLabs API key for
mixing.transcript/mixing.dubbing(ELEVENLABS_API_KEY, or passapi_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, 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
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file mixing-0.0.34.tar.gz.
File metadata
- Download URL: mixing-0.0.34.tar.gz
- Upload date:
- Size: 23.4 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b82fec8206c1792a3739fe9f46840c62f6a38cf8400ecbc45b145a3b64f28bcf
|
|
| MD5 |
2387c1213f1daebe6a8ffff858084537
|
|
| BLAKE2b-256 |
96a856e23ef26f9a83970d5789449e92c738b2e492c3b864626b720ce4d0109a
|
File details
Details for the file mixing-0.0.34-py3-none-any.whl.
File metadata
- Download URL: mixing-0.0.34-py3-none-any.whl
- Upload date:
- Size: 191.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
89e28342a7bb8ef0b1095b7467815f151b4d0f498dd317958c7b335a720c3993
|
|
| MD5 |
c11a9ef2845e7b901882160df1aaa141
|
|
| BLAKE2b-256 |
03021efb0f51a683109f14633018c05b65b7b24b0414592563b25464fb46528e
|
