typed-ffmpeg

library4.1pypypiunverified

Modern Python & TypeScript FFmpeg wrappers with comprehensive typing. Provides a type-safe, human-friendly API for building FFmpeg command lines. Version 4.1 requires Python >=3.10 and features improved type annotations and async support.

devops

pip install typed-ffmpeg

INSTALL

IMPORT

SIG · TYPED-FFMPEG

typed-ffmpeg

devopspythonv4.1

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

FFmpeg

✓ from typed_ffmpeg import FFmpeg

Stream

✓ from typed_ffmpeg import Stream

Basic usage: create FFmpeg instance, chain input/output, run.

from typed_ffmpeg import FFmpeg ffmpeg = FFmpeg() ffmpeg.input('input.mp4').output('output.mp4', vcodec='libx264', acodec='aac').run()

Debug

Known issues

breakingIn version 4.x, the API changed from function-based calls to a class-based builder pattern. Old code using `from typed_ffmpeg import ffmpeg` (as a module) will break.

fix

Upgrade to 4.x: `pip install -U typed-ffmpeg` and use `from typed_ffmpeg import FFmpeg; ffmpeg = FFmpeg()`.

affects: <4.0

deprecatedThe `FFmpeg()` object's `run()` method now returns an `asyncio` coroutine if called without `blocking=True`. In version 3.x, `run()` was synchronous by default.

fix

Pass `blocking=True` to `run()` for synchronous execution, or await the coroutine.

affects: >=4.0

gotchaInput and output file paths must be passed as keyword arguments (e.g., `input=...`) in version 4.x, not positional.

fix

Use `FFmpeg().input('file.mp4').output('out.mp4')` instead of `FFmpeg.input('file.mp4','out.mp4')`.

affects: >=4.0

Upgrade

Version history

4.1latest on PyPI · released Apr 18, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

8 hits · last 30 days

node

Resources

No resource links recorded.