1qiv(1) X Tools qiv(1)
2
6 qiv - a fast gdk/imlib image viewer for X. Version: 2.0, released on
7 22.05.2004 by Adam Kopacz / KLOGRAFX.DE Network http://www.klo‐
8 grafx.net/qiv/ - adam.k@klografx.de
9
11 qiv [options] file ...
12
14 qiv is an image viewer developed with gdk/imlib. As a result, qiv is
15 faster than traditional image viewers such as xv or xli.
16
18 -h, --help
19 Print out a brief help message.
20 --display disp
22 Open qiv window on display disp.
23 -F, --file file
25 Read file names from file, one name per line. This option can be
26 specified multiple times to read from several files, and will
27 not affect other file names passed on the command-line.
28 -e, --center
30 Disable window centering.
31 -w, --fixed_width x
33 Window with fixed width x.
34 -W, --fixed_zoom x.
36 Window with fixed zoom factor (percentage x).
37 -x, --root file
39 Set file as the current desktop background (centered) and exit.
40 -y, --root_t file
42 Set file as the current desktop background (tiled) and exit.
43 -z, --root_s file
45 Set file as the current desktop background (stretched) and exit.
46 -m, --maxpect
48 Expand image(s) to fit screen size while preserving aspect
49 ratio.
50 -t, --scale_down
52 Shrink image(s) which are larger than screen size to fit.
53 -b, --brightness x
55 Set brightness to x (-32..32).
56 -c, --contrast x
58 Set contrast to x (-32..32).
59 -g, --gamma x
61 Set gamma to x (-32..32).
62 -n, --no_filter
64 Disable filtering of images by extension.
65 -i, --no_statusbar
67 Disable statusbar.
68 -I, --statusbar
70 Enable statusbar.
71 -p, --transparency
73 Enable transparency for transparent images.
74 -a, --do_grab
76 Grab the pointer in windowed mode.
77 -G, --disable_grab
79 Disable grabbing the pointer/kbd in fullscreen mode. Useful e.g.
80 if qiv displays images on a display other than where it was
81 envoked from. Use with caution!
82 -v, --version
84 Print version information.
85 -o, --bg_color x
87 Set root background color to named color x or 24 bit hex RGB
88 triple in the format #RRGGBB.
89 -s, --slide
91 Start slideshow immediately.
92 -r, --random
94 Randomize slideshow.
95 -R, --readonly
97 Disable the deletion feature.
98 -S, --shuffle
100 Shuffle images (random order with next/previous functionality).
101 -d, --delay x
103 Set slideshow delay to x seconds.
104 -f, --fullscreen
106 Use fullscreen window on start-up.
107 -P, --ignore_path_sort
109 Sort all the image files by just their filename, ignoring the
110 path.
111 -M, --merged_case_sort
113 Sort all the image files in merged-case order (AaBbCc...).
114 -N, --numeric_sort
116 A "smart" numeric sort that attempts to sort filenames with num‐
117 bers in a logical manner. For instance: 2.jpg sorts before
118 10.jpg; 1foo.jpg through 10foo.jpg sorts after 1bar.jpg through
119 15bar.jpg (because "foo" comes after "bar"); and baz0001.jpg
120 through baz0010.jpg sorts after baz01.jpg through baz99.jpg
121 (because the longer group of zero-padded digits indicates that
122 they shouldn't be intermingled).
123 -T, --watch
125 Reload the image if it has changed on disk.
126
128 qiv -atsd2 *.jpg
129 qiv --maxpect --root image.png
130 qiv --maxpect --slide --random --delay=2 *
131 qiv --maxpect --scale_down --slide --delay=2 `find / *`
132 qiv --bg_color 0000FF --root image.png
133 qiv --bg_color blue --root image.png
134
136 space/left mouse/wheel down next picture
137 backspace/right mouse/wheel up previous picture
138 PgDn 5 pictures forward
139 PgUp 5 pictures backward
140 q/ESC/middle mouse exit
141 0-9 run 'qiv-command <key> <current-img>'
143 ?/F1 show keys
144 F11/F12 in/decrease slideshow delay (1 second)
145 a/A copy picture to .qiv-select
146 d/D/del move picture to .qiv-trash (-R disables this feature)
147 u undelete the previously trashed image
148 +/= zoom in (10%)
149 - zoom out (10%)
150 e center mode on/off
151 f fullscreen mode on/off
152 m scale to screen size on/off
153 t scale down on/off
154 s slide show on/off
155 p transparency on/off
156 r random order on/off
157 b - brightness
158 B + brightness
159 c - contrast
160 C + contrast
161 g - gamma
162 G + gamma
163 arrow keys move image (in fullscreen mode)
164 arrow keys+Shift move image faster (in fullscreen mode)
165 NumPad-arrow keys+NumLock move image faster (in fullscreen mode)
166 h flip horizontal
167 v flip vertical
168 k rotate right
169 l rotate left
170 jtx<return> jump to image number x
171 jfx<return> jump forward x images
172 jbx<return> jump backward x images
173 enter/return reset zoom and color settings
174 i statusbar on/off
175 I iconify window
176 w watch file on/off
177 x center image on background
178 y tile image on background
179 z stretch image on background
180
182 Button 1 next picture
183 Button 1 (hold down) & Mouse-Move moving picture
184 Button 2 quit
185 Button 3 previous picture
186 Wheel Up next picture
187 Wheel Dn previous picture
188
190 qiv doesn't actually delete files. It creates a directory named ".qiv-
191 trash" and moves the images to that directory. qiv maintains the direc‐
192 tory structure of your "deleted" images. You can also undelete the
193 most recently trashed images in reverse order, which moves each file
194 back into its original directory. There is a limit to how many dele‐
195 tions can be undone, but it should be pretty large (currently 1024
196 items). Sometimes this feature might be unwanted. To prevent accidents
197 you can specify the "-R" option to disable this feature.
198
200 With XFree86 3.3.2+ server, using the wheel is seen as button 4 and 5
201 pressed. You only have to use "IMPS/2" or "Intellimouse" for protocol
202 and add "ZAxisMapping 4 5 " in the "Pointer" section of XF86Config.
203 If imwheel (a program used to emulate key pressed when wheel is used
204 for program not supporting wheel), the following two lines must be add
205 to imwheel config file :
206 "qiv"
208 @Exclude
209
211 Keys 0-9 will invoke qiv-command with the key pressed as the first
212 argument and the current image filename as the second argument. qiv-
213 command is not distributed with qiv; it is to be supplied by the user.
214 Thus, this feature could be enabled by placing a simple shell script
215 such as the following in the command search path (for example, in the
216 user's ~/bin directory):
217 #!/bin/sh
219 # Argument sanity checking eliminated for brevity
220 case $1 in
221 0|1|2|3|4|5|6|7|8|9) mkdir -f dir$1; mv "$fname" dir$1 ;;
222 *) echo "unrecognized command"; exit ;;
223 esac
224
226 To use qiv with xscreensaver, either type "make install-xscreensaver"
227 or add the following to your ~/.Xresources:
228 xscreensaver.programs: \
230 /usr/bin/qiv -srfid 5 your_pix/\* \n\
231 /usr/bin/qiv -srfid 5 your_other_pix/\* \n\
232
234 Adam Kopacz (adam.k@klografx.de)
235 Andy Spiegl (qiv.andy@spiegl.de)
236 Darren Smith (darren.smith@juno.com)
237 Pavel Andreev (paxvel@vumsoft.cz)
238 Decklin Foster (decklin@red-bean.com)
239 Holger Mueller (hmueller@hrzpub.tu-darmstadt.de)
240 Scott Sams (sbsams@eos.ncsu.edu)
241 Serge Winitzki (winitzki@geocities.com)
242 Frederic Crozat (fcrozat@mail.dotcom.fr)
243 Rutger Nijlunsing (rutger@wingding.demon.nl)
244 John Knottenbelt (jak97@doc.ic.ac.uk)
245 Danny (dannys@mail.com)
246 Tomas Ogren (stric@ing.umu.se)
247 Erik Jacobsen (erik@openix.com)
248 Alfred Weyers (alfred@otto.gia.RWTH-Aachen.DE)
249 Daniel (danad157@student.liu.se)
250 Henning Kulander (hennikul@ifi.uio.no)
251 Ask Bjoern Hansen (ask@valueclick.com)
252 Adrian Lopez (adrian2@caribe.net)
253 Y Furuhashi (y_furuhashi@ot.olympus.co.jp)
254 Wayne Davison (wayned@users.sourceforge.net)
255 Johannes Stezenbach (js@convergence.de)
256 OEyvind Kolaas (pippin@users.sourceforge.net)
257 Matthieu Castet (castet.matthieu@free.fr)
258
260 qiv homepage: http://www.klografx.net/qiv/
261 Mail bug, reports and comments to Adam Kopacz <adam.k@klografx.de>
263 Sending a SIGUSR1 to qiv will cause the program to flip to next pic‐
265 ture. SIGUSR2 will move to previous.
266 This program is covered by the GNU GPL; see the file COPYING for
268 details.
269qiv version 2.0 14 Jan 2003 qiv(1)