---
id: typed-ffmpeg
version: "4.3"
license: MIT
license_treatment: permissive
maintenance: active
---

# typed-ffmpeg — Modern Python & TypeScript FFmpeg wrappers with comprehensive typing (latest version)

License: permissive · Maintenance: active · Downloads: 93.6K/mo

## What it is and what it does

typed-ffmpeg is a Python wrapper that brings type hints and IDE autocomplete to FFmpeg operations. Instead of building FFmpeg command strings or subprocess calls by hand, you construct filter graphs and I/O operations as Python objects with full type information, letting your editor catch mistakes before runtime.

The package depends on typed-ffmpeg-v8 at runtime and requires FFmpeg itself to be installed separately on your system. It supports Python 3.10 through 3.13 and is actively maintained. You build pipelines by chaining method calls—input files, filters like hflip or overlay, and output specifications—then call run() to execute the underlying FFmpeg process.

Use it for:

- Automate video transcoding workflows with type-safe filter chains in production scripts.
- Build interactive multimedia tools where IDE autocomplete helps discover available filters and codecs.
- Compose complex filter graphs (trim, concat, overlay) without manually writing FFmpeg filter syntax.
- Integrate video/audio processing into Python applications while catching filter configuration errors at edit time.
- Serialize and visualize filter graphs for debugging or documentation purposes.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A Python wrapper around FFmpeg with full type hints and IDE autocomplete support, letting you build video and audio processing pipelines with compile-time type checking.

Yes, if you regularly work with FFmpeg in Python and want type safety and IDE support. The low install friction, active maintenance, permissive license, and zero known vulnerabilities make it a solid choice. The main prerequisite is having FFmpeg installed separately on your system, which is a one-time setup cost.

## Install

pip install typed-ffmpeg
uv add typed-ffmpeg
poetry add typed-ffmpeg

## Installing typed-ffmpeg

Before you install: Low friction install as a pure-Python wheel. Actively maintained with a recent release. Requires FFmpeg to be installed separately on your system.

License in practice: MIT license is permissive; you can use this in commercial and proprietary projects with minimal restrictions.

Quickstart:

pip install typed-ffmpeg

import ffmpeg

input_file = ffmpeg.input("input.mp4")
output_file = input_file.hflip().output("output.mp4")
output_file.run()

FFmpeg must be installed on your system; Python 3.10 or later required.

Verify before relying:

- Whether the package provides meaningful runtime validation beyond type hints.
- Whether filter graph visualization and JSON serialization are fully documented and stable.
- Performance overhead of the wrapper compared to direct FFmpeg CLI calls.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 93.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

ffmpeg python wrapper, typed ffmpeg bindings, video processing with types, audio filter graph python, ffmpeg filter automation, python multimedia automation, ffmpeg command builder, ffmpeg-wrapper, type-hints, multimedia

[View on SkillFed](https://skillfed.io/packages/typed-ffmpeg) · [View on PyPI](https://pypi.org/project/typed-ffmpeg/)