README.rst

imagesize

This module analyzes JPEG/JPEG 2000/PNG/GIF/TIFF/SVG image headers and returns image size.

import imagesize

width, height = imagesize.get("test.png")
print(width, height)

This module is a pure Python module.

API

• imagesize.get(filepath)

  Returns image size (width, height).

Benchmark

It only parses headers, and ignores pixel data. So it is much faster than Pillow.

module	result
imagesize (pure Python)	1.077 seconds per 100 000 times
Pillow	10.569 seconds per 100 000 times

I tested on MacBookPro (2014/Core i7) with 125kB PNG files.

Restriction

• TIFF

  It can returns only first picture's size because of restriction of API design.

  It supports only small TIFF file. BigTIFF support is not implemented.

Development

Run test with the following command:

python -m unittest

License

MIT License

Thanks

I referred to the following code:

• http://markasread.net/post/17551554979/get-image-size-info-using-pure-python-code
• https://stackoverflow.com/questions/8032642/how-to-obtain-image-size-using-standard-python-class-without-using-external-lib

I use sample image from here:

• https://www.nightprogrammer.org/development/multipage-tiff-example-download-test-image-file/

Thank you for feedback:

• tk0miya (https://github.com/tk0miya)
• shimizukawa (https://github.com/shimizukawa)
• xantares (https://github.com/xantares)
• Ivan Zakharyaschev (https://github.com/imz)
• Jon Dufresne (https://github.com/jdufresne)
• Geoff Lankow (https://github.com/darktrojan)
• Hugo (https://github.com/hugovk)