typed-ffmpeg 3.0: Strongly-Typed FFmpeg Interface for Python with Visual Playground

🎬 typed-ffmpeg 3.0 – A Strongly-Typed Python Interface to FFmpeg + Interactive Playground

If you’ve ever written long, fragile FFmpeg command strings and wished for a better developer experience, typed-ffmpeg might be what you’re looking for.

It brings autocomplete, type safety, validation, and now even a visual editor to FFmpeg workflows—all from Python.

GitHub: https://github.com/livingbio/typed-ffmpeg

⸻

🚀 What typed-ffmpeg Does

typed-ffmpeg lets you build FFmpeg filter graphs in Python using a typed, object-oriented API. It solves common issues with tools like ffmpeg-python, such as: Missing type hints and autocomplete

It also introduces:

• JSON serialization of graphs
• FFmpeg command validation and auto-correction
• Reverse CLI parsing (in v3.0)

⸻

👥 Who It’s For

If you work with video/audio processing and want to:

• Automate FFmpeg workflows in production
• Build content/media pipelines for research or education
• Debug and share filter graphs more easily

⸻

🔄 What’s New in v3.0

Here are the highlights from the latest release:

✅ Source Filter Support

Use FFmpeg source filters like color, anullsrc, testsrc, etc., with full autocomplete and type safety.

Docs: https://livingbio.github.io/typed-ffmpeg/usage/complex-filtering/#applying-source-filters

✅ Input Stream Selection

Now supports stream specifiers (e.g., [0:v], [1:a]) across multiple inputs.

Docs: https://livingbio.github.io/typed-ffmpeg/usage/basic-api-usage/#stream-selection

🧪 Interactive Playground

A new visual tool to build, edit, and test FFmpeg filter graphs:

🔗 https://livingbio.github.io/typed-ffmpeg-playground/

Features:

• Drag-and-drop filter graph builder
• Generates both FFmpeg CLI and typed-ffmpeg Python code
• Paste any FFmpeg CLI to reverse-parse it into a visual graph

🧱 Internal APIs for Tooling

v3.0 also introduces:

• parse cli to graph: – Convert FFmpeg CLI to internal graph objects
• generate python code: – Emit typed-ffmpeg code from a graph

These make it easier to build advanced tooling or plugins around FFmpeg logic.

⸻

📦 Installation

pip install -U typed-ffmpeg