1qiv(1) X Tools qiv(1)
2
6 qiv - a fast gdk/imlib image viewer for X.
7 Version: 2.2.4, released on 2011-05-02
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 -e, --center
38 Disable window centering.
39 -w, --fixed_width x
41 Window with fixed width x.
42 -W, --fixed_zoom x.
44 Window with fixed zoom factor (percentage x).
45 -x, --root file
47 Set file as the current desktop background (centered) and exit.
48 -y, --root_t file
50 Set file as the current desktop background (tiled) and exit.
51 -z, --root_s file
53 Set file as the current desktop background (stretched) and exit.
54 -m, --maxpect
56 Expand image(s) to fit screen size while preserving aspect
57 ratio.
58 -t, --scale_down
60 Shrink image(s) which are larger than screen size to fit.
61 -b, --brightness x
63 Set brightness to x (-32..32).
64 -c, --contrast x
66 Set contrast to x (-32..32).
67 -g, --gamma x
69 Set gamma to x (-32..32).
70 -n, --no_filter
72 Disable filtering of images by extension. Normally, qiv will
73 only load images with an image extension such as .jpg, .png,
74 .gif ... This option lets you load any file as an image.
75 -i, --no_statusbar
77 Disable statusbar.
78 -I, --statusbar
80 Enable statusbar.
81 -p, --transparency
83 Enable transparency for transparent images.
84 -a, --do_grab
86 Grab the pointer in windowed mode.
87 -G, --disable_grab
89 Disable grabbing the pointer/kbd in fullscreen mode. Useful e.g.
90 if qiv displays images on a display other than where it was
91 invoked from. Use with caution!
92 -v, --version
94 Print version information.
95 -o, --bg_color x
97 Set root background color to named color x or 24 bit hex RGB
98 triple in the format #RRGGBB.
99 -C, --cycle
101 Change cycle behaviour. qiv will exit after last picture has
102 been shown.
103 -s, --slide
105 Start slideshow immediately. This can also be used for the desk‐
106 top background (x/y/z).
107 -r, --random
109 Randomize slideshow.
110 -R, --readonly
112 Disable the deletion feature.
113 -S, --shuffle
115 Shuffle images (random order with next/previous functionality).
116 -d, --delay x
118 Set slideshow delay to x seconds.
119 -f, --fullscreen
121 Use fullscreen window on start-up.
122 -P, --ignore_path_sort
124 Sort all the image files by just their filename, ignoring the
125 path.
126 -M, --merged_case_sort
128 Sort all the image files in merged-case order (AaBbCc...).
129 -N, --numeric_sort
131 A "smart" numeric sort that attempts to sort filenames with num‐
132 bers in a logical manner. For instance: 2.jpg sorts before
133 10.jpg; 1foo.jpg through 10foo.jpg sorts after 1bar.jpg through
134 15bar.jpg (because "foo" comes after "bar"); and baz0001.jpg
135 through baz0010.jpg sorts after baz01.jpg through baz99.jpg
136 (because the longer group of zero-padded digits indicates that
137 they shouldn't be intermingled).
138 -D, --no_sort
140 Do not apply any sorting to the list of files.
141 -T, --watch
143 Reload the image if it has changed on disk.
144 -A, --select_dir dir
146 Store the selected files in dir (default is .qiv-select).
147 -q, --rotate x
149 Rotate 90(x=1),180(x=2),270(x=3) degrees clockwise
150 -l, --autorotate
152 Autorotate JPEGs according to EXIF rotation tag.
153 -X, --xineramascreen x
155 Use screen x as preferred Xinerama screen
156 -B, --browse
158 This option is useful when configuring qiv to be used with a
159 file manager. qiv will scan the directory of the clicked image
160 and allow you to scroll through those images.
161
163 qiv -atsd2 *.jpg
164 qiv --maxpect --root image.png
165 qiv --maxpect --slide --random --delay=2 *
166 qiv --maxpect --scale_down --slide --delay=2 `find / *`
167 qiv --bg_color 0000FF --root image.png
168 qiv --bg_color blue --root image.png
169
171 space/left mouse/wheel down next picture
172 backspace/right mouse/wheel up previous picture
173 PgDn 5 pictures forward
174 PgUp 5 pictures backward
175 q/ESC/middle mouse exit
176 0-9 run 'qiv-command <key> <current-img>'
178 ^...<return> run 'qiv-command ^... <current-img>' where ... can be any string
179 ?/F1 show keys
180 F11/F12 in/decrease slideshow delay (1 second)
181 a/A copy picture to .qiv-select
182 d/D/del move picture to .qiv-trash (-R disables this feature)
183 u undelete the previously trashed image
184 +/=/wheel r/btn fwd zoom in (10%)
185 -/wheel l/btn back zoom out (10%)
186 e center mode on/off
187 f fullscreen mode on/off
188 m scale to screen size on/off
189 t scale down on/off
190 X cycle through xinerama screens
191 s slide show on/off
192 p transparency on/off
193 r random order on/off
194 b - brightness
195 B + brightness
196 c - contrast
197 C + contrast
198 g - gamma
199 G + gamma
200 o reset brightness, contrast, gamma
201 h flip horizontally
202 v flip vertically
203 k rotate right
204 l rotate left
205 jtx<return> jump to image number x
206 jfx<return> jump forward x images
207 jbx<return> jump backward x images
208 enter/return reset zoom, rotation and color settings
209 i statusbar on/off
210 I iconify window
211 w watch file on/off
212 x center image on background
213 y tile image on background
214 z stretch image on background
215 < turn on/off magnifying window
216 arrow keys move image (in fullscreen mode)
217 arrow keys+Shift move image faster (in fullscreen mode)
218 NumPad-arrow keys+NumLock move image faster (in fullscreen mode)
219
221 Button 1 next picture
222 Button 1 (hold down) & Mouse-Move moving picture
223 Button 2 quit
224 Button 3 previous picture
225 Wheel Up next picture
226 Wheel Dn previous picture
227 Wheel Lt/Button back zoom out (10%)
228 Wheel Rt/Button forward zoom in (10%)
229
231 qiv doesn't actually delete files. It creates a directory named ".qiv-
232 trash" and moves the images to that directory. qiv maintains the direc‐
233 tory structure of your "deleted" images. You can also undelete the
234 most recently trashed images in reverse order, which moves each file
235 back into its original directory. There is a limit to how many dele‐
236 tions can be undone, but it should be pretty large (currently 1024
237 items). Sometimes this feature might be unwanted. To prevent accidents
238 you can specify the "-R" option to disable this feature.
239
241 With XFree86 3.3.2+ server, using the wheel is seen as button 4 and 5
242 pressed. You only have to use "IMPS/2" or "Intellimouse" for protocol
243 and add "ZAxisMapping 4 5 " in the "Pointer" section of XF86Config.
244 If imwheel (a program used to emulate key pressed when wheel is used
245 for program not supporting wheel), the following two lines must be add
246 to imwheel config file :
247 "qiv"
249 @Exclude
250
252 Keys 0-9 will invoke qiv-command with the key pressed as the first
253 argument and the current image filename as the second argument. qiv-
254 command is not distributed with qiv; it is to be supplied by the user.
255 Thus, this feature could be enabled by placing a simple shell script
256 such as the following in the command search path (for example, in the
257 user's ~/bin directory):
258 #!/bin/sh
260 # Argument sanity checking eliminated for brevity
261 case $1 in
262 0|1|2|3|4|5|6|7|8|9) mkdir -f dir$1; mv "$fname" dir$1 ;;
263 *) echo "unrecognized command"; exit ;;
264 esac
265 If the first line of the output is like "NEWNAME=xxxxxxx" then qiv
267 thinks that the filename of the currently displayed image has changed
268 to this new name and updates its internal filelist. This is very use‐
269 ful when using qiv-command to rename files.
270 Please also see the example that came together with qiv.
272
274 Adam Kopacz <adam.k@klografx.de>
275 Andy Spiegl <qiv.andy@spiegl.de>
276 Darren Smith <darren.smith@juno.com>
277 Pavel Andreev <paxvel@vumsoft.cz>
278 Decklin Foster <decklin@red-bean.com>
279 Holger Mueller <hmueller@hrzpub.tu-darmstadt.de>
280 Scott Sams <sbsams@eos.ncsu.edu>
281 Serge Winitzki <winitzki@geocities.com>
282 Frederic Crozat <fcrozat@mail.dotcom.fr>
283 Rutger Nijlunsing <rutger@wingding.demon.nl>
284 John Knottenbelt <jak97@doc.ic.ac.uk>
285 Danny <dannys@mail.com>
286 Tomas Ogren <stric@ing.umu.se>
287 Erik Jacobsen <erik@openix.com>
288 Alfred Weyers <alfred@otto.gia.RWTH-Aachen.DE>
289 Daniel <danad157@student.liu.se>
290 Henning Kulander <hennikul@ifi.uio.no>
291 Ask Bjoern Hansen <ask@valueclick.com>
292 Adrian Lopez <adrian2@caribe.net>
293 Y Furuhashi <y_furuhashi@ot.olympus.co.jp>
294 Wayne Davison <wayned@users.sourceforge.net>
295 Johannes Stezenbach <js@convergence.de>
296 OEyvind Kolaas <pippin@users.sourceforge.net>
297 Matthieu Castet <castet.matthieu@free.fr>
298 Geoffrey T. Dairik <dairiki@dairiki.org>
299 Leopoldo Cerbaro <redbliss@aliceposta.it>
300 Heikki Lehvaslaiho <heikki@sanbi.ac.za>
301 Larry Doolittle <ldoolitt@boa.org>
302 S. Dobrev <sdobrev@sistechnology.com>
303 Thomas Wiegner <wiegner@gmx.de>
304 Barry deFreese <bdefreese@debian.org>
305 Peter deWachter <pdewacht@gmail.com>
306 Akos Pasztory <akos.pasztory@gmail.com>
307
309 qiv homepage: http://qiv.spiegl.de/
310 homepage of original author Adam Kopacz <adam.k@klografx.de>
312 http://www.klografx.net/qiv/
313 Mail bug, reports and comments to Andy Spiegl <qiv.andy@spiegl.de>
315 Sending a SIGUSR1 to qiv will cause the program to flip to next pic‐
317 ture. SIGUSR2 will move to previous.
318 This program is covered by the GNU GPL; see the file COPYING for
320 details.
321fast image viewer for X qiv qiv(1)