Skip to main content

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

Project description

Build status

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


Project details

Download files

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

Source Distribution

image-view-0.4.1.tar.gz (9.9 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page