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.

Filename, size & hash SHA256 hash help File type Python version Upload date
image-view-0.4.1.tar.gz (9.9 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page