2 This is Geeqie, a successor of GQview.
4 Geeqie has been forked from GQview project, because it was not
5 possible to contact gqview author and the only maintainer.
6 Geeqie projects goal is to move the development forward and
7 also integrate the existing patches.
9 Geeqie is currently in alpha state. Everybody is encouraged
10 to try the new features, however for stable software look at
14 http://geeqie.sourceforge.net
19 Please send any question or suggestions to
20 geeqie-devel@lists.sourceforge.net
23 Below is the original README:
26 ###################################################################
27 ## GQview 2.1.5 (December 3, 2006) ##
29 ## Copyright (C) 1999 - 2006 John Ellis. ##
31 ## Use at your own risk! ##
33 ## This software released under the GNU General Public License. ##
34 ## Please read the COPYING file for more information. ##
35 ###################################################################
37 Author: John Ellis <johne@verizon.net>
38 e-mail: gqview@users.sourceforge.net
39 homepage: http://gqview.sourceforge.net
42 BETA! BETA! BETA! BETA! BETA! BETA! BETA! BETA! BETA! BETA! BETA!
44 The 2.1.x series are all development releases, and as such may
45 contain incredible bugs. Only use if interested in the new features.
47 The stable release as of this writing is 2.0.0.
49 BETA! BETA! BETA! BETA! BETA! BETA! BETA! BETA! BETA! BETA! BETA!
52 ======== README contents:
55 * Notes and changes for this release
57 * Description / Features
58 * Documentation (keyboard shortcuts)
59 * Editor command macros
67 GTK+ 2.4.x: ftp://ftp.gtk.org/pub/gtk
70 lcms, for color management support: http://www.littlecms.com
71 (disable with configure option: '--without-lcms')
73 ======== Notes and changes for this release [section:release_notes]
77 + Add support for color profiles (requires lcms, see Notes).
78 + Add ability to delete a folder and it's contents (with restrictions).
79 - Add support for jpegs embedded in pentax and olympus raw files.
80 - Add icons for image state, enabled with I keyboard shortcut.
81 - For pan view calendar only show months that contain an image.
82 - Make scrolling with overlays (full screen info display) a bit smoother.
83 - Make sort menus display choices as radio group instead of checkbox.
84 - Use white background for transparent images when printing.
85 * Escape filename characters "`$\ before passing them to the system shell
86 when running an editor command.
87 * Fix occasional crash in icon view when removing files.
88 * Always use aligned memory access in EXIF parser, fixes crash
89 with BUS error on sparc.
90 * Fix progress bar warning when removing files while loading thumbnails.
91 * Fix image count in full screen information overlay when in slideshow.
92 * Fix memory leak when unable to start a slideshow.
96 For translation status list, see further below.
98 Version in perenthesis indicates first appearance of feature or change.
100 (2.1.5) Add support for color profiles when lcms is installed. To
101 disable color profiles and use of lcms, run configure
102 with '--without-lcms'.
104 (2.1.1) Add support for viewing jpeg images and EXIF embedded within
105 raw files for Canon (.crw, .cr2) Fujifilm (.raf), and Nikon (.nef).
106 Note that not all cameras that support a raw format will necessarily
107 save a usable jpeg in the raw file (for example some Nikon cameras only
108 store a tiny thumbnail within the raw .nef file).
110 (1.5.6) The "shared thumbnail cache" is a proposal to unify the method
111 of storing thumbnails, so that they are compatible between different
112 applications. Using this option will allow GQview to share it's
113 thumbnails with, and use thumbnails from, other applications. Current
114 releases of GNOME (through nautilus and gthumb) and the gimp use this
115 new thumbnailing system. The latest draft of the thumbnail standard
116 is located on freedesktop.org in the standards section, and links to:
118 http://triq.net/~jens/thumbnail-spec/index.html
120 The shared thumbnail standard and GQview's classic mechanism can
121 not be used at the same time, enabling the "use shared thumbnail cache"
122 option will disable the use of classic thumbnails and use the new
125 (1.5.6) Collections contained in $HOME/.gqview/collections are now
126 updated when moving or renaming files, even if the collection is not
129 (1.5.6) The new option to the keep the full screen window above other
130 windows is only available when using at least GTK+ 2.4.0
132 (1.5.5) Dialog buttons are now ordered as recommended by the GNOME HIG.
133 The GNOME Human Interface Guidelines live at:
134 http://developer.gnome.org/projects/gup/hig/
135 To restore the old button order you must be using GTK 2.6 and set
136 the "gtk-alternative-button-order" key to TRUE in the gtkrc file:
138 by changing or adding this line:
139 gtk-alternative-button-order = 1
141 (1.5.5) The dithering option is now a hidden option, to change it
142 please refer to section 10.7 of the manual (help -> contents).
144 (1.5.0) Keywords and comments can now be entered for a file. Two places
145 allow keyword and comment entry. The first is via the new image details
146 sidebar accessed with (Ctrl-K), and the second is a details tab in the
147 properties dialog. If multiple files are selected, two buttons are
148 available: One allows adding the keywords to the selected files, the
149 other replaces existing keywords with the new keywords.
151 Keyword and comment metadata is stored in $(HOME)/.gqview/metadata, and
152 mirrors the existing filesystem tree. Metadata filenames have a suffix
153 of .meta appended. If 'cache into .thumbnails' is enabled, metadata is
154 stored locally to the original file in a hidden subfolder ".metadata".
155 If write permissions do not allow local saving of metadata, GQview falls
156 back to the default $(HOME)/.gqview/metadata location.
158 (1.5.0) Search dialog (F3 key) types:
159 Path searches files in the entered folder.
160 Comments searches all file metadata stored in ~/.gqview/metadata.
161 Results searches the current list of results, allowing refinement.
163 (1.3.6) Drag and drop has been significantly improved, with a few
164 changes. Button 1 will now initiate a drag, button 2 will still work
165 for this, the difference is button 2 will not change the selection.
167 (1.3.6) A middle button click will now toggle selection of clicked item.
169 (1.3.5) UTF-8 and filenames: GQview works fine if your filenames
170 correctly match the prefered locale encoding (LANG environment
171 variable), and prints errors on the console when they do not.
173 (1.3.3) Safe delete does not include undo, you will need to go to the
174 trash folder and retrieve the file(s) manually. The files can be viewed
175 by clicking the view button near the safe delete option in the preferences
176 window. Files moved to the trash folder are prefixed with a 6 digit
177 number. Lower numbers are older, and deleted (permanently) first when the
178 trash size limit is reached.
180 (1.3.2) New in 1.3.2 are sidebars for exif data display and a sort
181 manager. Exif (ctrl + E) should be self explanatory. The Sort manager is a
182 directory list that allows copying or moving the displayed image to that
183 destination with one click of the button - very helpful when visually
184 sorting many images into subdirectories. To edit, reorder, or remove items
185 in the sort list, use the right click menu. The keyboard can also be used
186 by moving the focus to the desired button, then pressing menu/ctrl+f10 key
187 to display the popup menu, or shift+up/shift+down keys to change the
188 button location in the list. Items can also be added to the list by
189 dragging a directory onto the list.
193 If you plan on making any major changes to the code that will be offered
194 for inclusion to the main source, please contact me first - so that we
195 can avoid duplication of effort. A good example is porting any part of
196 GQview that uses deprecated widgets to GTK2 widgets, there are already
197 several such patches floating around. This is especially true if the
198 change is listed in the TODO!
199 -John ( johne@verizon.net )
205 ======== Installation
207 Compilation: ./configure ; make
208 General install: make install
209 Removal: make uninstall
211 - To build an RPM binary:
213 on RedHat 6.x, 7.x use 'rpm -tb gqview-x.x.x.tar.gz'.
214 on RedHat 8 and 9 use 'rpmbuild -tb gqview-x.x.x.tar.gz'.
215 on other rpm distros, it depends on which version of rpm is used, if
216 the option fails with the rpm command, try rpmbuild.
218 Where the resulting package is placed is distribution specific, for
219 example in RedHat it is placed in /usr/src/redhat/RPMS/{architecture}/
221 ======== Description / Features
223 GQview is a graphics file viewer. Basic features:
225 - Single click image viewing / navigation.
227 - Thumbnails, with optional caching and .xvpics support.
228 - Multiple file selection for move, copy, delete, rename, drag and drop.
232 - Ability to open images in external editors (configurable).
234 - Comparison of images to find duplicates by name, size, date,
235 dimensions, or image content similarity.
238 ======== Documentation (brief) [section:documentation]
241 [PageDown], [Keypad PageDown] next image
242 [PageUp], [Keypad PageUp] previous image
243 [Home], [Keypad Home] first image in list
244 [End], [Keypad End] last image in list
245 [Tab] tab completion in path entry window
246 [Escape] cancel completion in path entry window
248 Keyboard commands valid when image has focus (image has black rectangle)
249 arrow keys, [Keypad arrows] pan image
250 [Shift] - arrow keys pan image faster
252 [Backspace] , B previous image
255 [Ctrl] - N new window
256 C new empty collection
258 D open a Find Duplicates window
259 [Shift]- P open Print dialog
260 [Ctrl] - F new folder
263 [Ctrl] - R rename file
264 [Ctrl] - D, [Delete] delete file
265 [Ctrl] - W close window
266 [Ctrl] - Q exit GQview
269 [Ctrl] - 1 .. 0 run external editor
270 [Ctrl] - A select all files
271 [Ctrl] - [Shift] - A unselect all files
272 [Ctrl] - P display image properties window
273 [Ctrl] - O configure Options
274 ] rotate image clockwise
275 [ rotate image counterclockwise
276 [Shift] - R rotate image 180 degrees
277 [Shift] - M mirror image (horizontal)
278 [Shift] - F flip image (verticle)
279 [Shift] - G grayscale image
282 +, =, [Keypad +] zoom in
283 -, [Keypad -] zoom out
284 Z, [Keypad /] zoom to original size
285 X, [Keypad *] zoom to fit within window
286 W zoom to fit width of window
287 H zoom to fit height of window
288 1, 2, 3, 4 zoom to Nx (3 = 3x)
289 9, 8, 7 zoom to -2, -3, -4, respectively
290 T toggle thumbnails in list view
291 [Ctrl] - L display files as list view
292 [Ctrl] - I display files as icon view
293 [Ctrl] - T toggle tree view of directories
295 L (Un)float file selection area
296 [ctrl] - H (Un)hide file selection area
297 [Ctrl] - K toggle Keywords sidebar
298 [Ctrl] - E toggle EXIF sidebar
299 [Ctrl] - S toggle sort manager sidebar
300 F, V toggle full screen
302 P (Un)pause slideshow
303 [Ctrl] - V display current image in new window
307 arrows, [Keypad arrows] move selection
308 [Shift] + arrows select multiple images
309 [Ctrl] + arrows move without changing selection
310 [Space] select only image with focus
311 [Ctrl] + [Space] toggle selection of image with focus
312 [Home], [Keypad Home] move focus to top of images
313 [End], [Keypad End] move focus to end of images
314 (shift and ctrl work with Home, End, PageUp/Down as with arrows)
315 [Ctrl] - A select all images
316 [Ctrl] - [Shift] - A unselect all images
318 [Delete], [Keypad Delete] remove selected images from collection
319 (does not delete file)
320 [Ctrl] - L add images from main window file list
322 [Ctrl] - T toggle display of icon filename text
324 N sort collection by name
325 D sort collection by date
326 B sort collection by size (bytes)
327 P sort collection by location (path)
328 I (*) sort collection by name numerically
329 (file1 file10 file2 -> file1 file2 file10)
331 [Enter], [Keypad Enter] view image with focus in main window
332 V view image with focus in new window
333 [Ctrl] - 1 .. 0 open selected image(s) in editor
336 [Ctrl] - S save collection as...
337 A append to collection...
339 [Shift] - P print selected images...
341 [Ctrl] - C copy selected files...
342 [Ctrl] - M move selected files...
343 [Ctrl] - R rename selected files...
344 [Ctrl] - D delete selected files
346 [Ctrl] - P display image properties window
348 [Ctrl] - W close window
350 Find Duplicates window:
352 [Ctrl] - A select all images
353 [Ctrl] - [Shift] - A unselect all images
354 1 select group 1 duplicates
355 2 select group 2 duplicates
357 [Ctrl] - L add images from main window file list
358 C add selected images to new collection
360 [Delete], [Keypad Delete] remove selected images from list
361 [Ctrl] - [Delete] clear window
363 [Enter], [Keypad Enter] view image with focus in main window
364 V view image with focus in new window
365 [Ctrl] - 1 .. 0 open selected image(s) in editor
367 [Ctrl] - C copy selected files...
368 [Ctrl] - M move selected files...
369 [Ctrl] - R rename selected files...
370 [Ctrl] - D delete selected files
372 [Ctrl] - P display image properties window
374 [Ctrl] - W close window
378 [Ctrl] - F, / show search bar
379 [Ctrl] - G repeat previous search
381 (*) This is a compile time option enabled when strverscmp is found.
385 Button 1 view next image
386 Button 2 view previous image
387 Button 3 context menu
389 Button 1 drag scroll/pan image
390 Button 2 drag initiate drag and drop
392 Wheel up/down change to previous/next image
393 Wheel up/down + [Shift] scroll image up/down
394 Wheel up/down + [Control] zoom image in/out
396 ======== Editor command macros [section:editors]
398 Any one of the following filename markers may be used:
400 %f Replaced with list of selected files, may occur once.
401 %p Command is run once for each selected file, may occur multiple times.
402 none When neither %f or %p exist, list of files is appended to command.
404 Use of the following to display output window for the command:
406 %v Display result of command in output window, must occur as first two
407 characters in the command, or immediately after the "%w" macro.
408 %V Like v above, but when used with %p, only displays output window for
409 multiple files. The output of a single file is suppressed.
413 %w Prevent full screen from deactivating when command is executed,
414 must occur as the first two characters.
416 ======== Additional comments:
419 These options are not adjustable in the preferences window, to change
420 them edit $(HOME)/.gqview/gqviewrc while GQview is not running. An option
421 becomes 'advanced' when it is removed from the user's visibility, and
422 only remains so that those few users that really want it will not complain
423 about it's removal :)
425 lazy_image_sync: false
426 Set true to enable the old behavior of lazy image updates when changing
427 directories. (viewed image will remain until a new file is selected)
429 display_dialogs_under_mouse: false
430 Set true to force dialogs to display under the current mouse position,
431 note that this goes against the preference set for the window manager.
433 ======== Translation status:
437 Please send po files/patches in gzipped form to ensure data integrity.
439 Note: completion % in the chart below may not be quite correct when fuzzy
440 translations exist but do not appear in the source.
441 comp % = trans / (trans + fuzzy + untrans)
443 Language Comp (%) Trans Fuzzy Untrans Warn
444 --------------------------------------------------
476 zh_CN.GB2312 22 169 335 240
478 --------------------------------------------------
481 ======== Credits [section:credits]
486 Grzegorz Kowal <g_kowal@poczta.onet.pl>
487 Zbigniew Chyla <cyba@gnome.pl>
488 Emil Nowak <emil5@go2.pl>
489 Wit Wilinski <wit.wilinski@gmail.com>
490 for Polish translation
492 Christopher R. Gabriel <cgabriel@pluto.linux.it>
493 Di Maggio Salvatore <Salvatore.Dimaggio@bologna.marelli.it>
494 Costantino <inverness1ATvirgilio.it>
495 for Italian translation
497 Sandokan <cortex@nextra.sk>
498 Ivan Priesol <priesol@iris-sk.sk>
499 Mgr. Peter Tuharsky <tuharsky@misbb.sk>
500 for Slovak translation
502 Rodrigo Sancho Senosiain <ruy_ikari@bigfoot.com>
503 Ariel Fermani <the_end@bbs.frc.utn.edu.ar>
504 for Spanish translation
506 Eric Lassauge <lassauge@users.sf.net>
507 Jean-Pierre Pedron <jppedron@club-internet.fr>
508 Pascal Bleser <pascal.bleser@atosorigin.com>
509 Nicolas Boos <nicolas.boos@wanadoo.fr>
510 Nicolas Bonifas <nicolas_bonifas@users.sf.net>
511 for French translation
513 Fâtih Demir <kabalak@gmx.net>
514 for Turkish translation
516 Kam Tik <kamtik@hongkong.com>
517 Abel Cheung <deaddog@deaddog.ws>
518 S.J. Luo <crystal@mickey.ee.nctu.edu.tw>
519 for Traditional Chinese (Big5) translation
521 Junichi Uekawa <dancer@debian.org>
522 Oleg Andrjushenko <oandr@itec.cn.ua>
523 Michael Bravo <mbravo@tag-ltd.spb.ru>
524 Sergey Pinaev <dfo@antex.ru>
525 for Russian translation
527 Guilherme M. Schroeder <slump@ieg.com.br>
528 Vitor Fernandes <vitor_fernandes@SoftHome.net>
529 Herval Ribeiro de Azevêdo <heraze@gmail.com>
530 for Brazilian Portuguese translation
532 Shingo Akagaki <akagaki@ece.numazu-ct.ac.jp>
533 Yuuki Ninomiya <gm@debian.or.jp>
534 Sato Satoru <ss@gnome.gr.jp>
535 Takeshi AIHANA <aihana@gnome.gr.jp>
536 for Japanese translation
538 Matthias Warkus <mawarkus@t-online.de>
539 Thomas Klausner <wiz@danbala.ifoer.tuwien.ac.at>
540 Danny Milosavljevic <danny_milo@yahoo.com>
541 Ronny Steiner <Post@SIRSteiner.de>
542 for German translation
544 Matej Erman <matej.erman@guest.arnes.si>
545 for Slovene translation
547 MÃtyÃs Tibor <templar@tempi.scene.hu>
548 Koblinger Egmont <egmont@uhulinux.hu>
549 Sári Gábor <saga@externet.hu>
550 for Hungarian translation
552 Wu Yulun <migr@operamail.com>
553 Charles Wang <charlesw1234cn@yahoo.com.cn>
554 for simplified Chinese translation
556 H.J.Visser <H.J.Visser@harrie.mine.nu>
557 Tino Meinen <a.t.meinen@chello.nl>
558 for Dutch translation
560 Lauri Nurmi <lanurmi@iki.fi>
561 for Finnish translation
563 Ilmar Kerm <ikerm@hot.ee>
564 for Estonian translation
566 Volodymyr M. Lisivka <lvm@mystery.lviv.net>
567 for Ukrainian translation
569 Birger Langkjer <birger.langkjer@image.dk>
570 for Danish translation
572 Torgeir Ness Sundli <torgeir@mp3bil.no>
573 for Norwegian translation
575 Jan Raska <jan.raska@tiscali.cz>
576 Michal Bukovjan <bukm@centrum.cz>
577 for Czech translation
579 Phanumas Thanyaboon <maskung@hotmail.com>
582 Harald Ersch <hersch@romatsa.ro>
583 for Romanian translation
585 pclouds <pclouds@vnlinux.org>
586 for Vietnamese translation
588 Tedi Heriyanto <tedi_h@gmx.net>
589 for Indonesian translation
591 Vladimir Petrov <vladux@mail.bg>
592 for Bulgarian translation
594 Hans Öfverbeck <hans.ofverbeck@home.se>
595 for Swedish translation
597 Youssef Assad <youssef@devcabal.org>
598 for Arabic translation
600 catux.org <mecatxis@ya.com>
601 for Catalan translation
603 Hyun-Jin Moon <moonhyunjin@gmail.com
604 for Korean translation
606 Pavel Piatruk <berserker@neolocation.com>
607 for Belarusian translation
609 Piarres Beobide <pi@beobide.net>
610 for Basque translation
612 Antonio C. Codazzi <f_sophia@libero.it>
613 for Esperanto translation
615 Fixes, additions, and patches:
619 for initial Exif support.
621 Daniel M. German <dmgerman at uvic.ca>
622 for Canon raw image support.
625 for Fujifilm raw image support.
627 Diederen Damien <D.Diederen@student.ulg.ac.be>
628 for .xvpics thumbnail reading support.
630 Nick Rusnov <nick@grawk.net>
631 Ryan Murray <rmurray@debian.org>
634 Martin Pool <mbp@samba.org>
635 for sort by number, misc. improvements.
637 Jörg Mensmann <joerg.mensmann@gmx.de>
638 for Xinerama support patch.
641 for miscellaneous fixes.
645 Thanks to the users for finding GQview useful.