Skip to main content

A simple tool to display (and read to np.ndarray) images from a url, file, image object, etc.

Project description

What it does:

Reads and displays an image from a url, local filename, PIL image object, numpy.ndimage object, or any object type scipy.misc.imread supports directly. Also contains an simread function that will return the image as a numpy.ndarray.

I’ve had to look up how to display an image in this context or that too many times. This is an attempt to remedy that.


$ pip install simple-imshow


>> from simshow import simshow
>> simshow('test-cats.jpg')  # display from local file
>> simshow('')  # display from url

Request for Community Support:

I’d love for others to help me make this a more robust, more convenient tool – so, as the FAA likes to say, “If you see something, say something.” Or at least feel free to.


  • Add simple tool to take a list of images and display a random sample (or all) as a grid of thumbnails.
  • Add support for plots.

Some thoughts on guidelines for this project:

  • simread should be fast.
  • I’d like to keep required dependencies limited to common ones available through pip (e.g. no requirement for opencv)
  • It’d be nice if simshow could refresh quickly enough support video feeds. In my experience matplotlib figures will not though (I do not know matplotlib well though).

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 simple-imshow, version 1.0.post1
Filename, size File type Python version Upload date Hashes
Filename, size simple_imshow-1.0.post1-py2.py3-none-any.whl (5.7 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size simple-imshow-1.0.post1.tar.gz (166.9 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page