Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   44335 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

PHO(l)									PHO(l)

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 rota‐
       tion 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
       -p     "Presentation  mode":  display  in full screen mode with a black
	      background (if the window manager allows it).

       -P     Force non-presentation mode (e.g. if you set PHO_ARGS=-p).

       -n     Replace each image with a new window (slower,  but  helpful  for
	      some broken window managers).

       -k     Keywords	mode:  display images scaled down, and show a Keywords
	      dialog for classifying images. (Keywords mode will  cancel  Pre‐
	      sentation mode.)

       -sN    Automatic	 Slideshow mode, where N is the delay in seconds.  For
	      example, -s5 will show pause  5  seconds	between	 images.   -s0
	      means no delay.

       -d     Debug  mode: may print a few debugging messages to standard out‐
	      put.

       -h     Help: print a usage statement.  -v Verbose help: print a summary
	      of key bindings.

ENVIRONMENT VARIABLES
       PHO_ARGS: 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.

       PHO_REMOTE: the command to call when you press the 'g' key.
	      Include a %s to represent the filename  of  the  current	image.
	      (Defaults to gimp %s).

KEY BINDINGS
       When pho is running, it obeys the following keys:

       [space]
	      Go to next image. Or cancel slideshow mode, if active.

       [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 typ‐
	      ing 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	 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.)

       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.

       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/

PHO				 March 5 2007				PHO(l)

Vote for polarhome