NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #820 most downloaded on PyPI
Read and write TIFF files
Last release 15 days ago
21 Sep 2026
Ships fairly regularly
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
12 years old
175 releases · first in 2014
Initial support for writing OME-TIFF (WIP).
Initial support for writing OME-TIFF (WIP).
Return samples as separate dimension in OME series (breaking).
Fix modulo dimensions for multiple OME series.
Fix some test errors on big endian systems (#18).
Fix BytesWarning.
Allow passing TIFF.PREDICTOR values to TiffWriter.save.
Deprecate support for Python 3.6 (NEP 29).
Deprecate support for Python 3.6 (NEP 29).
Move pyramidal subresolution series to TiffPageSeries.levels (breaking).
Add parser for SVS, SCN, NDPI, and QPI pyramidal series.
Read single-file OME-TIFF pyramids.
Read NDPI files > 4 GB (#15).
Include SubIFDs in generic series.
Preliminary support for writing packed integer arrays (#11, WIP).
Read more LSM info subrecords.
Fix missing ReferenceBlackWhite tag for YCbCr photometrics.
Fix reading lossless JPEG compressed DNG files.
One column per quarter.
Support os.PathLike file names (#9).
Support os.PathLike file names (#9).
Re-add pure Python PackBits decoder.
Re-add pure Python PackBits decoder.
Fix tostring DeprecationWarning.
Make imagecodecs an optional dependency again.
Disable multi-threaded decoding of small LZW compressed segments.
Fix caching of TiffPage.decode method.
Fix xml.etree.cElementTree ImportError on Python 3.9.
Fix tostring DeprecationWarning.
Fix reading ImageJ grayscale mode RGB images (#6).
Fix reading ImageJ grayscale mode RGB images (#6).
Remove napari reader plugin.
Add napari reader plugin (tentative).
Add napari reader plugin (tentative).
Fix writing single tiles larger than image data (#3).
Always store ExtraSamples values in tuple (breaking).
Deprecate ijmetadata parameter from TiffWriter.save (use metadata).
Allow writing tiled TIFF from iterable of tiles (WIP).
Add method to iterate over decoded segments of TiffPage (WIP).
Pass chunks of segments to ThreadPoolExecutor.map to reduce memory usage.
Fix reading invalid files with too many strips.
Fix writing over-aligned image data.
Detect OME-XML without declaration (#2).
Support LERC compression (WIP).
Delay load imagecodecs functions.
Remove maxsize parameter from asarray (breaking).
Deprecate ijmetadata parameter from TiffWriter.save (use metadata).
Remove deprecated lzw_decode functions (breaking).
Add method to decode individual strips or tiles.
Read strips and tiles in order of their offsets.
Enable multi-threading when decompressing multiple strips.
Replace TiffPage.tags dictionary with TiffTags (breaking).
Replace TIFF.TAGS dictionary with TiffTagRegistry.
Remove TIFF.TAG_NAMES (breaking).
Improve handling of TiffSequence parameters in imread.
Match last uncommon parts of file paths to FileSequence pattern (breaking).
Allow letters in FileSequence pattern for indexing well plate rows.
Allow reordering of axes in FileSequence.
Allow writing > 4 GB arrays to plain TIFF when using compression.
Allow writing zero size NumPy arrays to nonconformant TIFF (tentative).
Fix xml2dict.
Require imagecodecs >= 2020.1.31.
Remove support for imagecodecs-lite (breaking).
Remove verify parameter to asarray method (breaking).
Remove deprecated lzw_decode functions (breaking).
Remove support for Python 2.7 and 3.5 (breaking).
Nothing published for this version
Fix infinite loop reading more than two tags of same code in IFD.
Fix infinite loop reading more than two tags of same code in IFD.
Delay import of logging module.
Fix OME-XML detection for files created by Imaris.
Fix OME-XML detection for files created by Imaris.
Remove or replace assert statements.
Do not write SampleFormat tag for unsigned data types.
Do not write SampleFormat tag for unsigned data types.
Write ByteCount tag values as SHORT or LONG if possible.
Allow specifying axes in FileSequence pattern via group names.
Add option to read FileSequence concurrently using threads.
Derive TiffSequence from FileSequence.
Use str(datetime.timedelta) to format Timer duration.
Use perf_counter for Timer if possible.
Fix reading planar RGB ImageJ files created by Bio-Formats.
Fix reading planar RGB ImageJ files created by Bio-Formats.
Fix reading single-file, multi-image OME-TIFF without UUID.
Presume LSM stores uncompressed images contiguously per page.
Reformat some complex expressions.
Ignore invalid frames in OME-TIFF.
Ignore invalid frames in OME-TIFF.
Set default subsampling to (2, 2) for RGB JPEG compression.
Fix reading and writing planar RGB JPEG compression.
Replace buffered_read with FileHandle.read_segments.
Include page or frame numbers in exceptions and warnings.
Add Timer class.
Add optional chroma subsampling for JPEG compression.
Add optional chroma subsampling for JPEG compression.
Enable writing PNG, JPEG, JPEGXR, and JPEG2K compression (WIP).
Fix writing tiled images with WebP compression.
Improve handling GeoTIFF sparse files.
Fix regression decoding JPEG with RGB photometrics.
Fix regression decoding JPEG with RGB photometrics.
Fix reading OME-TIFF files with corrupted but unused pages.
Allow loading TiffFrame without specifying keyframe.
Calculate virtual TiffFrames for non-BigTIFF ScanImage files > 2GB.
Rename property is_chroma_subsampled to is_subsampled (breaking).
Make more attributes and methods private (WIP).
Fix MemoryError when RowsPerStrip > ImageLength.
Fix MemoryError when RowsPerStrip > ImageLength.
Fix SyntaxWarning on Python 3.8.
Fail to decode JPEG to planar RGB (tentative).
Separate public from private test files (WIP).
Allow testing without data files or imagecodecs.
Use imagecodecs-lite as fallback for imagecodecs.
Use imagecodecs-lite as fallback for imagecodecs.
Simplify reading NumPy arrays from file.
Use TiffFrames when reading arrays from page sequences.
Support slices and iterators in TiffPageSeries sequence interface.
Auto-detect uniform series.
Use page hash to determine generic series.
Turn off TiffPages cache (tentative).
Pass through more parameters in imread.
Discontinue movie parameter in imread and TiffFile (breaking).
Discontinue bigsize parameter in imwrite (breaking).
Raise TiffFileError in case of issues with TIFF structure.
Return TiffFile.ome_metadata as XML (breaking).
Ignore OME series when last dimensions are not stored in TIFF pages.
Assemble IFDs in memory to speed-up writing on some slow media.
Assemble IFDs in memory to speed-up writing on some slow media.
Handle discontinued arguments fastij, multifile_close, and pages.
Use black background in imshow.
Use black background in imshow.
Do not write datetime tag by default (breaking).
Fix OME-TIFF with SamplesPerPixel > 1.
Allow 64-bit IFD offsets for NDPI (files > 4GB still not supported).
Fix decoding deflate without imagecodecs.
Fix decoding deflate without imagecodecs.
Require imagecodecs >= 2018.12.16.
Update copyright year.
Require imagecodecs >= 2018.12.16.
Do not use JPEG tables from keyframe.
Enable decoding large JPEG in NDPI.
Decode some old-style JPEG.
Reorder OME channel axis to match PlanarConfiguration storage.
Return tiled images as contiguous arrays.
Add decode_lzw proxy function for compatibility with old czifile module.
Use dedicated logger.
Make SubIFDs accessible as TiffPage.pages.
Make SubIFDs accessible as TiffPage.pages.
Make parsing of TiffSequence axes pattern optional (breaking).
Limit parsing of TiffSequence axes pattern to file names, not path names.
Do not interpolate in imshow if image dimensions <= 512, else use bilinear.
Use logging.warning instead of warnings.warn in many cases.
Fix NumPy FutureWarning for out == 'memmap'.
Adjust ZSTD and WebP compression to libtiff-4.0.10 (WIP).
Decode old-style LZW with imagecodecs >= 2018.11.8.
Remove TiffFile.qptiff_metadata (QPI metadata are per page).
Do not use keyword arguments before variable positional arguments.
Make either all or none return statements in function return expression.
Use pytest parametrize to generate tests.
Replace test classes with functions.
Rename imsave function to imwrite.
Rename imsave function to imwrite.
Re-add Python implementations of packints, delta, and bitorder codecs.
Fix TiffFrame.compression AttributeError.
Rename tiffile package to tifffile.
Rename tiffile package to tifffile.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →