Provided by: pqiv_2.1.1-1_i386 bug


       pqiv - quick image viewer


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


       pqiv is a simple image viewer inspired by qiv.


       -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

       -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

              Set  how  long  pqiv should fade between images. Defaults to 0.5

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

       -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, --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:

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

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

              $WIDTH The width of the current image in pixels

                     The height of the current image in pixels

              $ZOOM  The current zoom level

                     The index of the current image

                     The total numer of images

              The   default   is   `pqiv:  $FILENAME  ($WIDTHx$HEIGHT)  $ZOOM%

       -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

              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 of images

              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 files

              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,


       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.


       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.


       Phillip Berndt (mail at pberndt dot com)

                               04 November 2013                        pqiv(1)