typed-ffmpeg
Modern Python & TypeScript FFmpeg wrappers with comprehensive typing (latest version)
Decision gist · record as of 2026-08-14
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.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- FFmpeg must be installed on your system; Python 3.10 or later required.
- Low friction install as a pure-Python wheel.
- Actively maintained with a recent release.
License · maintenance · safety
MIT (permissive) — MIT license is permissive; you can use this in commercial and proprietary projects with minimal restrictions.
last release 2026-07-06 (39 days)
0 known vulnerabilities (OSV.dev, 2026-08-14) · 93,626 downloads/mo, #13,375 on PyPI
Alternatives
Verify before relying
pip install typed-ffmpeg
import ffmpeg
input_file = ffmpeg.input("input.mp4")
output_file = input_file.hflip().output("output.mp4")
output_file.run()- 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.
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 on this page. Verify before relying on it.
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
typed-ffmpeg on PyPI
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.
FFmpeg must be installed on your system; Python 3.10 or later required.
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()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 the current Python release >=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 1 packagetyped-ffmpeg-v8 |
| Maintenance | Actively maintained 39 days since the last release |
| First released | |
| Downloads | 93,626 / month, #13,375 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Intended Audience :: DevelopersNatural Language :: EnglishOperating System :: OS IndependentProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Topic :: Multimedia :: Sound/AudioTopic :: Multimedia :: Video |
Evidence: typed_ffmpeg-4.3-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “ffmpeg python wrapper”
- typed-ffmpegA Python wrapper around FFmpeg with full type hints and IDE…
- imageio-ffmpegProvides a simple Python wrapper around ffmpeg for reading and…
- ffmpegWraps FFmpeg and FFprobe command-line tools to programmatically…
Give your agent the search over MCP, or paste the wish link into any chat.
More Sound/Audio packages
Reads and writes audio files in formats like WAV, FLAC, OGG, and MAT through libsndfile, exposing audio data as NumPy arrays.
Pydub provides a high-level Python interface for loading, manipulating, and exporting audio files with simple operations like slicing, concatenation, and format conversion.
However, the abandoned status since 2021-03-10 means no future fixes or compatibility updates—use it only if you can tolerate potential issues with newer Python…
Mutagen reads and writes audio metadata (tags) across many audio formats including MP3, FLAC, OGG, MP4, WavPack, and others, supporting ID3v2 and APEv2 tag editing.
Install it if you need to read or edit audio tags programmatically.
Provides PyTorch-based audio processing, transforms, and dataloaders for machine learning tasks, with GPU acceleration and autograd support for trainable audio features.
MoviePy is a Python library for video editing that reads, processes, and writes video and audio files by converting them to numpy arrays for frame-level manipulation and effect application.
Reads metadata (artist, title, duration, bitrate, and more) from audio files in formats including MP3, MP4, FLAC, OGG, WAV, and others, without writing or modifying tags.
Install it if you need to extract metadata from audio files without the overhead of a heavier library.
See also ffmpeg-python · python-ffmpeg · ffmpy · python-mpv · ffmpeg · static-ffmpeg · sk-video · ha-ffmpeg · torchcodec