# kkroening/ffmpeg-python

Python bindings for FFmpeg - with complex filtering support

Repository: https://github.com/kkroening/ffmpeg-python
Canonical: https://ross.abutalabs.com/products/ffmpeg-python
Language: Python
License: Apache-2.0
License Family: permissive
Last push: 2024-08-04T00:07:08+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 3398, "days_push": 760, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 11009, forks 944 (observed 2026-08-28T04:10:45.866855+00:00)

## What it is
ffmpeg-python is a Python library that builds FFmpeg command lines programmatically, with strong support for complex filter graphs. It lets users compose media processing pipelines in readable Python instead of gnarly ffmpeg CLI arguments.

## Use cases
- convert video files with python
- build complex ffmpeg filter graphs
- overlay images on video programmatically
- trim and concatenate video clips in python
- extract audio from video files
- flip or scale videos with a fluent api

## When to choose
- you need complex filter_complex graphs that other wrappers can't express
- you prefer composing ffmpeg pipelines in readable Python code
- you want to generate ffmpeg command-line arguments dynamically

## When to avoid
- you need a maintained project with active development
- you want to process media without FFmpeg installed as an external binary
- you need real-time streaming playback rather than file transcoding

## Facets
- artifact type: library
- maturity: maintenance
- function: video-processing, audio-processing, cli
- domain: media, developer-tools
- platform: python, cross-platform
- tags: ffmpeg, video-editing, filter-graphs, media-transcoding, wrapper, video, audio

## Member repositories
- kkroening/ffmpeg-python (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:45.866855+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:17:13.410119+00:00, confidence not recorded.
  - readme: https://github.com/kkroening/ffmpeg-python (fetched 2026-08-28T04:10:45.866855+00:00, sha 79d386dca42b)
  - registry_pypi: https://pypi.org/pypi/ffmpeg-python/json (fetched 2026-08-29T08:15:39.795841+00:00, sha 31d2bb2b40d9)
- Data as of 2026-08-30T08:39:29.467469+00:00.