1 ###################################################################
4 ## Copyright (C) 2008 - 2009 The Geeqie Team ##
5 ## Copyright (C) 1999 - 2006 John Ellis. ##
7 ## Use at your own risk! ##
9 ## This software released under the GNU General Public License. ##
10 ## Please read the COPYING file for more information. ##
11 ###################################################################
13 This is Geeqie, a successor of GQview.
15 Geeqie has been forked from GQview project, because it was not
16 possible to contact gqview author and the only maintainer.
17 Geeqie projects goal is to move the development forward and
18 also integrate the existing patches.
20 Geeqie is currently in beta state. All planed features for 1.0 are implemented,
21 but there are bugs. Please report any crash or odd behavior to the bugtracker:
22 https://sourceforge.net/tracker/?group_id=222125&atid=1054680
25 http://geeqie.sourceforge.net
30 Please send any question or suggestions to
31 geeqie-devel@lists.sourceforge.net
36 ======== README contents:
39 * Notes and changes for this release
41 * Description / Features
42 * Documentation (keyboard shortcuts)
43 * Editor command macros
51 GTK+ 2.??.x: ftp://ftp.gtk.org/pub/gtk
52 FIXME: determine realistic requirements.
53 It compiles with GTK 2.10, but some features are disabled and the testing was
54 minimal. Please report success or falilures.
57 lcms, for color management support: http://www.littlecms.com
58 (disable with configure option: '--without-lcms')
59 exiv2, for enhanced exif support: http://www.exiv2.org/
60 (disable with configure option: '--without-exiv2')
61 - due to fast development, newer versions work significantly better
62 FIXME: minimal version ?
63 lirc, for remote control support: http://www.lirc.org/
64 (disable with configure option: '--disable-lirc')
66 ======== Notes and changes for this release [section:release_notes]
68 !!! FIXME Geeqie changes !!!
69 See http://geeqie.wiki.sourceforge.net/new_features
71 The list for Geeqie is quite long - maybe use separate file?
76 + Add support for color profiles (requires lcms, see Notes).
77 + Add ability to delete a folder and it's contents (with restrictions).
78 - Add support for jpegs embedded in pentax and olympus raw files.
79 - Add icons for image state, enabled with I keyboard shortcut.
80 - For pan view calendar only show months that contain an image.
81 - Make scrolling with overlays (full screen info display) a bit smoother.
82 - Make sort menus display choices as radio group instead of checkbox.
83 - Use white background for transparent images when printing.
84 * Escape filename characters "`$\ before passing them to the system shell
85 when running an editor command.
86 * Fix occasional crash in icon view when removing files.
87 * Always use aligned memory access in EXIF parser, fixes crash
88 with BUS error on sparc.
89 * Fix progress bar warning when removing files while loading thumbnails.
90 * Fix image count in full screen information overlay when in slideshow.
91 * Fix memory leak when unable to start a slideshow.
95 For translation status list, see further below.
97 Version in parentheses indicates first appearance of feature or change.
101 Below are GQView releases:
102 (2.1.5) Add support for color profiles when lcms is installed. To
103 disable color profiles and use of lcms, run configure
104 with '--without-lcms'.
106 (2.1.1) Add support for viewing jpeg images and EXIF embedded within
107 raw files for Canon (.crw, .cr2) Fujifilm (.raf), and Nikon (.nef).
108 Note that not all cameras that support a raw format will necessarily
109 save a usable jpeg in the raw file (for example some Nikon cameras only
110 store a tiny thumbnail within the raw .nef file).
112 (1.5.6) The "shared thumbnail cache" is a proposal to unify the method
113 of storing thumbnails, so that they are compatible between different
114 applications. Using this option will allow GQview to share it's
115 thumbnails with, and use thumbnails from, other applications. Current
116 releases of GNOME (through nautilus and gthumb) and the gimp use this
117 new thumbnailing system. The latest draft of the thumbnail standard
118 is located on freedesktop.org in the standards section, and links to:
120 http://triq.net/~jens/thumbnail-spec/index.html
122 The shared thumbnail standard and GQview's classic mechanism can
123 not be used at the same time, enabling the "use shared thumbnail cache"
124 option will disable the use of classic thumbnails and use the new
127 (1.5.6) Collections contained in $HOME/.gqview/collections are now
128 updated when moving or renaming files, even if the collection is not
131 (1.5.6) The new option to the keep the full screen window above other
132 windows is only available when using at least GTK+ 2.4.0
134 (1.5.5) Dialog buttons are now ordered as recommended by the GNOME HIG.
135 The GNOME Human Interface Guidelines live at:
136 http://developer.gnome.org/projects/gup/hig/
137 To restore the old button order you must be using GTK 2.6 and set
138 the "gtk-alternative-button-order" key to TRUE in the gtkrc file:
140 by changing or adding this line:
141 gtk-alternative-button-order = 1
143 (1.5.5) The dithering option is now a hidden option, to change it
144 please refer to section 10.7 of the manual (help -> contents).
146 (1.5.0) Keywords and comments can now be entered for a file. Two places
147 allow keyword and comment entry. The first is via the new image details
148 sidebar accessed with (Ctrl-K), and the second is a details tab in the
149 properties dialog. If multiple files are selected, two buttons are
150 available: One allows adding the keywords to the selected files, the
151 other replaces existing keywords with the new keywords.
153 Keyword and comment metadata is stored in $(HOME)/.gqview/metadata, and
154 mirrors the existing filesystem tree. Metadata filenames have a suffix
155 of .meta appended. If 'cache into .thumbnails' is enabled, metadata is
156 stored locally to the original file in a hidden subfolder ".metadata".
157 If write permissions do not allow local saving of metadata, GQview falls
158 back to the default $(HOME)/.gqview/metadata location.
160 (1.5.0) Search dialog (F3 key) types:
161 Path searches files in the entered folder.
162 Comments searches all file metadata stored in ~/.gqview/metadata.
163 Results searches the current list of results, allowing refinement.
165 (1.3.6) Drag and drop has been significantly improved, with a few
166 changes. Button 1 will now initiate a drag, button 2 will still work
167 for this, the difference is button 2 will not change the selection.
169 (1.3.6) A middle button click will now toggle selection of clicked item.
171 (1.3.5) UTF-8 and filenames: GQview works fine if your filenames
172 correctly match the preferred locale encoding (LANG environment
173 variable), and prints errors on the console when they do not.
175 (1.3.3) Safe delete does not include undo, you will need to go to the
176 trash folder and retrieve the file(s) manually. The files can be viewed
177 by clicking the view button near the safe delete option in the preferences
178 window. Files moved to the trash folder are prefixed with a 6 digit
179 number. Lower numbers are older, and deleted (permanently) first when the
180 trash size limit is reached.
182 (1.3.2) New in 1.3.2 are sidebars for EXIF data display and a sort
183 manager. EXIF (ctrl + E) should be self explanatory. The Sort manager is a
184 directory list that allows copying or moving the displayed image to that
185 destination with one click of the button - very helpful when visually
186 sorting many images into subdirectories. To edit, reorder, or remove items
187 in the sort list, use the right click menu. The keyboard can also be used
188 by moving the focus to the desired button, then pressing menu/ctrl+f10 key
189 to display the popup menu, or shift+up/shift+down keys to change the
190 button location in the list. Items can also be added to the list by
191 dragging a directory onto the list.
195 If you plan on making any major changes to the code that will be offered
196 for inclusion to the main source, please contact us first - so that we
197 can avoid duplication of effort. A good example is porting any part of
198 GQview that uses deprecated widgets to GTK2 widgets, there are already
199 several such patches floating around. This is especially true if the
200 change is listed in the TODO!
205 see the Geeqie Bug Tracker at TODO file.
207 ======== Installation
209 Compilation: ./configure ; make
210 General install: make install
211 Removal: make uninstall
214 - To build an RPM binary:
216 on RedHat 6.x, 7.x use 'rpm -tb gqview-x.x.x.tar.gz'.
217 on RedHat 8 and 9 use 'rpmbuild -tb gqview-x.x.x.tar.gz'.
218 on other rpm distros, it depends on which version of rpm is used, if
219 the option fails with the rpm command, try rpmbuild.
221 Where the resulting package is placed is distribution specific, for
222 example in RedHat it is placed in /usr/src/redhat/RPMS/{architecture}/
224 ======== Description / Features
226 Geeqie is a graphics file viewer. Basic features:
228 - Single click image viewing / navigation.
230 - Thumbnails, with optional caching and .xvpics support.
231 - Multiple file selection for move, copy, delete, rename, drag and drop.
235 - Ability to open images in external editors (configurable).
237 - Comparison of images to find duplicates by name, size, date,
238 dimensions, or image content similarity.
241 ======== Documentation (brief) [section:documentation]
243 FIXME: do we need this section? The keyboard configuration dialog should provide
244 correct up-to-date list.
247 [PageDown], [Keypad PageDown] next image
248 [PageUp], [Keypad PageUp] previous image
249 [Home], [Keypad Home] first image in list
250 [End], [Keypad End] last image in list
251 [Tab] tab completion in path entry window
252 [Escape] cancel completion in path entry window
254 Keyboard commands valid when image has focus (image has black rectangle)
255 arrow keys, [Keypad arrows] pan image
256 [Shift] - arrow keys pan image faster
258 [Backspace] , B previous image
261 [Ctrl] - N new window
262 C new empty collection
264 D open a Find Duplicates window
265 [Shift]- P open Print dialog
266 [Ctrl] - F new folder
269 [Ctrl] - R rename file
270 [Ctrl] - D, [Delete] delete file
271 [Ctrl] - W close window
272 [Ctrl] - Q exit GQview
275 [Ctrl] - 1 .. 0 run external editor
276 [Ctrl] - A select all files
277 [Ctrl] - [Shift] - A unselect all files
278 [Ctrl] - P display image properties window
279 [Ctrl] - O configure Options
280 ] rotate image clockwise
281 [ rotate image counterclockwise
282 [Shift] - R rotate image 180 degrees
283 [Shift] - M mirror image (horizontal)
284 [Shift] - F flip image (vertical)
285 [Shift] - G grayscale image
288 +, =, [Keypad +] zoom in
289 -, [Keypad -] zoom out
290 Z, [Keypad /] zoom to original size
291 X, [Keypad *] zoom to fit within window
292 W zoom to fit width of window
293 H zoom to fit height of window
294 1, 2, 3, 4 zoom to Nx (3 = 3x)
295 9, 8, 7 zoom to -2, -3, -4, respectively
296 T toggle thumbnails in list view
297 [Ctrl] - L display files as list view
298 [Ctrl] - I display files as icon view
299 [Ctrl] - T toggle tree view of directories
301 L (Un)float file selection area
302 [ctrl] - H (Un)hide file selection area
303 [Ctrl] - K toggle Keywords sidebar
304 [Ctrl] - E toggle EXIF sidebar
305 [Ctrl] - S toggle sort manager sidebar
306 F, V toggle full screen
308 P (Un)pause slideshow
309 [Ctrl] - V display current image in new window
313 arrows, [Keypad arrows] move selection
314 [Shift] + arrows select multiple images
315 [Ctrl] + arrows move without changing selection
316 [Space] select only image with focus
317 [Ctrl] + [Space] toggle selection of image with focus
318 [Home], [Keypad Home] move focus to top of images
319 [End], [Keypad End] move focus to end of images
320 (shift and ctrl work with Home, End, PageUp/Down as with arrows)
321 [Ctrl] - A select all images
322 [Ctrl] - [Shift] - A unselect all images
324 [Delete], [Keypad Delete] remove selected images from collection
325 (does not delete file)
326 [Ctrl] - L add images from main window file list
328 [Ctrl] - T toggle display of icon filename text
330 N sort collection by name
331 D sort collection by date
332 B sort collection by size (bytes)
333 P sort collection by location (path)
334 I (*) sort collection by name numerically
335 (file1 file10 file2 -> file1 file2 file10)
337 [Enter], [Keypad Enter] view image with focus in main window
338 V view image with focus in new window
339 [Ctrl] - 1 .. 0 open selected image(s) in editor
342 [Ctrl] - S save collection as...
343 A append to collection...
345 [Shift] - P print selected images...
347 [Ctrl] - C copy selected files...
348 [Ctrl] - M move selected files...
349 [Ctrl] - R rename selected files...
350 [Ctrl] - D delete selected files
352 [Ctrl] - P display image properties window
354 [Ctrl] - W close window
356 Find Duplicates window:
358 [Ctrl] - A select all images
359 [Ctrl] - [Shift] - A unselect all images
360 1 select group 1 duplicates
361 2 select group 2 duplicates
363 [Ctrl] - L add images from main window file list
364 C add selected images to new collection
366 [Delete], [Keypad Delete] remove selected images from list
367 [Ctrl] - [Delete] clear window
369 [Enter], [Keypad Enter] view image with focus in main window
370 V view image with focus in new window
371 [Ctrl] - 1 .. 0 open selected image(s) in editor
373 [Ctrl] - C copy selected files...
374 [Ctrl] - M move selected files...
375 [Ctrl] - R rename selected files...
376 [Ctrl] - D delete selected files
378 [Ctrl] - P display image properties window
380 [Ctrl] - W close window
384 [Ctrl] - F, / show search bar
385 [Ctrl] - G repeat previous search
387 (*) This is a compile time option enabled when strverscmp is found.
391 Button 1 view next image
392 Button 2 view previous image
393 Button 3 context menu
395 Button 1 drag scroll/pan image
396 Button 2 drag initiate drag and drop
398 Wheel up/down change to previous/next image
399 Wheel up/down + [Shift] scroll image up/down
400 Wheel up/down + [Control] zoom image in/out
403 ======== Editor command macros [section:editors]
405 Editors are configured via standard desktop files, see
406 http://standards.freedesktop.org/desktop-entry-spec/latest/
408 FIXME: Geeqie extensions
411 ======== Overlay Info [section:overlay]
413 Overlay info format string syntax is: %tag[:max_length][:extra]%
415 %name% Filename of the picture.
416 %collection% Name of the collection
417 %number% Current number of image in the list
418 %total% Total number of images
422 %height% Image height
423 %res% Image resolution
424 %keywords% Image keywords from metadata
425 %comment% Image comment from metadata
427 To access exif data use the exif name:
428 %Exif.Photo.DateTimeOriginal% Date of the original shot
430 Pre-formatted exif data is also available:
431 formatted.Camera Camera and sofware name
432 formatted.DateTime Image Date
433 formatted.ShutterSpeed Shutter speed in seconds (ie. 1/60s)
434 formatted.Aperture Aperture (ie. f5.6)
435 formatted.ExposureBias Exposure bias (ie. +0.3)
436 formatted.ISOSpeedRating ISO sensitivity (ie. 100)
437 formatted.FocalLength Focal length
438 formatted.FocalLength35mmFilm Focal length 35mm
439 formatted.SubjectDistance Subject distance
440 formatted.Flash Flash
441 formatted.Resolution Resolution
442 formatted.ColorProfile Color profile
443 formatted.GPSPosition GPS position
444 formatted.GPSAltitude GPS altitude
446 You can limit the length of displayed data using :number notation:
447 %formatted.Camera:20% will truncate the displayed data to 20 characters
448 and will add 3 dots at the end to denote the truncation.
450 If two or more variables are connected with the |-sign, it prints available
451 variables with a separator:
452 %formatted.ShutterSpeed%|%formatted.ISOSpeedRating%|%formatted.FocalLength%
454 "1/20s - 400 - 80 mm"
456 "1/200 - 80 mm" if there's no ISO information in the Exif data.
458 If a line is empty, it is removed.
459 This allows to add lines that totally disappear when no data is available.
461 Extra string uses special character '*' to mark the position of the data.
462 If no '*' is present, then extra string is just appended to data.
463 Any "\n" is replaced by a newline on display.
464 Pango mark up is accepted in left and right parts.
465 If data is empty, nothing will be displayed.
468 "%name:<i>*</i>\n%" -> name is displayed in italics ended with a newline
469 "%size:\n%" -> size is displayed with a newline at end
470 "%formatted.ISOSpeedRating:ISO *%" -> ie. "ISO 100"
471 "Collection <b>*</b>\n" -> display collection name in bold prefixed by
472 "Collection " and a newline is appended
475 ======== Additional comments:
477 FIXME: here are some changes
480 These options are not adjustable in the preferences window, to change
481 them edit $(HOME)/.geeqie/geeqierc while Geeqie is not running. An option
482 becomes 'hidden' when it is removed from the user's visibility, and
483 only remains so that those few users that really want it will not complain
484 about it's removal :)
486 lazy_image_sync: false
487 Set true to enable the old behavior of lazy image updates when changing
488 directories. (viewed image will remain until a new file is selected)
490 display_dialogs_under_mouse: false
491 Set true to force dialogs to display under the current mouse position,
492 note that this goes against the preference set for the window manager.
496 ======== Credits [section:credits]
501 Grzegorz Kowal <g_kowal@poczta.onet.pl>
502 Zbigniew Chyla <cyba@gnome.pl>
503 Emil Nowak <emil5@go2.pl>
504 Wit Wilinski <wit.wilinski@gmail.com>
505 for Polish translation
507 Christopher R. Gabriel <cgabriel@pluto.linux.it>
508 Di Maggio Salvatore <Salvatore.Dimaggio@bologna.marelli.it>
509 Costantino <inverness1ATvirgilio.it>
510 for Italian translation
512 Sandokan <cortex@nextra.sk>
513 Ivan Priesol <priesol@iris-sk.sk>
514 Mgr. Peter Tuharsky <tuharsky@misbb.sk>
515 for Slovak translation
517 Rodrigo Sancho Senosiain <ruy_ikari@bigfoot.com>
518 Ariel Fermani <the_end@bbs.frc.utn.edu.ar>
519 for Spanish translation
521 Laurent Monin <i18n@norz.org>
522 Eric Lassauge <lassauge@users.sf.net>
523 Jean-Pierre Pedron <jppedron@club-internet.fr>
524 Pascal Bleser <pascal.bleser@atosorigin.com>
525 Nicolas Boos <nicolas.boos@wanadoo.fr>
526 Nicolas Bonifas <nicolas_bonifas@users.sf.net>
527 for French translation
529 Fâtih Demir <kabalak@gmx.net>
530 for Turkish translation
532 Kam Tik <kamtik@hongkong.com>
533 Abel Cheung <deaddog@deaddog.ws>
534 S.J. Luo <crystal@mickey.ee.nctu.edu.tw>
535 for Traditional Chinese (Big5) translation
537 Junichi Uekawa <dancer@debian.org>
538 Oleg Andrjushenko <oandr@itec.cn.ua>
539 Michael Bravo <mbravo@tag-ltd.spb.ru>
540 Sergey Pinaev <dfo@antex.ru>
541 for Russian translation
543 Guilherme M. Schroeder <slump@ieg.com.br>
544 Vitor Fernandes <vitor_fernandes@SoftHome.net>
545 Herval Ribeiro de Azevêdo <heraze@gmail.com>
546 for Brazilian Portuguese translation
548 Shingo Akagaki <akagaki@ece.numazu-ct.ac.jp>
549 Yuuki Ninomiya <gm@debian.or.jp>
550 Sato Satoru <ss@gnome.gr.jp>
551 Takeshi AIHANA <aihana@gnome.gr.jp>
552 for Japanese translation
554 Matthias Warkus <mawarkus@t-online.de>
555 Thomas Klausner <wiz@danbala.ifoer.tuwien.ac.at>
556 Danny Milosavljevic <danny_milo@yahoo.com>
557 Ronny Steiner <Post@SIRSteiner.de>
558 Klaus Ethgen <Klaus@Ethgen.de>
559 for German translation
561 Matej Erman <matej.erman@guest.arnes.si>
562 for Slovene translation
564 MÃtyÃs Tibor <templar@tempi.scene.hu>
565 Koblinger Egmont <egmont@uhulinux.hu>
566 Sári Gábor <saga@externet.hu>
567 for Hungarian translation
569 Wu Yulun <migr@operamail.com>
570 Charles Wang <charlesw1234cn@yahoo.com.cn>
571 for simplified Chinese translation
573 H.J.Visser <H.J.Visser@harrie.mine.nu>
574 Tino Meinen <a.t.meinen@chello.nl>
575 for Dutch translation
577 Lauri Nurmi <lanurmi@iki.fi>
578 for Finnish translation
580 Ilmar Kerm <ikerm@hot.ee>
581 for Estonian translation
583 Volodymyr M. Lisivka <lvm@mystery.lviv.net>
584 for Ukrainian translation
586 Birger Langkjer <birger.langkjer@image.dk>
587 for Danish translation
589 Torgeir Ness Sundli <torgeir@mp3bil.no>
590 for Norwegian translation
592 Jan Raska <jan.raska@tiscali.cz>
593 Michal Bukovjan <bukm@centrum.cz>
594 for Czech translation
596 Phanumas Thanyaboon <maskung@hotmail.com>
599 Harald Ersch <hersch@romatsa.ro>
600 for Romanian translation
602 pclouds <pclouds@vnlinux.org>
603 for Vietnamese translation
605 Tedi Heriyanto <tedi_h@gmx.net>
606 for Indonesian translation
608 Vladimir Petrov <vladux@mail.bg>
609 for Bulgarian translation
611 Hans Öfverbeck <hans.ofverbeck@home.se>
612 for Swedish translation
614 Youssef Assad <youssef@devcabal.org>
615 for Arabic translation
617 catux.org <mecatxis@ya.com>
618 for Catalan translation
620 Hyun-Jin Moon <moonhyunjin@gmail.com
621 for Korean translation
623 Pavel Piatruk <berserker@neolocation.com>
624 for Belarusian translation
626 Piarres Beobide <pi@beobide.net>
627 for Basque translation
629 Antonio C. Codazzi <f_sophia@libero.it>
630 for Esperanto translation
632 Fixes, additions, and patches:
636 for initial Exif support.
638 Daniel M. German <dmgerman at uvic.ca>
639 for Canon raw image support.
642 for Fujifilm raw image support.
644 Diederen Damien <D.Diederen@student.ulg.ac.be>
645 for .xvpics thumbnail reading support.
647 Nick Rusnov <nick@grawk.net>
648 Ryan Murray <rmurray@debian.org>
651 Martin Pool <mbp@samba.org>
652 for sort by number, misc. improvements.
654 Jörg Mensmann <joerg.mensmann@gmx.de>
655 for Xinerama support patch.
658 for miscellaneous fixes.
661 for Exif enhancements, histogram and other patches
664 for customizable fullscreen overlay
667 for print related enhancements
670 for copy path to clipboard patch
673 for random slide show speedup patch
675 Klaus Ethgen <Klaus@Ethgen.de>
676 for GPS integration, Search enhancement and other patches
679 Thanks to the users for finding Geeqie useful.
682 ======== Translation status:
684 Please send po files/patches in gzipped form to ensure data integrity.
686 Translations statistics
687 Date: Fri, 05 Sep 2008 00:30:54 +0200
689 Note: completion % in the chart below may not be quite correct
690 when fuzzy translations exist but do not appear in the source.
691 For exact results, run make update-po with up to date POTFILES.in.
692 comp % = trans / (trans + fuzzy + untrans)
694 Language Comp(%) Trans Fuzzy Untrans Total
695 fr 100.00 996 0 0 996
696 be 82.43 821 77 98 996
697 ru 71.99 717 128 151 996
698 eu 62.05 618 185 193 996
699 eo 61.95 617 186 193 996
700 vi 61.85 616 192 188 996
701 it 61.65 614 187 195 996
702 pt_BR 61.65 614 187 195 996
703 zh_TW 60.84 606 183 207 996
704 sk 60.34 601 192 203 996
705 fi 58.23 580 211 205 996
706 nl 58.23 580 214 202 996
707 sv 58.03 578 207 211 996
708 bg 57.93 577 208 211 996
709 ca 57.93 577 208 211 996
710 cs 57.93 577 208 211 996
711 de 57.93 577 208 211 996
712 es 57.93 577 208 211 996
713 ja 57.93 577 208 211 996
714 pl 55.32 551 180 265 996
715 ar 38.86 387 332 277 996
716 ro 34.34 342 352 302 996
717 hu 32.93 328 342 326 996
718 id 17.17 171 412 413 996
719 et 16.77 167 411 418 996
720 uk 14.86 148 413 435 996
721 nb 13.76 137 418 441 996
722 zh_CN.GB2312 13.76 137 419 440 996
723 th 12.95 129 413 454 996
724 sl 12.55 125 422 449 996
725 da 11.85 118 406 472 996
726 ko 11.04 110 65 821 996
727 tr 4.92 49 395 552 996