Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Contact Us
Online Help
Domain Status
Man Pages

Virtual Servers

Topology Map

Server Agreement
Year 2038

USA Flag



Man Pages

Manual Reference Pages  -  PQIV (1)


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 image.
  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
  Disable scaling of images
  Control what to to after all images have been viewed. Valid options are quit to make pqiv exit after the last image has been viewed, wait to wait for new images to arrive, wrap to jump again to the first image and wrap-no-reshuffle to jump again to the first image, but in --shuffle mode, repeat the images in the same order as they were seen last time. Note that wait only makes sense if used with --watch-directories or --lazy-load and if either --shuffle is enabled or --sort is not: Elsewise, new images might get sorted before the last image, which would be ignored by pqiv. Only images that come after the last one count.
-f, --fullscreen
  Start in fullscreen mode
-F, --fade
  Fade between images
  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.
  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.
  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
  Shuffle files
  If --sort is enabled, sort by PROPERTY. Currently supported are name (default), which sorts by filename, and mtime which sorts by the files’ modification timestamps.
-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


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

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


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)

Search for    or go to Top of page |  Section 1 |  Main Index

PQIV (1) 09 September 2015

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.