1qiv(1)                              X Tools                             qiv(1)
2
3
4

NAME

6       qiv - a fast gdk/imlib image viewer for X.
7
8       Version: 2.3.1, released on 2013-12-20
9       by Andy Spiegl - http://qiv.spiegl.de/ - qiv.andy@spiegl.de
10       originally by Adam Kopacz / KLOGRAFX.DE Network
11       http://www.klografx.net/qiv/ - adam.k@klografx.de
12

SYNOPSIS

14       qiv [options] file ...
15

DESCRIPTION

17       qiv  is  an  image viewer developed with gdk/imlib. As a result, qiv is
18       faster than traditional image viewers such as xv or xli.
19

OPTIONS

21       -h, --help
22              Print out a brief help message.
23
24       --display disp
25              Open qiv window on display disp.
26
27       -F, --file file | stdin
28              Read file names from file or stdin,  one  name  per  line.  This
29              option  can  be  specified  multiple  times to read from several
30              files, and will not affect other file names passed on  the  com‐
31              mand-line.
32
33       -u, --recursivedir
34              Change  the  behavior  of  qiv  to  recursively descend into the
35              directories given on the command line.
36
37       -L, --followlinks
38              With --recursivedir, this allows a symlink to point to a  direc‐
39              tory.  This is useful for organizing photo dirs into categories,
40              but it is up to you to ensure that there are  no  symlink  loops
41              that would cause an infinite scan.
42
43       -e, --center
44              Disable window centering.
45
46       -w, --fixed_width x
47              Window with fixed width x.
48
49       -W, --fixed_zoom x.
50              Window with fixed zoom factor (percentage x).
51
52       -x, --root file
53              Set file as the current desktop background (centered) and exit.
54
55       -y, --root_t file
56              Set file as the current desktop background (tiled) and exit.
57
58       -z, --root_s file
59              Set file as the current desktop background (stretched) and exit.
60
61       -m, --maxpect
62              Expand  image(s)  to  fit  screen  size  while preserving aspect
63              ratio.
64
65       -t, --scale_down
66              Shrink image(s) which are larger than screen size to fit.
67
68       -b, --brightness x
69              Set brightness to x (-32..32).
70
71       -c, --contrast x
72              Set contrast to x (-32..32).
73
74       -g, --gamma x
75              Set gamma to x (-32..32).
76
77       -n, --no_filter
78              Disable filtering of images by  extension.  Normally,  qiv  will
79              only  load  images  with  an image extension such as .jpg, .png,
80              .gif ...  This option lets you load any file as an image.
81
82       -i, --no_statusbar
83              Disable statusbar.
84
85       -I, --statusbar
86              Enable statusbar.
87
88       -p, --transparency
89              Enable transparency for transparent images.
90
91       -a, --do_grab
92              Grab the pointer in windowed mode.
93
94       -G, --disable_grab
95              Disable grabbing the pointer/kbd in fullscreen mode. Useful e.g.
96              if  qiv  displays  images  on  a display other than where it was
97              invoked from. Use with caution!
98
99       -v, --version
100              Print version information.
101
102       -o, --bg_color x
103              Set root background color to named color x or  24  bit  hex  RGB
104              triple in the format #RRGGBB.
105
106       -C, --cycle
107              Change  cycle  behaviour.  qiv  will exit after last picture has
108              been shown.
109
110       -s, --slide
111              Start slideshow immediately. This can also be used for the desk‐
112              top background (x/y/z).
113
114       -r, --random
115              Randomize slideshow.
116
117       -R, --readonly
118              Disable the deletion feature.
119
120       -S, --shuffle
121              Shuffle images (random order with next/previous functionality).
122
123       -d, --delay x
124              Set slideshow delay to x seconds.
125
126       -f, --fullscreen
127              Use fullscreen window on start-up.
128
129       -P, --ignore_path_sort
130              Sort  all  the  image files by just their filename, ignoring the
131              path.
132
133       -M, --merged_case_sort
134              Sort all the image files in merged-case order (AaBbCc...).
135
136       -N, --numeric_sort
137              A "smart" numeric sort that attempts to sort filenames with num‐
138              bers  in  a  logical  manner.   For instance: 2.jpg sorts before
139              10.jpg; 1foo.jpg through 10foo.jpg sorts after 1bar.jpg  through
140              15bar.jpg  (because  "foo"  comes  after "bar"); and baz0001.jpg
141              through baz0010.jpg  sorts  after  baz01.jpg  through  baz99.jpg
142              (because  the  longer group of zero-padded digits indicates that
143              they shouldn't be intermingled).
144
145       -D, --no_sort
146              Do not apply any sorting to the list of files.
147
148       -T, --watch
149              Reload the image if it has changed on disk.
150
151       -A, --select_dir dir
152              Store the selected files in dir (default is .qiv-select).
153
154       -q, --rotate x
155              Rotate each image 90(x=1),180(x=2),270(x=3)  degrees  clockwise.
156              If x=11 or x=13, the 90 or 270 degree rotation is conditional on
157              the image fitting better if rotated.  e.g.  if  the  display  is
158              wide  and a tall image is too tall to fit on the screen, it will
159              be rotated.
160
161       -l, --autorotate
162              Autorotate JPEGs according to EXIF rotation tag.
163
164       -X, --xineramascreen x
165              Use monitor x as preferred screen
166
167       -Y, --source_profile x
168              Use color profile file x as source profile for all images
169
170       -Z, --display_profile x
171              Use color profile file x as display profile for all images
172
173       -B, --browse
174              This option is useful when configuring qiv to  be  used  with  a
175              file  manager.  qiv will scan the directory of the clicked image
176              and allow you to scroll through those images.
177
178       --vikeys
179              Enable movement with h/j/k/l, vi-style (HJKL will do  what  hjkl
180              previously did)
181

EXAMPLES

183       qiv -atsd2 *.jpg
184       qiv --maxpect --root image.png
185       qiv --maxpect --slide --random --delay=2 *
186       qiv --maxpect --scale_down --slide --delay=2 `find / *`
187       qiv --bg_color 0000FF --root image.png
188       qiv --bg_color blue --root image.png
189

KEYS

191       space/left mouse/wheel down        next picture
192       backspace/right mouse/wheel up     previous picture
193       PgDn                               5 pictures forward
194       PgUp                               5 pictures backward
195       q/ESC/middle mouse                 exit
196
197       0-9                 run 'qiv-command <key> <current-img>'
198       ^...<return>        run 'qiv-command ^... <current-img>' where ... can be any string
199       ?/F1                show keys
200       F11/F12             in/decrease slideshow delay (1 second)
201       a/A                 copy picture to .qiv-select
202       d/D/del             move picture to .qiv-trash (-R disables this feature)
203       u                   undelete the previously trashed image
204       +/=/wheel r/btn fwd zoom in (10%)
205       -/wheel l/btn back  zoom out (10%)
206       e                   center mode on/off
207       f                   fullscreen mode on/off
208       m                   scale to screen size on/off
209       t                   scale down on/off
210       X                   cycle through monitors
211       s                   slide show on/off
212       p                   transparency on/off
213       r                   random order on/off
214       b                   - brightness
215       B                   + brightness
216       c                   - contrast
217       C                   + contrast
218       g                   - gamma
219       G                   + gamma
220       o                   reset brightness, contrast, gamma
221       h                   flip horizontally
222       v                   flip vertically
223       k                   rotate right
224       l                   rotate left
225       jtx<return>        jump to image number x
226       jfx<return>        jump forward x images
227       jbx<return>        jump backward x images
228       enter/return       reset zoom, rotation and color settings
229       E                  display Exif information
230       i                  statusbar on/off
231       I                  iconify window
232       w                  watch file on/off
233       x                  center image on background
234       y                  tile image on background
235       z                  stretch image on background
236       ,                  grab on/off
237       <                  turn on/off magnifying window
238       arrow keys                 move image (in fullscreen mode)
239       arrow keys+Shift           move image faster (in fullscreen mode)
240       NumPad-arrow keys+NumLock  move image faster (in fullscreen mode)
241

MOUSE CONTROLS

243       Button 1                            next picture
244       Button 1 (hold down) & Mouse-Move   moving picture
245       Button 2                            quit
246       Button 3                            previous picture
247       Wheel Up                            next picture
248       Wheel Dn                            previous picture
249       Wheel Lt/Button back                zoom out (10%)
250       Wheel Rt/Button forward             zoom in (10%)
251

DELETING

253       qiv  doesn't actually delete files. It creates a directory named ".qiv-
254       trash" and moves the images to that directory. qiv maintains the direc‐
255       tory  structure  of  your  "deleted" images.  You can also undelete the
256       most recently trashed images in reverse order, which  moves  each  file
257       back  into  its original directory.  There is a limit to how many dele‐
258       tions can be undone, but it should  be  pretty  large  (currently  1024
259       items).  Sometimes this feature might be unwanted. To prevent accidents
260       you can specify the "-R" option to disable this feature.
261

IMWHEEL SUPPORT

263       With XFree86 3.3.2+ server, using the wheel is seen as button 4  and  5
264       pressed.  You  only have to use "IMPS/2" or "Intellimouse" for protocol
265       and add "ZAxisMapping    4 5 " in the "Pointer" section of  XF86Config.
266       If  imwheel  (a  program used to emulate key pressed when wheel is used
267       for program not supporting wheel), the following two lines must be  add
268       to imwheel config file :
269
270       "qiv"
271       @Exclude
272

USER-DEFINED KEYBOARD ACTIONS

274       Keys  0-9  will  invoke  qiv-command  with the key pressed as the first
275       argument and the current image filename as the second  argument.   qiv-
276       command  is not distributed with qiv; it is to be supplied by the user.
277       Thus, this feature could be enabled by placing a  simple  shell  script
278       such  as  the following in the command search path (for example, in the
279       user's ~/bin directory):
280
281       #!/bin/sh
282       # Argument sanity checking eliminated for brevity
283       case $1 in
284         0|1|2|3|4|5|6|7|8|9) mkdir -f dir$1; mv "$fname" dir$1 ;;
285         *) echo "unrecognized command"; exit ;;
286       esac
287
288       If the first line of the output  is  like  "NEWNAME=xxxxxxx"  then  qiv
289       thinks  that  the filename of the currently displayed image has changed
290       to this new name and updates its internal filelist.  This is very  use‐
291       ful when using qiv-command to rename files.
292
293       Please also see the example that came together with qiv.
294

AUTHORS

296       Adam Kopacz             <adam.k@klografx.de>
297       Andy Spiegl             <qiv.andy@spiegl.de>
298       Darren Smith            <darren.smith@juno.com>
299       Pavel Andreev           <paxvel@vumsoft.cz>
300       Decklin Foster          <decklin@red-bean.com>
301       Holger Mueller          <hmueller@hrzpub.tu-darmstadt.de>
302       Scott Sams              <sbsams@eos.ncsu.edu>
303       Serge Winitzki          <winitzki@geocities.com>
304       Frederic Crozat         <fcrozat@mail.dotcom.fr>
305       Rutger Nijlunsing       <rutger@wingding.demon.nl>
306       John Knottenbelt        <jak97@doc.ic.ac.uk>
307       Danny                   <dannys@mail.com>
308       Tomas Ogren             <stric@ing.umu.se>
309       Erik Jacobsen           <erik@openix.com>
310       Alfred Weyers           <alfred@otto.gia.RWTH-Aachen.DE>
311       Daniel                  <danad157@student.liu.se>
312       Henning Kulander        <hennikul@ifi.uio.no>
313       Ask Bjoern Hansen       <ask@valueclick.com>
314       Adrian Lopez            <adrian2@caribe.net>
315       Y Furuhashi             <y_furuhashi@ot.olympus.co.jp>
316       Wayne Davison           <wayned@users.sourceforge.net>
317       Johannes Stezenbach     <js@convergence.de>
318       OEyvind Kolaas          <pippin@users.sourceforge.net>
319       Matthieu Castet         <castet.matthieu@free.fr>
320       Geoffrey T. Dairik      <dairiki@dairiki.org>
321       Leopoldo Cerbaro        <redbliss@aliceposta.it>
322       Heikki Lehvaslaiho      <heikki@sanbi.ac.za>
323       Larry Doolittle         <ldoolitt@boa.org>
324       S. Dobrev               <sdobrev@sistechnology.com>
325       Thomas Wiegner          <wiegner@gmx.de>
326       Barry deFreese          <bdefreese@debian.org>
327       Peter deWachter         <pdewacht@gmail.com>
328       Akos Pasztory           <akos.pasztory@gmail.com>
329

MISC

331       qiv homepage: http://qiv.spiegl.de/
332
333       homepage of original author Adam Kopacz <adam.k@klografx.de>
334        http://www.klografx.net/qiv/
335
336       Mail bug, reports and comments to Andy Spiegl <qiv.andy@spiegl.de>
337
338       Sending  a  SIGUSR1  to qiv will cause the program to flip to next pic‐
339       ture.  SIGUSR2 will move to previous.
340
341       This program is covered by the  GNU  GPL;  see  the  file  COPYING  for
342       details.
343
344
345
346fast image viewer for X               qiv                               qiv(1)
Impressum