1qiv(1) X Tools qiv(1)
2
6 qiv - a fast gdk/imlib image viewer for X.
7 Version: 2.3.2, released on 2017-11-03
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 op‐
29 tion can be specified multiple times to read from several files,
30 and will not affect other file names passed on the command-line.
31 -u, --recursivedir
33 Change the behavior of qiv to recursively descend into the di‐
34 rectories given on the command line.
35 -L, --followlinks
37 With --recursivedir, this allows a symlink to point to a direc‐
38 tory. This is useful for organizing photo dirs into categories,
39 but it is up to you to ensure that there are no symlink loops
40 that would cause an infinite scan.
41 -e, --center
43 Disable window centering.
44 -w, --fixed_width x
46 Window with fixed width x.
47 -W, --fixed_zoom x.
49 Window with fixed zoom factor (percentage x).
50 -x, --root file
52 Set file as the current desktop background (centered) and exit.
53 -y, --root_t file
55 Set file as the current desktop background (tiled) and exit.
56 -z, --root_s file
58 Set file as the current desktop background (stretched) and exit.
59 -m, --maxpect
61 Expand image(s) to fit screen size while preserving aspect ra‐
62 tio.
63 -t, --scale_down
65 Shrink image(s) which are larger than screen size to fit.
66 -b, --brightness x
68 Set brightness to x (-32..32).
69 -c, --contrast x
71 Set contrast to x (-32..32).
72 -g, --gamma x
74 Set gamma to x (-32..32).
75 -n, --no_filter
77 Disable filtering of images by extension. Normally, qiv will
78 only load images with an image extension such as .jpg, .png,
79 .gif ... This option lets you load any file as an image.
80 -i, --no_statusbar
82 Disable statusbar.
83 -I, --statusbar
85 Enable statusbar.
86 -J, --showJPEGcomments
88 Enable display of comment lines (in JPEG images).
89 -p, --transparency
91 Enable transparency for transparent images.
92 -a, --do_grab
94 Grab the pointer in windowed mode.
95 -G, --disable_grab
97 Disable grabbing the pointer/kbd in fullscreen mode. Useful e.g.
98 if qiv displays images on a display other than where it was in‐
99 voked from. Use with caution!
100 -v, --version
102 Print version information.
103 -o, --bg_color x
105 Set root background color to named color x or 24 bit hex RGB
106 triple in the format #RRGGBB.
107 -C, --cycle
109 Change cycle behaviour. qiv will exit after last picture has
110 been shown.
111 -s, --slide
113 Start slideshow immediately. This can also be used for the desk‐
114 top background (x/y/z).
115 -r, --random
117 Randomize slideshow.
118 -R, --readonly
120 Disable the deletion feature.
121 -S, --shuffle
123 Shuffle images (random order with next/previous functionality).
124 -d, --delay x
126 Set slideshow delay to x seconds.
127 -f, --fullscreen
129 Use fullscreen window on start-up.
130 -P, --ignore_path_sort
132 Sort all the image files by just their filename, ignoring the
133 path.
134 -M, --merged_case_sort
136 Sort all the image files in merged-case order (AaBbCc...).
137 -K, --mtime_sort
139 Sort files by their modification time
140 -N, --numeric_sort
142 A "smart" numeric sort that attempts to sort filenames with num‐
143 bers in a logical manner. For instance: 2.jpg sorts before
144 10.jpg; 1foo.jpg through 10foo.jpg sorts after 1bar.jpg through
145 15bar.jpg (because "foo" comes after "bar"); and baz0001.jpg
146 through baz0010.jpg sorts after baz01.jpg through baz99.jpg (be‐
147 cause the longer group of zero-padded digits indicates that they
148 shouldn't be intermingled).
149 -D, --no_sort
151 Do not apply any sorting to the list of files.
152 -T, --watch
154 Reload the image if it has changed on disk.
155 -A, --select_dir dir
157 Store the selected files in dir (default is .qiv-select).
158 -q, --rotate x
160 Rotate each image 90(x=1),180(x=2),270(x=3) degrees clockwise.
161 If x=11 or x=13, the 90 or 270 degree rotation is conditional on
162 the image fitting better if rotated. e.g. if the display is
163 wide and a tall image is too tall to fit on the screen, it will
164 be rotated.
165 -l, --autorotate
167 Do NOT autorotate JPEGs according to EXIF rotation tag. Default
168 is ON.
169 -X, --xineramascreen x
171 Use monitor x as preferred screen
172 -Y, --source_profile x
174 Use color profile file x as source profile for all images
175 -Z, --display_profile x
177 Use color profile file x as display profile for all images
178 -B, --browse
180 This option is useful when configuring qiv to be used with a
181 file manager. qiv will scan the directory of the clicked image
182 and allow you to scroll through those images.
183 --trashbin
185 Use users trash bin instead of .qiv-trash. Undeleting an image
186 will not work, open the trash bin and restore the image instead.
187 --vikeys
189 Enable movement with h/j/k/l, vi-style (HJKL will do what hjkl
190 previously did)
191
193 qiv -atsd2 *.jpg
194 qiv --maxpect --root image.png
195 qiv --maxpect --slide --random --delay=2 *
196 qiv --maxpect --scale_down --slide --delay=2 `find / *`
197 qiv --bg_color 0000FF --root image.png
198 qiv --bg_color blue --root image.png
199
201 space/left mouse/wheel down next picture
202 backspace/right mouse/wheel up previous picture
203 PgDn 5 pictures forward
204 PgUp 5 pictures backward
205 q/ESC/middle mouse exit
206 0-9 run 'qiv-command <key> <current-img>'
208 ^...<return> run 'qiv-command ^... <current-img>' where ... can be any string
209 ?/F1 show keys
210 F11/F12 in/decrease slideshow delay (1 second)
211 a/A copy picture to .qiv-select
212 d/D/del move picture to .qiv-trash (-R disables this feature)
213 (if started with --trashbin picture is moved to users trash bin)
214 u undelete the previously trashed image (not working if --trashbin is used)
215 +/=/wheel r/btn fwd zoom in (10%)
216 -/wheel l/btn back zoom out (10%)
217 e center mode on/off
218 f fullscreen mode on/off
219 m scale to screen size on/off
220 t scale down on/off
221 X cycle through monitors
222 s slide show on/off
223 p transparency on/off
224 r random order on/off
225 b - brightness
226 B + brightness
227 c - contrast
228 C + contrast
229 g - gamma
230 G + gamma
231 o reset brightness, contrast, gamma
232 h flip horizontally
233 v flip vertically
234 k rotate right
235 l rotate left
236 jtx<return> jump to image number x
237 jfx<return> jump forward x images
238 jbx<return> jump backward x images
239 enter/return reset zoom, rotation and color settings
240 E display Exif information
241 i statusbar on/off
242 J JPEG comments on/off
243 I iconify window
244 w watch file on/off
245 x center image on background
246 y tile image on background
247 z stretch image on background
248 , grab on/off
249 < turn on/off magnifying window
250 arrow keys move image (in fullscreen mode)
251 arrow keys+Shift move image faster (in fullscreen mode)
252 NumPad-arrow keys+NumLock move image faster (in fullscreen mode)
253
255 Button 1 next picture
256 Button 1 (hold down) & Mouse-Move moving picture
257 Button 2 quit
258 Button 3 previous picture
259 Wheel Up next picture
260 Wheel Dn previous picture
261 Wheel Left/Button back zoom out (10%)
262 Wheel Right/Button forward zoom in (10%)
263
265 qiv doesn't actually delete files. It creates a directory named ".qiv-
266 trash" and moves the images to that directory. qiv maintains the direc‐
267 tory structure of your "deleted" images. You can also undelete the most
268 recently trashed images in reverse order, which moves each file back
269 into its original directory. There is a limit to how many deletions can
270 be undone, but it should be pretty large (currently 1024 items). Some‐
271 times this feature might be unwanted. To prevent accidents you can
272 specify the "-R" option to disable this feature. If the "--trashbin"
273 option is used qiv will move the deleted pictures to the users trash
274 bin. In that case undeleting with pressing "u" will not work. Open the
275 trash bin and restore the image instead.
276
278 With XFree86 3.3.2+ server, using the wheel is seen as button 4 and 5
279 pressed. You only have to use "IMPS/2" or "Intellimouse" for protocol
280 and add "ZAxisMapping 4 5 " in the "Pointer" section of XF86Config.
281 If imwheel (a program used to emulate key pressed when wheel is used
282 for program not supporting wheel), the following two lines must be add
283 to imwheel config file :
284 "qiv"
286 @Exclude
287
289 Keys 0-9 will invoke qiv-command with the key pressed as the first ar‐
290 gument and the current image filename as the second argument. qiv-com‐
291 mand is not distributed with qiv; it is to be supplied by the user.
292 Thus, this feature could be enabled by placing a simple shell script
293 such as the following in the command search path (for example, in the
294 user's ~/bin directory):
295 #!/bin/sh
297 # Argument sanity checking eliminated for brevity
298 case $1 in
299 0|1|2|3|4|5|6|7|8|9) mkdir -f dir$1; mv "$fname" dir$1 ;;
300 *) echo "unrecognized command"; exit ;;
301 esac
302 If the first line of the output is like "NEWNAME=xxxxxxx" then qiv
304 thinks that the filename of the currently displayed image has changed
305 to this new name and updates its internal filelist. This is very use‐
306 ful when using qiv-command to rename files.
307 Please also see the example that came together with qiv.
309
311 Adam Kopacz <adam.k@klografx.de>
312 Andy Spiegl <qiv.andy@spiegl.de>
313 Darren Smith <darren.smith@juno.com>
314 Pavel Andreev <paxvel@vumsoft.cz>
315 Decklin Foster <decklin@red-bean.com>
316 Holger Mueller <hmueller@hrzpub.tu-darmstadt.de>
317 Scott Sams <sbsams@eos.ncsu.edu>
318 Serge Winitzki <winitzki@geocities.com>
319 Frederic Crozat <fcrozat@mail.dotcom.fr>
320 Rutger Nijlunsing <rutger@wingding.demon.nl>
321 John Knottenbelt <jak97@doc.ic.ac.uk>
322 Danny <dannys@mail.com>
323 Tomas Ogren <stric@ing.umu.se>
324 Erik Jacobsen <erik@openix.com>
325 Alfred Weyers <alfred@otto.gia.RWTH-Aachen.DE>
326 Daniel <danad157@student.liu.se>
327 Henning Kulander <hennikul@ifi.uio.no>
328 Ask Bjoern Hansen <ask@valueclick.com>
329 Adrian Lopez <adrian2@caribe.net>
330 Y Furuhashi <y_furuhashi@ot.olympus.co.jp>
331 Wayne Davison <wayned@users.sourceforge.net>
332 Johannes Stezenbach <js@convergence.de>
333 OEyvind Kolaas <pippin@users.sourceforge.net>
334 Matthieu Castet <castet.matthieu@free.fr>
335 Geoffrey T. Dairik <dairiki@dairiki.org>
336 Leopoldo Cerbaro <redbliss@aliceposta.it>
337 Heikki Lehvaslaiho <heikki@sanbi.ac.za>
338 Larry Doolittle <ldoolitt@boa.org>
339 S. Dobrev <sdobrev@sistechnology.com>
340 Thomas Wiegner <wiegner@gmx.de>
341 Barry deFreese <bdefreese@debian.org>
342 Peter deWachter <pdewacht@gmail.com>
343 Akos Pasztory <akos.pasztory@gmail.com>
344
346 qiv homepage: http://qiv.spiegl.de/
347 homepage of original author Adam Kopacz <adam.k@klografx.de>
349 http://www.klografx.net/qiv/
350 Mail bug, reports and comments to Andy Spiegl <qiv.andy@spiegl.de>
352 Sending a SIGUSR1 to qiv will cause the program to flip to next pic‐
354 ture. SIGUSR2 will move to previous.
355 This program is covered by the GNU GPL; see the file COPYING for de‐
357 tails.
358fast image viewer for X qiv qiv(1)