| qiv(1) | X Tools | qiv(1) |
qiv - a fast gdk/imlib image viewer for X.
Version: 2.3.3, released on 2023-01-28
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
qiv [options] file ...
qiv is an image viewer developed with gdk/imlib. As a result, qiv is faster than traditional image viewers such as xv or xli.
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
space/left mouse/wheel right next picture backspace/right mouse/wheel left previous picture PgDn/wheel down 5 pictures forward PgUp/wheel up 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 copy picture to .qiv-select A artist (author) info on/off d/D/del move picture to .qiv-trash (-R disables this feature)
(if started with --trashbin picture is moved to users trash bin) u undelete the previously trashed image (not working if --trashbin is used) +/=/mouse btn 9 zoom in (+10% / +50% if above 100%) -/mouse btn 8 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 monitors 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 E display Exif information i statusbar on/off J JPEG comments 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 , grab on/off < turn on/off magnifying window arrow keys/wheel move image (in fullscreen mode) arrow keys/wheel+Shift move image faster (in fullscreen mode) NumPad-arrow keys+NumLock move image faster (in fullscreen mode)
Button 1 next picture Button 1 (hold down) & Mouse-Move moving picture Button 2 quit Button 3 previous picture Wheel Up/Dn move image vertically Wheel Left/Right move image horizontally Extra mouse buttons (8,9) zoom out/in (10%)
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. If the "--trashbin" option is used qiv will move the deleted pictures to the users trash bin. In that case undeleting with pressing "u" will not work. Open the trash bin and restore the image instead.
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
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.
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>
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.
| qiv | fast image viewer for X |