Our take
- Activity
- 78
- Community
- 32
- Issues
- 21
- Pull requests
- 86
+3 stars in the last 30 days
- Merges more pull requests than 100% of the projects we track
Project history
Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.
Stars
1,166Forks
23Change since Nov 16, 2026: +1 stars·0 forks
Overview
typed-ffmpeg is a library for building FFmpeg commands and filter graphs from Python, with experimental bindings for TypeScript. It addresses the difficulty of composing complex FFmpeg operations by hand, adding filter-aware typing and editor assistance to a fluent API inspired by ffmpeg-python.
It is useful when media-processing code needs repeatable, inspectable filter graphs rather than manually maintained command strings. The library also supports graph serialization, visualization, and media probing. See the GitHub repository and documentation for details.
Key Features
- Build FFmpeg commands and complex filter graphs through a fluent API.
- Get type information and IDE completion for a broad set of FFmpeg filters.
- Serialize and reload filter graphs as JSON.
- Validate filter graphs and assist with correcting errors.
- Visualize graphs with the optional Graphviz integration.
- Probe media files with ffprobe and access extracted metadata.
- Install Python bindings tailored to different FFmpeg major versions.
- Use experimental TypeScript packages with version-specific filter annotations.
Use Cases
- Python developers composing video or audio filter chains who want editor completion and typed parameters.
- Media-processing applications that need to generate FFmpeg commands from configurable inputs.
- Teams that want to save, reload, inspect, or visualize filter graphs as part of a repeatable workflow.
- TypeScript developers evaluating a typed FFmpeg API for Node.js or browser-oriented projects, while accepting its experimental status.
Getting Started
Install the Python package matching your FFmpeg version. For the default package:
pip install typed-ffmpeg
FFmpeg must already be installed on your system. For TypeScript setup and usage details, consult the README.
Considerations
- FFmpeg is a system requirement; the Python package does not replace the FFmpeg executable.
- The TypeScript bindings are explicitly experimental.
- Python packages are split by FFmpeg major version, so select a package compatible with the FFmpeg installation in use.
- Graph visualization and CLI parsing support require optional extras.
Found this useful?
Share it with someone who would like typed-ffmpeg.