NAME

       pqiv - quick image viewer

SYNOPSIS

       pqiv [options] <file(s) or folder(s)>

DESCRIPTION

       pqiv is a simple image viewer inspired by qiv.

OPTIONS

       -a, --keyboard-alias=nf
              Define  n  as  a  keyboard alias for f. For example, `-a af' will give you fullscreen with the `a'
              key. Multiple aliases can be set by concatenating them to the option's value: `-a afwa' will  make
              `a' toggle fullscreen and `w' create a link to the current image.

       --browse
              For each command line argument, additionally load all images from the image's directory.

       -c, --transparent-background
              Borderless transparent window. Click on the window to show the window borders, click again to hide
              them.  This will only work in compositing window managers.

       -d, --slideshow-interval=n
              Set the interval for the slideshow mode

       -f, --fullscreen
              Start in fullscreen mode

       -F, --fade
              Fade between images

       --fade-duration=n
              Set how long pqiv should fade between images. Defaults to 0.5 seconds.

       -i, --hide-info-box
              Initially hide the info box

       -l, --lazy-load
              Create  the image list in a background thread and display the main window as soon as one image has
              been found. New images will be added as they are found.  When combining this with  the  --sort  or
              --shuffle  options, keep in mind that the first image found will be displayed, though it might end
              up not being the first one in the final file list. As with  the  --watch-directories  option,  the
              info box does not automatically update when new images are added.

       --max-depth=n
              Descend  at most n levels of directories below the command line arguments. Like in find, passing 0
              disables recursion. Negative numbers mean infinite recursion and are the default.

       -n, --sort
              Sort files in natural order

       -P, --window-position=POSITION
              Set initial window position. Use `x,y' to position the window  at  the  specific  coordinates,  or
              `off' to not position the window at all. The default behavior is to center the window.

       -r, --additional-from-stdin
              Read additional filenames/folders from stdin

       -R, --reverse-cursor-keys
              Reverse the meaning of the cursor keys

       -s, --slideshow
              Initially activate slideshow mode

       -t, --scale-images-up
              Scale images up to fill the whole screen

       -T, --window-title=TITLE
              Set the title of the window. You have some variables available:

              $BASEFILENAME
                     The base file name of the current file (e.g. `image.png')

              $FILENAME
                     The file name of the current file (e.g. `/home/user/image.png')

              $WIDTH The width of the current image in pixels

              $HEIGHT
                     The height of the current image in pixels

              $ZOOM  The current zoom level

              $IMAGE_NUMBER
                     The index of the current image

              $IMAGE_COUNT
                     The total numer of images

              The default is `pqiv: $FILENAME ($WIDTHx$HEIGHT) $ZOOM% [$IMAGE_NUMBER/$IMAGE_COUNT]'

       -z, --zoom-level=FLOAT
              Set initial zoom level as a floating point number (1.0 is 100%)

       -1, --command-1=COMMAND
              Bind  the  external  COMMAND  to  key  1. Likewise, you can use -2 to -9 for those keys.  Extended
              usage:

              Show command output in a window
                     Prefix the command with `>' to display it's output in an overlay window.

              Pipe the image through a filter
                     Prefix the command with `|' to write the image to the program's stdin and read an image  from  its
                     stdout.  The output is not cached, so reloading the image will revert to the old state.

       --disable-scaling
              Disable scaling of images

       --low-memory
              Try  to  avoid memory hungry operations: Do not preload the next image, do not keep a scaled image
              in memory for faster redraw operations, etc.

       --shuffle
              Shuffle files

       --watch-directories
              Watch directories (given on the command line) for new images and add them  as  they  appear.  Note
              that  the  yellow  info  box  does  not update automatically, but only when the window needs to be
              redrawn anyway. This option uses GIO's GFileMonitor internally. Depending on which system you use,
              GIO might internally poll regularly for changes, i.e. create some  load.  (In  Linux,  inotify  is
              used.)

       You  can  use  the  file  ~/.pqivrc  to make any of these default. The file's syntax is (mostly) those of
       desktop-files. Create a section options and use the long option names for the key names. For example,

            [options]
            fullscreen=1
            slideshow-interval=5

       would be a valid configuration file. If you set any boolean option in the configuration file, its meaning
       on the command line will be inverted. So with the above example file, -f would make pqiv start in  window
       mode.   The  old  syntax  from pqiv <= 1.0, where the file was prepended to the argument vector, is still
       supported as well. So you can also just store -f -n 5 in the file to achieve the same effect.

       Please note that while the use of flags in the configuration file inverts their meaning  on  the  command
       line, the same does not apply to double use of flags. In old versions of pqiv, -ff would do nothing. This
       is no longer the case, it will now fullscreen the application.

       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). 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.

AUTHOR

       Phillip Berndt (mail at pberndt dot com)

                                                  18 June 2014                                           pqiv(1)