livingbio

typed-ffmpeg: Build Type-Safe FFmpeg Filter Graphs

typed-ffmpeg provides Python and experimental TypeScript interfaces for constructing FFmpeg commands with filter-aware typing. It suits developers who want editor support, reusable filter graphs, and clearer validation than assembling command-line strings by hand.

View on GitHub Compare
Stars
1.2k
Forks
22
Stars, last 30 days
+3

Our take

Health score

54/100

How it is scored
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.

Selected snapshot

Stars

1,166

Forks

23

Change 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.