imageio-ffmpeg
FFMPEG wrapper for Python
Decision gist · record as of 2026-08-14
Yes, if you need straightforward video frame reading/writing without managing ffmpeg installation separately. The bundled binaries and zero runtime dependencies make it convenient for cross-platform distribution. However, consider PyAV instead if you need better performance, more advanced features, or are already comfortable with C-level bindings. The dormant maintenance status (575 days since release) is not a blocker for stable use but means security or compatibility updates may lag; monitor the repository for any critical ffmpeg vulnerabilities.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.9 or later.
- Wheels are platform-specific; installation on unsupported architectures or older Linux kernels (pre-2.6.32) may require building from source or providing your own ffmpeg binary via IMAGEIO_FFMPEG_EXE environment variable.
- Medium install friction due to platform-specific wheels (Windows, macOS Intel/ARM, Linux x86_64/aarch64), but wheels include ffmpeg binaries so no external system dependency required.
License · maintenance · safety
BSD-2-Clause (permissive) — BSD-2-Clause is permissive; you can use, modify, and distribute this package with minimal restrictions, provided you include the license notice.
last release 2025-01-16 (575 days) · last repo commit 2025-01-16 · 296 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 14,321,387 downloads/mo, #1,236 on PyPI
Alternatives
Verify before relying
pip install imageio-ffmpeg
from imageio_ffmpeg import read_frames, write_frames
# Read frames
reader = read_frames('video.mp4')
meta = reader.__next__()
for frame in reader:
process(frame)
# Write frames
writer = write_frames('output.mp4', size=(width, height))
writer.send(None)
for frame in frames:
writer.send(frame)
writer.close()- Whether the included ffmpeg binary is kept current with upstream ffmpeg security patches and feature releases.
- Performance characteristics compared to PyAV or direct ffmpeg subprocess calls for typical video workloads.
- Compatibility with ffmpeg versions older than those bundled in the wheels.
What it is and what it does
imageio-ffmpeg is a lightweight Python wrapper that spawns ffmpeg as a subprocess and communicates video frames over pipes using Python generators. It bundles platform-specific ffmpeg binaries in wheels for Windows, macOS (Intel and ARM), and Linux, eliminating the need to install ffmpeg separately on common platforms. The library provides two main functions: read_frames() to iterate over video frames with metadata, and write_frames() to encode frames into a video file. It has no runtime dependencies and works with Python 3.9+.
The package is designed for straightforward video I/O tasks where you need to read or write frames programmatically. It is lower-level than imageio's ffmpeg plugin but higher-level than calling ffmpeg directly. The documentation notes that PyAV is now a faster, more feature-rich alternative with binary wheels for many platforms, making it worth considering if you need better performance or more advanced ffmpeg features.
Use it for
- Extract frames from video files for computer vision or machine learning preprocessing pipelines.
- Encode sequences of image frames or numpy arrays into video files with custom codecs and bitrates.
- Build video processing tools that need reliable ffmpeg subprocess management without external system dependencies.
- Integrate video I/O into scientific or educational applications where ffmpeg is needed but system installation is inconvenient.
- Automate video format conversion or re-encoding with fine control over ffmpeg parameters (pixel format, fps, quality, codec).
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you need straightforward video frame reading/writing without managing ffmpeg installation separately.
The bundled binaries and zero runtime dependencies make it convenient for cross-platform distribution. However, consider PyAV instead if you need better performance, more advanced features, or are already comfortable with C-level bindings. The dormant maintenance status (575 days since release) is not a blocker for stable use but means security or compatibility updates may lag; monitor the repository for any critical ffmpeg vulnerabilities.
Install
imageio-ffmpeg on PyPI
Before you install
Medium install friction due to platform-specific wheels (Windows, macOS Intel/ARM, Linux x86_64/aarch64), but wheels include ffmpeg binaries so no external system dependency required. Dormant maintenance (575 days since last release) but repo remains active; last commit 2025-01-16.
Requires Python 3.9 or later. Wheels are platform-specific; installation on unsupported architectures or older Linux kernels (pre-2.6.32) may require building from source or providing your own ffmpeg binary via IMAGEIO_FFMPEG_EXE environment variable.
License in practice
BSD-2-Clause is permissive; you can use, modify, and distribute this package with minimal restrictions, provided you include the license notice.
Quickstart
pip install imageio-ffmpeg
from imageio_ffmpeg import read_frames, write_frames
# Read frames
reader = read_frames('video.mp4')
meta = reader.__next__()
for frame in reader:
process(frame)
# Write frames
writer = write_frames('output.mp4', size=(width, height))
writer.send(None)
for frame in frames:
writer.send(frame)
writer.close()Verify before relying
- Whether the included ffmpeg binary is kept current with upstream ffmpeg security patches and feature releases.
- Performance characteristics compared to PyAV or direct ffmpeg subprocess calls for typical video workloads.
- Compatibility with ffmpeg versions older than those bundled in the wheels.
Package facts
| License | BSD-2-Clause permissive |
| Python support | Supports the current Python release >=3.9 |
| Install friction | Medium. Platform-specific wheel |
| Runtime dependencies | None |
| Maintenance | Dormant 575 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 14,321,387 / month, #1,236 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableIntended Audience :: DevelopersIntended Audience :: EducationIntended Audience :: Science/ResearchLicense :: OSI Approved :: BSD LicenseOperating System :: MacOS :: MacOS XOperating System :: Microsoft :: WindowsOperating System :: POSIXProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.9 |
Evidence: imageio_ffmpeg-0.6.0-py3-none-macosx_10_9_intel.macosx_10_9_x86_64.whl; imageio_ffmpeg-0.6.0-py3-none-macosx_11_0_arm64.whl; imageio_ffmpeg-0.6.0-py3-none-manylinux2014_aarch64.whl; imageio_ffmpeg-0.6.0-py3-none-manylinux2014_x86_64.whl; imageio_ffmpeg-0.6.0-py3-none-win32.whl; imageio_ffmpeg-0.6.0-py3-none-win_amd64.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 › “read write video frames”
- imageio-ffmpegProvides a simple Python wrapper around ffmpeg for reading and…
- sk-videoReads, writes, and processes video files using FFmpeg as its backend,…
- PIMSPIMS provides a unified interface to read scientific video and image…
Give your agent the search over MCP, or paste the wish link into any chat.
More Graphics packages
Pillow adds image processing capabilities to Python, providing file format support, efficient pixel data handling, and image manipulation operations.
Install it if you need to work with images in Python—it is the de facto standard for this task.
fonttools manipulates font files in multiple formats (TrueType, OpenType, AFM, Type 1, Mac-specific) and includes TTX, a tool to convert fonts to and from XML text format.
Install it if you need to read, write, or manipulate fonts programmatically or via the TTX command-line tool.
Enables matplotlib figures to display inline directly within Jupyter notebooks and IPython environments instead of in separate windows.
PyMuPDF extracts, renders, converts, and manipulates PDF and other document formats (XPS, EPUB, images, Office files via Pro) with high performance, providing text, tables, images, and metadata with precise layout information.
The AGPL license requires careful review if you are building proprietary software—commercial licensing is available from Artifex.
pypdfium2 is a Python binding to PDFium that enables PDF rendering, inspection, manipulation, and creation through a ctypes interface to Google's PDFium library.
Install it if you need PDF rendering, inspection, or manipulation in Python; the medium install friction is offset by comprehensive platform support.
Altair is a declarative Python library for creating interactive statistical visualizations by writing simple, readable code that compiles to Vega-Lite specifications.
See also ImageIO · mediapy · PIMS · knowit · moviepy · ffmpeg-python · ffmpeg · python-ffmpeg · scikit-video · torchcodec