Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Displays images (PNM, PNG, JPEG, etc.) conveniently from the terminal.

Project Description

image-view displays images (PNM, PNG, JPEG, etc.) using pygame.

The primary motivation is to support viewing PNM images on OS X. For common image types, Preview works great. For PNM images, Xee works fine for the most part, but it doesn’t work properly when displaying a subset of images from command line. This is important if there are a series of images captured from a camera (captured-00*.pgm), and you want to display a subset of them.


First install the pygame dependency somehow. One option is to use this fork, which avoids X11 on OS X:

$ pip install --upgrade git+

Then install the actual program:

$ pip install --upgrade image-view


Typical usage:

$ image-view captured-070*.pgm
  1. Use the left and right arrow keys to navigate through images.
  2. Use +/- keys to scale the image. Press 0 to reset.


usage: image-view [-h] [--colorize] [--little-endian] [--version]
                  files [files ...]

positional arguments:
  files            paths to images

optional arguments:
  -h, --help       show this help message and exit
  --colorize       color 16-bit PGM images with a rainbow gradient
  --little-endian  interpret 16-bit PGM images as little endian; this is the
                   opposite of Netpbm (and ImageMagick)
  --version        show program's version number and exit

Example screenshot

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

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

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(9.9 kB) Copy SHA256 Hash SHA256
Source None Apr 7, 2014

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers