1qiv(1) X Tools qiv(1)
2
6 qiv - a fast gdk/imlib image viewer for X.
7 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
14 qiv [options] file ...
15
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
21 -h, --help
22 Print out a brief help message.
23 --display disp
25 Open qiv window on display disp.
26 -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 -u, --recursivedir
34 Change the behavior of qiv to recursively descend into the
35 directories given on the command line.
36 -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 -e, --center
44 Disable window centering.
45 -w, --fixed_width x
47 Window with fixed width x.
48 -W, --fixed_zoom x.
50 Window with fixed zoom factor (percentage x).
51 -x, --root file
53 Set file as the current desktop background (centered) and exit.
54 -y, --root_t file
56 Set file as the current desktop background (tiled) and exit.
57 -z, --root_s file
59 Set file as the current desktop background (stretched) and exit.
60 -m, --maxpect
62 Expand image(s) to fit screen size while preserving aspect
63 ratio.
64 -t, --scale_down
66 Shrink image(s) which are larger than screen size to fit.
67 -b, --brightness x
69 Set brightness to x (-32..32).
70 -c, --contrast x
72 Set contrast to x (-32..32).
73 -g, --gamma x
75 Set gamma to x (-32..32).
76 -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 -i, --no_statusbar
83 Disable statusbar.
84 -I, --statusbar
86 Enable statusbar.
87 -p, --transparency
89 Enable transparency for transparent images.
90 -a, --do_grab
92 Grab the pointer in windowed mode.
93 -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 -v, --version
100 Print version information.
101 -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 -C, --cycle
107 Change cycle behaviour. qiv will exit after last picture has
108 been shown.
109 -s, --slide
111 Start slideshow immediately. This can also be used for the desk‐
112 top background (x/y/z).
113 -r, --random
115 Randomize slideshow.
116 -R, --readonly
118 Disable the deletion feature.
119 -S, --shuffle
121 Shuffle images (random order with next/previous functionality).
122 -d, --delay x
124 Set slideshow delay to x seconds.
125 -f, --fullscreen
127 Use fullscreen window on start-up.
128 -P, --ignore_path_sort
130 Sort all the image files by just their filename, ignoring the
131 path.
132 -M, --merged_case_sort
134 Sort all the image files in merged-case order (AaBbCc...).
135 -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 -D, --no_sort
146 Do not apply any sorting to the list of files.
147 -T, --watch
149 Reload the image if it has changed on disk.
150 -A, --select_dir dir
152 Store the selected files in dir (default is .qiv-select).
153 -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 -l, --autorotate
162 Autorotate JPEGs according to EXIF rotation tag.
163 -X, --xineramascreen x
165 Use monitor x as preferred screen
166 -Y, --source_profile x
168 Use color profile file x as source profile for all images
169 -Z, --display_profile x
171 Use color profile file x as display profile for all images
172 -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 --vikeys
179 Enable movement with h/j/k/l, vi-style (HJKL will do what hjkl
180 previously did)
181
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
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 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
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
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
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 "qiv"
271 @Exclude
272
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 #!/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 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 Please also see the example that came together with qiv.
294
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
331 qiv homepage: http://qiv.spiegl.de/
332 homepage of original author Adam Kopacz <adam.k@klografx.de>
334 http://www.klografx.net/qiv/
335 Mail bug, reports and comments to Andy Spiegl <qiv.andy@spiegl.de>
337 Sending a SIGUSR1 to qiv will cause the program to flip to next pic‐
339 ture. SIGUSR2 will move to previous.
340 This program is covered by the GNU GPL; see the file COPYING for
342 details.
343fast image viewer for X qiv qiv(1)