NAME
qiv - a fast gdk/imlib image viewer for X.
Version: 2.2.3, released on 2010-01-10
by Andy Spiegl - http://qiv.spiegl.de/ - qiv.andy@spiegl.de
originally by Adam Kopacz / KLOGRAFX.DE Network
http://www.klografx.net/qiv/ - adam.k@klografx.de
SYNOPSIS
qiv [options] file ...
DESCRIPTION
qiv is an image viewer developed with gdk/imlib. As a result, qiv is
faster than traditional image viewers such as xv or xli.
OPTIONS
-h, --help
Print out a brief help message.
--display disp
Open qiv window on display disp.
-F, --file file | stdin
Read file names from file or stdin, one name per line. This
option can be specified multiple times to read from several
files, and will not affect other file names passed on the
command-line.
-u, --recursivedir
Change the behavior of qiv to recursively descend into the
directories given on the command line.
-e, --center
Disable window centering.
-w, --fixed_width x
Window with fixed width x.
-W, --fixed_zoom x.
Window with fixed zoom factor (percentage x).
-x, --root file
Set file as the current desktop background (centered) and exit.
-y, --root_t file
Set file as the current desktop background (tiled) and exit.
-z, --root_s file
Set file as the current desktop background (stretched) and exit.
-m, --maxpect
Expand image(s) to fit screen size while preserving aspect
ratio.
-t, --scale_down
Shrink image(s) which are larger than screen size to fit.
-b, --brightness x
Set brightness to x (-32..32).
-c, --contrast x
Set contrast to x (-32..32).
-g, --gamma x
Set gamma to x (-32..32).
-n, --no_filter
Disable filtering of images by extension. Normally, qiv will
only load images with an image extension such as .jpg, .png,
.gif ... This option lets you load any file as an image.
-i, --no_statusbar
Disable statusbar.
-I, --statusbar
Enable statusbar.
-p, --transparency
Enable transparency for transparent images.
-a, --do_grab
Grab the pointer in windowed mode.
-G, --disable_grab
Disable grabbing the pointer/kbd in fullscreen mode. Useful e.g.
if qiv displays images on a display other than where it was
invoked from. Use with caution!
-v, --version
Print version information.
-o, --bg_color x
Set root background color to named color x or 24 bit hex RGB
triple in the format #RRGGBB.
-s, --slide
Start slideshow immediately. This can also be used for the
desktop background (x/y/z).
-r, --random
Randomize slideshow.
-R, --readonly
Disable the deletion feature.
-S, --shuffle
Shuffle images (random order with next/previous functionality).
-d, --delay x
Set slideshow delay to x seconds.
-f, --fullscreen
Use fullscreen window on start-up.
-P, --ignore_path_sort
Sort all the image files by just their filename, ignoring the
path.
-M, --merged_case_sort
Sort all the image files in merged-case order (AaBbCc...).
-N, --numeric_sort
A "smart" numeric sort that attempts to sort filenames with
numbers in a logical manner. For instance: 2.jpg sorts before
10.jpg; 1foo.jpg through 10foo.jpg sorts after 1bar.jpg through
15bar.jpg (because "foo" comes after "bar"); and baz0001.jpg
through baz0010.jpg sorts after baz01.jpg through baz99.jpg
(because the longer group of zero-padded digits indicates that
they shouldn’t be intermingled).
-D, --no_sort
Do not apply any sorting to the list of files.
-T, --watch
Reload the image if it has changed on disk.
-A, --select_dir dir
Store the selected files in dir (default is .qiv-select).
-q, --rotate x
Rotate 90(x=1),180(x=2),270(x=3) degrees clockwise0
-l, --autorotate
Autorotate JPEGs according to EXIF rotation tag.
-X, --xineramascreen x
Use screen x as preferred Xinerama screen
-B, --browse
This option is useful when configuring qiv to be used with a
file manager. qiv will scan the directory of the clicked image
and allow you to scroll through those images.
EXAMPLES
qiv -atsd2 *.jpg
qiv --maxpect --root image.png
qiv --maxpect --slide --random --delay=2 *
qiv --maxpect --scale_down --slide --delay=2 ‘find / *‘
qiv --bg_color 0000FF --root image.png
qiv --bg_color blue --root image.png
KEYS
space/left mouse/wheel down next picture
backspace/right mouse/wheel up previous picture
PgDn 5 pictures forward
PgUp 5 pictures backward
q/ESC/middle mouse exit
0-9 run ’qiv-command <key> <current-img>’
^...<return> run ’qiv-command ^... <current-img>’ where ... can be any string
?/F1 show keys
F11/F12 in/decrease slideshow delay (1 second)
a/A copy picture to .qiv-select
d/D/del move picture to .qiv-trash (-R disables this feature)
u undelete the previously trashed image
+/=/wheel r/btn fwd zoom in (10%)
-/wheel l/btn back zoom out (10%)
e center mode on/off
f fullscreen mode on/off
m scale to screen size on/off
t scale down on/off
X cycle through xinerama screens
s slide show on/off
p transparency on/off
r random order on/off
b - brightness
B + brightness
c - contrast
C + contrast
g - gamma
G + gamma
o reset brightness, contrast, gamma
h flip horizontally
v flip vertically
k rotate right
l rotate left
jtx<return> jump to image number x
jfx<return> jump forward x images
jbx<return> jump backward x images
enter/return reset zoom, rotation and color settings
i statusbar on/off
I iconify window
w watch file on/off
x center image on background
y tile image on background
z stretch image on background
< turn on/off magnifying window
arrow keys move image (in fullscreen mode)
arrow keys+Shift move image faster (in fullscreen mode)
NumPad-arrow keys+NumLock move image faster (in fullscreen mode)
MOUSE CONTROLS
Button 1 next picture
Button 1 (hold down) & Mouse-Move moving picture
Button 2 quit
Button 3 previous picture
Wheel Up next picture
Wheel Dn previous picture
Wheel Lt/Button back zoom out (10%)
Wheel Rt/Button forward zoom in (10%)
DELETING
qiv doesn’t actually delete files. It creates a directory named ".qiv-
trash" and moves the images to that directory. qiv maintains the
directory structure of your "deleted" images. You can also undelete
the most recently trashed images in reverse order, which moves each
file back into its original directory. There is a limit to how many
deletions can be undone, but it should be pretty large (currently 1024
items). Sometimes this feature might be unwanted. To prevent accidents
you can specify the "-R" option to disable this feature.
IMWHEEL SUPPORT
With XFree86 3.3.2+ server, using the wheel is seen as button 4 and 5
pressed. You only have to use "IMPS/2" or "Intellimouse" for protocol
and add "ZAxisMapping 4 5 " in the "Pointer" section of XF86Config.
If imwheel (a program used to emulate key pressed when wheel is used
for program not supporting wheel), the following two lines must be add
to imwheel config file :
"qiv"
@Exclude
USER-DEFINED KEYBOARD ACTIONS
Keys 0-9 will invoke qiv-command with the key pressed as the first
argument and the current image filename as the second argument. qiv-
command is not distributed with qiv; it is to be supplied by the user.
Thus, this feature could be enabled by placing a simple shell script
such as the following in the command search path (for example, in the
user’s ~/bin directory):
#!/bin/sh
# Argument sanity checking eliminated for brevity
case $1 in
0|1|2|3|4|5|6|7|8|9) mkdir -f dir$1; mv "$fname" dir$1 ;;
*) echo "unrecognized command"; exit ;;
esac
If the first line of the output is like "NEWNAME=xxxxxxx" then qiv
thinks that the filename of the currently displayed image has changed
to this new name and updates its internal filelist. This is very
useful when using qiv-command to rename files.
Please also see the example that came together with qiv.
AUTHORS
Adam Kopacz <adam.k@klografx.de>
Andy Spiegl <qiv.andy@spiegl.de>
Darren Smith <darren.smith@juno.com>
Pavel Andreev <paxvel@vumsoft.cz>
Decklin Foster <decklin@red-bean.com>
Holger Mueller <hmueller@hrzpub.tu-darmstadt.de>
Scott Sams <sbsams@eos.ncsu.edu>
Serge Winitzki <winitzki@geocities.com>
Frederic Crozat <fcrozat@mail.dotcom.fr>
Rutger Nijlunsing <rutger@wingding.demon.nl>
John Knottenbelt <jak97@doc.ic.ac.uk>
Danny <dannys@mail.com>
Tomas Ogren <stric@ing.umu.se>
Erik Jacobsen <erik@openix.com>
Alfred Weyers <alfred@otto.gia.RWTH-Aachen.DE>
Daniel <danad157@student.liu.se>
Henning Kulander <hennikul@ifi.uio.no>
Ask Bjoern Hansen <ask@valueclick.com>
Adrian Lopez <adrian2@caribe.net>
Y Furuhashi <y_furuhashi@ot.olympus.co.jp>
Wayne Davison <wayned@users.sourceforge.net>
Johannes Stezenbach <js@convergence.de>
OEyvind Kolaas <pippin@users.sourceforge.net>
Matthieu Castet <castet.matthieu@free.fr>
Geoffrey T. Dairik <dairiki@dairiki.org>
Leopoldo Cerbaro <redbliss@aliceposta.it>
Heikki Lehvaslaiho <heikki@sanbi.ac.za>
Larry Doolittle <ldoolitt@boa.org>
S. Dobrev <sdobrev@sistechnology.com>
Thomas Wiegner <wiegner@gmx.de>
Barry deFreese <bdefreese@debian.org>
Peter deWachter <pdewacht@gmail.com>
Akos Pasztory <akos.pasztory@gmail.com>
MISC
qiv homepage: http://qiv.spiegl.de/
homepage of original author Adam Kopacz <adam.k@klografx.de>
http://www.klografx.net/qiv/
Mail bug, reports and comments to Andy Spiegl <qiv.andy@spiegl.de>
Sending a SIGUSR1 to qiv will cause the program to flip to next
picture. SIGUSR2 will move to previous.
This program is covered by the GNU GPL; see the file COPYING for
details.