README.rst

imagesize

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

import imagesize

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

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

This module is a pure Python module. You can use file like object like file or something like io.BytesIO.

API

• imagesize.get(filepath)

  Returns image size (width, height).

• imagesize.getDPI(filepath)

  Returns image DPI (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.

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)
• Jack Cherng (https://github.com/jfcherng)
• Tyler A. Young (https://github.com/s3cur3)
• Mark Browning (https://github.com/mabrowning)
• ossdev07 (https://github.com/ossdev07)
• Nicholas-Schaub (https://github.com/Nicholas-Schaub)
• Nuffknacker (https://github.com/Nuffknacker)
• Hannes Römer (https://github.com/hroemer)
• mikey (https://github.com/ffreemt)
• Marco (https://github.com/marcoffee)
• ExtReMLapin (https://github.com/ExtReMLapin)