NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI, #523 most downloaded on PyPI
Read and write images and video across all major formats. Supports scientific and volumetric data.
Latest stable
2.38.1
Last release 1 months ago
08 Oct 2026
Release timing varies
gaps range from 1 weeks to 10 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
1 version withdrawn
withdrawn after publishing
14 years old
102 releases · first in 2012
Drag across the ruler to compare, or tap a release to open it.
Only force webcam FPS on Mac (#701) (`28b1d0d`)
Only run CD on main and fail fast (#698) (`e90494a`)
Your coding agent can read these notes before it upgrades. Set up the MCP server →
### Documentation * Fix typos. (#696) (`67239f3`)
Allow plugin objects in plugin kwarg (#689) (`8f0f689`)
Fix BytesIO regression for legacy pillow (#688) (`924e1c5`)
Choose plugin based on extension and plugin lazy-import (#680) (`bdbe699`)
Resolve regression on imageJ TIFF hyperstacks (#682) (`7dc9b25`)
Consistently handle file opening/closing (#673) (`b852f45`)
Fix file extension bug when filename contains '#'. (#678) (`f3fa631`)
Allow devices above in ffmpeg (#675) (`1fc4208`)
Install ImageIO dependencies during release wheel build (#671) (`f1ee22a`)
More robust loading of FEI SEM data (#529 by jon-lab).
Fix deprecation warning for numpy.
(skipping version 2.7 to avoid confusion with Python v2.7.)
Mentioning here for completeness: imageio-ffmpeg 0.4.0 was also recently released, which fixes several (stability) issues for video io.
Reader.__len__ work again when length is inf (stream/unknown).-framerate input param for ffmpeg when using webcam, fixing webcam support on macOS.Fixed potential error when creating a new appdata directory.
Fixed a security vulnerability for Windows users that have dcmtk installed, and where an attacker can set the filename.
This will likely be the last release to support Python 2.7.
Fixed:
image_as_uint (#451 by clintg6).Added:
mimread and mvolread (#442 by Chris Barnes).The ffmpeg plugin has been refactored:
The ffmpeg plugin has been refactored:
pip install imageio-ffmpeg instead of the download step.inf as the number of
frames. Use reader.count_frames() to get the actual number, or estimate
it from the fps and duration in the meta data.CannotReadFrameError.Other changes:
Fix installation issue on flavors of Ubuntu 14.04 /w Python 2.7 (#378).
np.frombuffer instead of np.fromstring in some cases.Renamed Image class to Array and add documentation for this ndarray subclass.
Image class to Array and add documentation for this ndarray subclass.Console entry points for binary downloads (by Paul Mueller).
mimwrite() and mvolwrite() functions also work with generators.tifffile.py implementation.imread().fps argument to force reading at a specific FPS.New format for grabbing screenshots (for Windows and OS X).
volread() to obtain the image
data as one array.conda install ffmpeg -c conda-forge).close() on Pillow images.Fix animated gif writer that was broken in newer Pillow version.
A bugfix release:
seek() and tell().Minor improvements related to Debian packaging.
Minor improvements related to Debian packaging.
Standard images now have to be specified using e.g. imageio.imread('imageio:chelsea.png') to be more explicit about being a special case and potential
imageio.imread('imageio:chelsea.png') to be more explicit about being
a special case and potentially involving a download.Nothing published for this version
This release introduces a new plugin based on Pillow, which will take care of the "common formats" like PNG and JPEG, which was previously the role of
This release introduces a new plugin based on Pillow, which will take care of the "common formats" like PNG and JPEG, which was previously the role of the FreeImage plugin. The latter is still available but the FreeImage library is no longer distributed by default.
Got rid of Lena image because it can be regarded offensive and is not (explicitly) publicly licensed.
Freeimage conda package (in main channel) is updated and works on all major OS's.
Various improvements to the ffmpeg plugin.
This release features several fixes and small improvements, especially to the ffmpeg plugin.
This release features several fixes and small improvements, especially to the ffmpeg plugin.
Basically a hotfix release. But some new features were introduced.
Basically a hotfix release. But some new features were introduced.
Imageio is now a dependency of Moviepy _, which exposed a few issues to fix. Imageio is now also available as a Debian package (thanks Ghislain!). Fur
Imageio is now a dependency of Moviepy <https://github.com/Zulko/moviepy/>_,
which exposed a few issues to fix. Imageio is now also available as a
Debian package (thanks Ghislain!). Furher, we tweaked our function names
to be cleared and more consistent (the old names still work).
Xsave() functions are renamed to Xwrite().
Also read() and save() are now get_reader() and get_writer().
The old names are available as aliases (and will be for the foreseable
future) for backward compatibility.mimread('hunger games.avi').In this release we did a lot of work to push imageio to a new level. The code is now properly tested, and we have several more formats.
In this release we did a lot of work to push imageio to a new level. The code is now properly tested, and we have several more formats.
The big changes:
Many unit tests were written to cover over 95% of the code base. (the core of imageio has 100% coverage).
Setup continuous integration (CI) using Travis.
Imageio now follows PEP8 style guides (and this is tested with CI).
Refactoring of the code base. Resulting in a cleaner namespace.
Many improvements to the documementation.
Plugins:
The FFMPEG format is now well supported. Binaries are provided.
New AVBIN format for more efficient reading of video files.
New NPZ format that can store (a series of) arbitrarily shaped numpy arrays.
New SWF format (shockwave flash) for lossless animated images.
Improvements to the GIF format. The GIF and ANIGIF formats are now merged.
Further:
New simple website to act as a front page (http://imageio.github.io).
Compatibility with Pypy.
We provide a range of standard images that are automatically downloaded.
Binaries (libs and executables) that plugins of imageio uses are now downloaded at runtime, not at build/install time. This simplifies things a lot.
freeimage plugin now fully functional on pypy
Added utilities for developers (run python make from the repo root).
PNG, JPEG, BMP,GIF and other plugins can now handle float data (pixel values are assumed to be between 0 and 1.
Imageio now expand the user dir when filename start with '~/'.
Many improvements and fixes overall.
DICOM reader closes file after reading pixel data (avoid too-many-open-files error)
Nothing published for this version
Raise error if URI could not be understood.
Some more thorough testing resulted in several fixes and improvements over the last release.
Some more thorough testing resulted in several fixes and improvements over the last release.
Fix in dicom reader (RescaleSlope and RescaleIntercept were not found)
Fix installation/distribution issue.
This was a long haul. Implemented several plugins for animation and volumetric data to give an idea of what sort of API's work and which do not.
This was a long haul. Implemented several plugins for animation and volumetric data to give an idea of what sort of API's work and which do not.
Fixed issue 2 (fail at instal, introduced when implementing freezing)
* Improved documentation. * Worked on distribution. * Freezing should work now.
Introduction of the imageio.help function.
One column per quarter.