Skip to main content

No project description provided

Project description

⚠️ This is a fork of scardine/image_size simply to create a distributable package on PyPI. Will be rendered unnecessary if image_size/issues/13 is addressed.


Look, Ma! No deps!

Get image width and height given a file path using minimal dependencies (no need for PIL, libjpeg, libpng, etc).

Why don’t you just use PIL?

PIL is huge and has lots of dependencies, perhaps an overkill if you want just the image dimensions. If you already have PIL installed, then sure, use it instead.

This was written in answer for the question “Get Image size WITHOUT loading image into memory” (using Python) in stackoverflow. The OP said:

@PauloScardine hey thanks Paulo, this is great! It’s always so nice to have code that can be easily deployed without bringing in dependencies, and this fits the bill! As you say, avoiding PIL is worth it for its own sake.


Right now only for PNG, JPEG, GIF, BMP and TIF. Very untested, fork and send PRs.

Python get_image_size.get_image_size usage:

import get_image_size
    width, height = get_image_size.get_image_size('/path/to/image.ext')
except get_image_size.UnknownImageFormat:
    width, height = -1, -1

Python get_image_size.get_image_metadata usage:

import get_image_size
    img = get_image_size.get_image_metadata('/path/to/image.ext')
    width, height = img.width, img.height
except get_image_size.UnknownImageFormat:
    width, height = -1, -1

Commandline get-image-size usage:

$ python -m get_image_size --help
$ get-image-size --help
Usage: get-image-size [-v|--verbose] [--json|--json-indent] <path0> [<pathN>]

Print metadata for the given image paths (without image library bindings).

  -h, --help     show this help message and exit
  -v, --verbose
  -q, --quiet
  -t, --test

$ get-image-size ./lookmanodeps.png
251 208     22228   PNG     ./lookmanodeps.png

$ get-image-size --json-indent ./lookmanodeps.png
  "path": "./lookmanodeps.png",
  "type": "PNG",
  "file_size": 22228,
  "width": 251,
  "height": 208


Over the time people sent updates for “.ico”, “.bmp” and other improvements. It is interesting to have all those algorithms in the same place so people can reimplement them using other languages, so thanks for all the pull requests (you can see the list of contributions in the history).

I added support for BMP file types, respecting different types of DIB headers. Should work on all current bitmap types, tested for old OS/2 and BITMAPCOREHEADER files, too. You might try it and consider it for merging if you find it useful. No longer under 100 LOC though, sorry ;)


MIT License


Thanks everyone who inspired this, contributed with code or sent bug reports. You know who you are, THANK YOU!


Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for opsdroid-get-image-size, version 0.2.2
Filename, size File type Python version Upload date Hashes
Filename, size opsdroid_get_image_size-0.2.2.tar.gz (22.8 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page