skip to navigation
skip to content

image-view 0.4

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

Latest Version: 0.4.1

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

File Type Py Version Uploaded on Size
image-view-0.4.tar.gz (md5) Source 2014-04-07 9KB