Skip to content

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

License

Notifications You must be signed in to change notification settings

sailfish009/image_size

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

52 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

get_image_size

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.

Usage

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
try:
    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
try:
    img = get_image_size.get_image_metadata('/path/to/image.ext')
    width, height = img.width, img.height
    print(img._asdict())
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).

Options:
  -h, --help     show this help message and exit
  --json
  --json-indent
  -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
}

Updates

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 ;)

License

MIT License

Thanks

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

About

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

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%