NAME
pho - View and annotate multiple images
SYNTAX
pho [options]
[filename[filename...]]
DESCRIPTION
pho displays images, in the formats
handled by the gdk-pixbuf package, to an X display. It is
intended as a lightweight and fast viewer, optimized for rapidly
going through large numbers of uploaded images.
pho is entirely keyboard driven, and allows for
interactive rotation and taking of notes on each image. It resizes
after rotations and will always attempt to show the image as large
as possible. The final rotation reached for each image will be
remembered and printed when the program exits (for use with a batch
image rotation script).
pho can also remember up to ten lists of images (numbered
0-9) which can correspond to anything the user wishes. The image
lists will be printed to standard output when pho exits. Use this
to keep notes on which images you want to save to the web, which
images contain images of your dog, etc.
COMMAND-LINE OPTIONS
- -d
- Debug mode: may print a few debugging messages to standard
output.
- -v, -h
- Print version and usage info, and exit.
- -p
- "Presentation mode": display in full screen mode with a black
background (if the window manager allows it).
- -P
- Force non-presentation mode.
- -n
- Replace each image with a new window (slower, but helpful for
some broken window managers).
ENVIRONMENT VARIABLES
- Pho will check the PHO_ARGS environment variable for default
flag
- settings (e.g. set it to p to use presentation mode by
default). Any flags given on the command line will override these
settings.
KEY BINDINGS
When pho is running, it obeys the following
keys:
- [space]
- Go to next image
- [backspace]
- Go to previous image
- r, t, [right-arrow]
- Rotate right (clockwise)
- R, T, l, L, [left-arrow]
- Rotate left (counter-clockwise)
- [up-arrow], [down-arrow]
- Rotate 180 degrees.
- Home
- Go back to the first image.
- d
- Delete (will bring up a confirmation dialog; clicking OK or
typing another d deletes the file).
- i
- Show a dialog with information about the image, including EXIF
tags.
- 0 through 9
- Add the image to the appropriate notes list
- f
- Toggle in/out of "full screen mode" (or "fit to window").
Images will be scaled up or down to fill the screen in at least one
dimension.
- F
- Toggle in/out of "full size mode". Images will be shown at
their native size, even if it's bigger than the screen size. (Hint:
Many window managers let you move oversized windows with alt-drag.)
- p
- Toggle in/out of "presentation mode". If the window manager
permits, pho will take up the full screen with the image (if
smaller) centered.
- +, = Magnify: show the image at twice the current
size.
- /, - Unmagnify: show the image at half the
current size.
- q
- Quit
ENVIRONMENT
Pho checks for the environment variable
PHO_ARGS, which can contain flags to use as default arguments. For
example, PHO_ARGS=p will always run pho in presentation mode
(unless you pass -P to turn off that mode).
AUTHOR
Akkana Peck
COPYRIGHT
Copyright © 2002 - 2007 Akkana Peck
Pho is free software, licensed under the GNU Public License.
SEE ALSO
The most recent version of pho, and more
information about it, is at: http://shallowsky.com/software/pho/