NAME
pqiv - quick image viewer
SYNOPSIS
pqiv [options] <file(s) or folder(s)>
DESCRIPTION
pqiv is a simple image viewer inspired by qiv.
OPTIONS
-i Suppress the yellow info box in pqiv
-f Start pqiv in fullscreen mode
-F Make "pqiv" fade between images. Currently this does only work
for images of equal size.
-s Auto start slide show
-S Follow symlinks. pqiv will not traverse into symlinked
directories by default as this tends to lead to recursion and
other problems. If this option is active, pqiv will follow
symlinks. An algorithm to prevent recursion is implemented.
Checking for if a symlink points out of the current node (For
example symlinks to /) is not.
-n Sort the file list using natsort. Use twice to shuffle the list.
-d n Interval for the slideshow function, in seconds
-t If used once: Scale small images up to fill the whole screen
If used twice: Do not shrink image(s) larger than the screen to
fit
-r Read filename(s) from STDIN.
-c pqiv will draw this well-known chessboard background for
transparent images per default. Use this option to deactivate
this behaviour. If you use this option twice (and your wm
supports it), it will cause the window to be transparent. Use
it three times to make the window stay in the background and use
it for times to also disable controls. You can make pqiv behave
like a desktop widget this way.
-w Watch open files for changes and reload them if necessary
-z n Set initial zoom level in percent. This is only useful in
conjunction with -t.
-p n Select interpolation type for resizing operations. Valid values
for n:
1: GDK_INTERP_NEAREST, copy the nearest pixel value
2: GDK_INTERP_TILES, tile the image
3: GDK_INTERP_BILINEAR, use bilinear interpolation
4: GDK_INTERP_HYPER, use hyper interpolation
-P Set window position.
left,top: Set initial window position
off: Deactivate positioning
Defaults to center of screen.
-a <key><new-key>
Maps <key> to <new-key>. For example, "-a=+" will make "=" an
alias for zooming in.
-R Reverse the meaning of the cursor and Page Up/Down keys. For
example, pressing the "down" cursor key will normally make the
image move up. With this option, the image will instead move
down.
-<n> Use those options (n in 0..9) to define a command, which will be
executed when you press the corresponding key in pqiv. The last
occurance of "$1" will be replaced by the current file’s name.
Prepend the command with > to show the command’s output in a
dialog window.
Prepend the command with | to let pqiv pipe the displayed image
to your command and read/reload it from the command’s output.
-q Behave (mostly) like the original qiv. With this option "pqiv"
will call pqiv -command n file when you press a number key n,
where n will be replaced by the key you pressed and file by the
name of the current image.
The contents of ~/.pqivrc will be prepended to pqiv’s argv. So if you
want to make an slideshow interval of 1 second the default for pqiv,
put
-d1
into that file.
pqiv will display all files you specified on the command line.
Directories will be searched recursively for files supported by gtk+
(for example: bmp, gif, jpeg, png, wbmp, xpm, svg). Unless you
specified -r the special file - will cause pqiv to read a file from
stdin.
USAGE
In pqiv, you can use both mouse and keyboard to navigate through the
images. Execute pqiv -h to get more information on the key bindings.
If you call pqiv without a TTY on stdin (ie. from GUI) without
parameters, pqiv will pop up an "open file" dialog.
AUTHOR
Phillip Berndt (mail at pberndt dot com)
The original qiv authors are listed on
http://www.klografx.net/qiv/inde.html