1 ###################################################################
4 ## Copyright (C) 2008 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 alpha state. Everybody is encouraged
21 to try the new features, however for stable software look at
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.4.x: ftp://ftp.gtk.org/pub/gtk
54 lcms, for color management support: http://www.littlecms.com
55 (disable with configure option: '--without-lcms')
56 exiv2, for enhanced exif support: http://www.exiv2.org/
57 (disable with configure option: '--without-exiv2')
58 lirc, for remote control support: http://www.lirc.org/
59 (disable with configure option: '--disable-lirc')
61 ======== Notes and changes for this release [section:release_notes]
65 + Add support for color profiles (requires lcms, see Notes).
66 + Add ability to delete a folder and it's contents (with restrictions).
67 - Add support for jpegs embedded in pentax and olympus raw files.
68 - Add icons for image state, enabled with I keyboard shortcut.
69 - For pan view calendar only show months that contain an image.
70 - Make scrolling with overlays (full screen info display) a bit smoother.
71 - Make sort menus display choices as radio group instead of checkbox.
72 - Use white background for transparent images when printing.
73 * Escape filename characters "`$\ before passing them to the system shell
74 when running an editor command.
75 * Fix occasional crash in icon view when removing files.
76 * Always use aligned memory access in EXIF parser, fixes crash
77 with BUS error on sparc.
78 * Fix progress bar warning when removing files while loading thumbnails.
79 * Fix image count in full screen information overlay when in slideshow.
80 * Fix memory leak when unable to start a slideshow.
84 For translation status list, see further below.
86 Version in parenthesis indicates first appearance of feature or change.
88 !!! FIXME Geeqie changes !!!
90 Below are GQView releases:
91 (2.1.5) Add support for color profiles when lcms is installed. To
92 disable color profiles and use of lcms, run configure
93 with '--without-lcms'.
95 (2.1.1) Add support for viewing jpeg images and EXIF embedded within
96 raw files for Canon (.crw, .cr2) Fujifilm (.raf), and Nikon (.nef).
97 Note that not all cameras that support a raw format will necessarily
98 save a usable jpeg in the raw file (for example some Nikon cameras only
99 store a tiny thumbnail within the raw .nef file).
101 (1.5.6) The "shared thumbnail cache" is a proposal to unify the method
102 of storing thumbnails, so that they are compatible between different
103 applications. Using this option will allow GQview to share it's
104 thumbnails with, and use thumbnails from, other applications. Current
105 releases of GNOME (through nautilus and gthumb) and the gimp use this
106 new thumbnailing system. The latest draft of the thumbnail standard
107 is located on freedesktop.org in the standards section, and links to:
109 http://triq.net/~jens/thumbnail-spec/index.html
111 The shared thumbnail standard and GQview's classic mechanism can
112 not be used at the same time, enabling the "use shared thumbnail cache"
113 option will disable the use of classic thumbnails and use the new
116 (1.5.6) Collections contained in $HOME/.gqview/collections are now
117 updated when moving or renaming files, even if the collection is not
120 (1.5.6) The new option to the keep the full screen window above other
121 windows is only available when using at least GTK+ 2.4.0
123 (1.5.5) Dialog buttons are now ordered as recommended by the GNOME HIG.
124 The GNOME Human Interface Guidelines live at:
125 http://developer.gnome.org/projects/gup/hig/
126 To restore the old button order you must be using GTK 2.6 and set
127 the "gtk-alternative-button-order" key to TRUE in the gtkrc file:
129 by changing or adding this line:
130 gtk-alternative-button-order = 1
132 (1.5.5) The dithering option is now a hidden option, to change it
133 please refer to section 10.7 of the manual (help -> contents).
135 (1.5.0) Keywords and comments can now be entered for a file. Two places
136 allow keyword and comment entry. The first is via the new image details
137 sidebar accessed with (Ctrl-K), and the second is a details tab in the
138 properties dialog. If multiple files are selected, two buttons are
139 available: One allows adding the keywords to the selected files, the
140 other replaces existing keywords with the new keywords.
142 Keyword and comment metadata is stored in $(HOME)/.gqview/metadata, and
143 mirrors the existing filesystem tree. Metadata filenames have a suffix
144 of .meta appended. If 'cache into .thumbnails' is enabled, metadata is
145 stored locally to the original file in a hidden subfolder ".metadata".
146 If write permissions do not allow local saving of metadata, GQview falls
147 back to the default $(HOME)/.gqview/metadata location.
149 (1.5.0) Search dialog (F3 key) types:
150 Path searches files in the entered folder.
151 Comments searches all file metadata stored in ~/.gqview/metadata.
152 Results searches the current list of results, allowing refinement.
154 (1.3.6) Drag and drop has been significantly improved, with a few
155 changes. Button 1 will now initiate a drag, button 2 will still work
156 for this, the difference is button 2 will not change the selection.
158 (1.3.6) A middle button click will now toggle selection of clicked item.
160 (1.3.5) UTF-8 and filenames: GQview works fine if your filenames
161 correctly match the prefered locale encoding (LANG environment
162 variable), and prints errors on the console when they do not.
164 (1.3.3) Safe delete does not include undo, you will need to go to the
165 trash folder and retrieve the file(s) manually. The files can be viewed
166 by clicking the view button near the safe delete option in the preferences
167 window. Files moved to the trash folder are prefixed with a 6 digit
168 number. Lower numbers are older, and deleted (permanently) first when the
169 trash size limit is reached.
171 (1.3.2) New in 1.3.2 are sidebars for exif data display and a sort
172 manager. Exif (ctrl + E) should be self explanatory. The Sort manager is a
173 directory list that allows copying or moving the displayed image to that
174 destination with one click of the button - very helpful when visually
175 sorting many images into subdirectories. To edit, reorder, or remove items
176 in the sort list, use the right click menu. The keyboard can also be used
177 by moving the focus to the desired button, then pressing menu/ctrl+f10 key
178 to display the popup menu, or shift+up/shift+down keys to change the
179 button location in the list. Items can also be added to the list by
180 dragging a directory onto the list.
184 If you plan on making any major changes to the code that will be offered
185 for inclusion to the main source, please contact us first - so that we
186 can avoid duplication of effort. A good example is porting any part of
187 GQview that uses deprecated widgets to GTK2 widgets, there are already
188 several such patches floating around. This is especially true if the
189 change is listed in the TODO!
194 see the Geeqie Bug Tracker at TODO file.
196 ======== Installation
198 Compilation: ./configure ; make
199 General install: make install
200 Removal: make uninstall
203 - To build an RPM binary:
205 on RedHat 6.x, 7.x use 'rpm -tb gqview-x.x.x.tar.gz'.
206 on RedHat 8 and 9 use 'rpmbuild -tb gqview-x.x.x.tar.gz'.
207 on other rpm distros, it depends on which version of rpm is used, if
208 the option fails with the rpm command, try rpmbuild.
210 Where the resulting package is placed is distribution specific, for
211 example in RedHat it is placed in /usr/src/redhat/RPMS/{architecture}/
213 ======== Description / Features
215 Geeqie is a graphics file viewer. Basic features:
217 - Single click image viewing / navigation.
219 - Thumbnails, with optional caching and .xvpics support.
220 - Multiple file selection for move, copy, delete, rename, drag and drop.
224 - Ability to open images in external editors (configurable).
226 - Comparison of images to find duplicates by name, size, date,
227 dimensions, or image content similarity.
230 ======== Documentation (brief) [section:documentation]
233 [PageDown], [Keypad PageDown] next image
234 [PageUp], [Keypad PageUp] previous image
235 [Home], [Keypad Home] first image in list
236 [End], [Keypad End] last image in list
237 [Tab] tab completion in path entry window
238 [Escape] cancel completion in path entry window
240 Keyboard commands valid when image has focus (image has black rectangle)
241 arrow keys, [Keypad arrows] pan image
242 [Shift] - arrow keys pan image faster
244 [Backspace] , B previous image
247 [Ctrl] - N new window
248 C new empty collection
250 D open a Find Duplicates window
251 [Shift]- P open Print dialog
252 [Ctrl] - F new folder
255 [Ctrl] - R rename file
256 [Ctrl] - D, [Delete] delete file
257 [Ctrl] - W close window
258 [Ctrl] - Q exit GQview
261 [Ctrl] - 1 .. 0 run external editor
262 [Ctrl] - A select all files
263 [Ctrl] - [Shift] - A unselect all files
264 [Ctrl] - P display image properties window
265 [Ctrl] - O configure Options
266 ] rotate image clockwise
267 [ rotate image counterclockwise
268 [Shift] - R rotate image 180 degrees
269 [Shift] - M mirror image (horizontal)
270 [Shift] - F flip image (verticle)
271 [Shift] - G grayscale image
274 +, =, [Keypad +] zoom in
275 -, [Keypad -] zoom out
276 Z, [Keypad /] zoom to original size
277 X, [Keypad *] zoom to fit within window
278 W zoom to fit width of window
279 H zoom to fit height of window
280 1, 2, 3, 4 zoom to Nx (3 = 3x)
281 9, 8, 7 zoom to -2, -3, -4, respectively
282 T toggle thumbnails in list view
283 [Ctrl] - L display files as list view
284 [Ctrl] - I display files as icon view
285 [Ctrl] - T toggle tree view of directories
287 L (Un)float file selection area
288 [ctrl] - H (Un)hide file selection area
289 [Ctrl] - K toggle Keywords sidebar
290 [Ctrl] - E toggle EXIF sidebar
291 [Ctrl] - S toggle sort manager sidebar
292 F, V toggle full screen
294 P (Un)pause slideshow
295 [Ctrl] - V display current image in new window
299 arrows, [Keypad arrows] move selection
300 [Shift] + arrows select multiple images
301 [Ctrl] + arrows move without changing selection
302 [Space] select only image with focus
303 [Ctrl] + [Space] toggle selection of image with focus
304 [Home], [Keypad Home] move focus to top of images
305 [End], [Keypad End] move focus to end of images
306 (shift and ctrl work with Home, End, PageUp/Down as with arrows)
307 [Ctrl] - A select all images
308 [Ctrl] - [Shift] - A unselect all images
310 [Delete], [Keypad Delete] remove selected images from collection
311 (does not delete file)
312 [Ctrl] - L add images from main window file list
314 [Ctrl] - T toggle display of icon filename text
316 N sort collection by name
317 D sort collection by date
318 B sort collection by size (bytes)
319 P sort collection by location (path)
320 I (*) sort collection by name numerically
321 (file1 file10 file2 -> file1 file2 file10)
323 [Enter], [Keypad Enter] view image with focus in main window
324 V view image with focus in new window
325 [Ctrl] - 1 .. 0 open selected image(s) in editor
328 [Ctrl] - S save collection as...
329 A append to collection...
331 [Shift] - P print selected images...
333 [Ctrl] - C copy selected files...
334 [Ctrl] - M move selected files...
335 [Ctrl] - R rename selected files...
336 [Ctrl] - D delete selected files
338 [Ctrl] - P display image properties window
340 [Ctrl] - W close window
342 Find Duplicates window:
344 [Ctrl] - A select all images
345 [Ctrl] - [Shift] - A unselect all images
346 1 select group 1 duplicates
347 2 select group 2 duplicates
349 [Ctrl] - L add images from main window file list
350 C add selected images to new collection
352 [Delete], [Keypad Delete] remove selected images from list
353 [Ctrl] - [Delete] clear window
355 [Enter], [Keypad Enter] view image with focus in main window
356 V view image with focus in new window
357 [Ctrl] - 1 .. 0 open selected image(s) in editor
359 [Ctrl] - C copy selected files...
360 [Ctrl] - M move selected files...
361 [Ctrl] - R rename selected files...
362 [Ctrl] - D delete selected files
364 [Ctrl] - P display image properties window
366 [Ctrl] - W close window
370 [Ctrl] - F, / show search bar
371 [Ctrl] - G repeat previous search
373 (*) This is a compile time option enabled when strverscmp is found.
377 Button 1 view next image
378 Button 2 view previous image
379 Button 3 context menu
381 Button 1 drag scroll/pan image
382 Button 2 drag initiate drag and drop
384 Wheel up/down change to previous/next image
385 Wheel up/down + [Shift] scroll image up/down
386 Wheel up/down + [Control] zoom image in/out
389 ======== Editor command macros [section:editors]
391 Any one of the following filename markers may be used:
393 %f Replaced with list of selected files, may occur once.
394 %p Command is run once for each selected file, may occur multiple times.
395 none When neither %f or %p exist, list of files is appended to command.
397 Use of the following to display output window for the command:
399 %v Display result of command in output window, must occur as first two
400 characters in the command, or immediately after the "%w" macro.
401 %V Like v above, but when used with %p, only displays output window for
402 multiple files. The output of a single file is suppressed.
406 %w Prevent full screen from deactivating when command is executed,
407 must occur as the first two characters.
410 ======== Overlay Info [section:overlay]
412 Overlay info format string syntax is: %tag[:max_length][:extra]%
414 %name% Filename of the picture.
415 %collection% Name of the collection
416 %number% Current number of image in the list
417 %total% Total number of images
421 %height% Image height
422 %res% Image resolution
424 To access exif data use the exif name:
425 %Exif.Photo.DateTimeOriginal% Date of the original shot
427 Pre-formatted exif data is also available:
428 formatted.Camera Camera and sofware name
429 formatted.DateTime Image Date
430 formatted.ShutterSpeed Shutter speed in seconds (ie. 1/60s)
431 formatted.Aperture Aperture (ie. f5.6)
432 formatted.ExposureBias Exposure bias (ie. +0.3)
433 formatted.ISOSpeedRating ISO sensitivity (ie. 100)
434 formatted.FocalLength Focal length
435 formatted.FocalLength35mmFilm Focal length 35mm
436 formatted.SubjectDistance Subject distance
437 formatted.Flash Flash
438 formatted.Resolution Resolution
439 formatted.ColorProfile Color profile
441 You can limit the length of displayed data using :number notation:
442 %formatted.Camera:20% will truncate the displayed data to 20 characters
443 and will add 3 dots at the end to denote the truncation.
445 If two or more variables are connected with the |-sign, it prints available
446 variables with a separator:
447 %formatted.ShutterSpeed%|%formatted.ISOSpeedRating%|%formatted.FocalLength%
449 "1/20s - 400 - 80 mm"
451 "1/200 - 80 mm" if there's no ISO information in the Exif data.
453 If a line is empty, it is removed.
454 This allows to add lines that totally disappear when no data is available.
456 Extra string uses special character '*' to mark the position of the data.
457 If no '*' is present, then extra string is just appended to data.
458 Any "\n" is replaced by a newline on display.
459 Pango mark up is accepted in left and right parts.
460 If data is empty, nothing will be displayed.
463 "%name:<i>*</i>\n%" -> name is displayed in italics ended with a newline
464 "%size:\n%" -> size is displayed with a newline at end
465 "%formatted.ISOSpeedRating:ISO *%" -> ie. "ISO 100"
466 "Collection <b>*</b>\n" -> display collection name in bold prefixed by
467 "Collection " and a newline is appended
470 ======== Additional comments:
473 These options are not adjustable in the preferences window, to change
474 them edit $(HOME)/.geeqie/geeqierc while Geeqie is not running. An option
475 becomes 'hidden' when it is removed from the user's visibility, and
476 only remains so that those few users that really want it will not complain
477 about it's removal :)
479 lazy_image_sync: false
480 Set true to enable the old behavior of lazy image updates when changing
481 directories. (viewed image will remain until a new file is selected)
483 display_dialogs_under_mouse: false
484 Set true to force dialogs to display under the current mouse position,
485 note that this goes against the preference set for the window manager.
489 ======== Credits [section:credits]
494 Grzegorz Kowal <g_kowal@poczta.onet.pl>
495 Zbigniew Chyla <cyba@gnome.pl>
496 Emil Nowak <emil5@go2.pl>
497 Wit Wilinski <wit.wilinski@gmail.com>
498 for Polish translation
500 Christopher R. Gabriel <cgabriel@pluto.linux.it>
501 Di Maggio Salvatore <Salvatore.Dimaggio@bologna.marelli.it>
502 Costantino <inverness1ATvirgilio.it>
503 for Italian translation
505 Sandokan <cortex@nextra.sk>
506 Ivan Priesol <priesol@iris-sk.sk>
507 Mgr. Peter Tuharsky <tuharsky@misbb.sk>
508 for Slovak translation
510 Rodrigo Sancho Senosiain <ruy_ikari@bigfoot.com>
511 Ariel Fermani <the_end@bbs.frc.utn.edu.ar>
512 for Spanish translation
514 Laurent Monin <i18n@norz.org>
515 Eric Lassauge <lassauge@users.sf.net>
516 Jean-Pierre Pedron <jppedron@club-internet.fr>
517 Pascal Bleser <pascal.bleser@atosorigin.com>
518 Nicolas Boos <nicolas.boos@wanadoo.fr>
519 Nicolas Bonifas <nicolas_bonifas@users.sf.net>
520 for French translation
522 Fâtih Demir <kabalak@gmx.net>
523 for Turkish translation
525 Kam Tik <kamtik@hongkong.com>
526 Abel Cheung <deaddog@deaddog.ws>
527 S.J. Luo <crystal@mickey.ee.nctu.edu.tw>
528 for Traditional Chinese (Big5) translation
530 Junichi Uekawa <dancer@debian.org>
531 Oleg Andrjushenko <oandr@itec.cn.ua>
532 Michael Bravo <mbravo@tag-ltd.spb.ru>
533 Sergey Pinaev <dfo@antex.ru>
534 for Russian translation
536 Guilherme M. Schroeder <slump@ieg.com.br>
537 Vitor Fernandes <vitor_fernandes@SoftHome.net>
538 Herval Ribeiro de Azevêdo <heraze@gmail.com>
539 for Brazilian Portuguese translation
541 Shingo Akagaki <akagaki@ece.numazu-ct.ac.jp>
542 Yuuki Ninomiya <gm@debian.or.jp>
543 Sato Satoru <ss@gnome.gr.jp>
544 Takeshi AIHANA <aihana@gnome.gr.jp>
545 for Japanese translation
547 Matthias Warkus <mawarkus@t-online.de>
548 Thomas Klausner <wiz@danbala.ifoer.tuwien.ac.at>
549 Danny Milosavljevic <danny_milo@yahoo.com>
550 Ronny Steiner <Post@SIRSteiner.de>
551 for German translation
553 Matej Erman <matej.erman@guest.arnes.si>
554 for Slovene translation
556 MÃtyÃs Tibor <templar@tempi.scene.hu>
557 Koblinger Egmont <egmont@uhulinux.hu>
558 Sári Gábor <saga@externet.hu>
559 for Hungarian translation
561 Wu Yulun <migr@operamail.com>
562 Charles Wang <charlesw1234cn@yahoo.com.cn>
563 for simplified Chinese translation
565 H.J.Visser <H.J.Visser@harrie.mine.nu>
566 Tino Meinen <a.t.meinen@chello.nl>
567 for Dutch translation
569 Lauri Nurmi <lanurmi@iki.fi>
570 for Finnish translation
572 Ilmar Kerm <ikerm@hot.ee>
573 for Estonian translation
575 Volodymyr M. Lisivka <lvm@mystery.lviv.net>
576 for Ukrainian translation
578 Birger Langkjer <birger.langkjer@image.dk>
579 for Danish translation
581 Torgeir Ness Sundli <torgeir@mp3bil.no>
582 for Norwegian translation
584 Jan Raska <jan.raska@tiscali.cz>
585 Michal Bukovjan <bukm@centrum.cz>
586 for Czech translation
588 Phanumas Thanyaboon <maskung@hotmail.com>
591 Harald Ersch <hersch@romatsa.ro>
592 for Romanian translation
594 pclouds <pclouds@vnlinux.org>
595 for Vietnamese translation
597 Tedi Heriyanto <tedi_h@gmx.net>
598 for Indonesian translation
600 Vladimir Petrov <vladux@mail.bg>
601 for Bulgarian translation
603 Hans Öfverbeck <hans.ofverbeck@home.se>
604 for Swedish translation
606 Youssef Assad <youssef@devcabal.org>
607 for Arabic translation
609 catux.org <mecatxis@ya.com>
610 for Catalan translation
612 Hyun-Jin Moon <moonhyunjin@gmail.com
613 for Korean translation
615 Pavel Piatruk <berserker@neolocation.com>
616 for Belarusian translation
618 Piarres Beobide <pi@beobide.net>
619 for Basque translation
621 Antonio C. Codazzi <f_sophia@libero.it>
622 for Esperanto translation
624 Fixes, additions, and patches:
628 for initial Exif support.
630 Daniel M. German <dmgerman at uvic.ca>
631 for Canon raw image support.
634 for Fujifilm raw image support.
636 Diederen Damien <D.Diederen@student.ulg.ac.be>
637 for .xvpics thumbnail reading support.
639 Nick Rusnov <nick@grawk.net>
640 Ryan Murray <rmurray@debian.org>
643 Martin Pool <mbp@samba.org>
644 for sort by number, misc. improvements.
646 Jörg Mensmann <joerg.mensmann@gmx.de>
647 for Xinerama support patch.
650 for miscellaneous fixes.
653 for Exif enhancements, histogram and other patches
656 for customizable fullscreen overlay
659 for print related enhancements
662 for copy path to clipboard patch
665 Thanks to the users for finding Geeqie useful.
668 ======== Translation status:
670 Please send po files/patches in gzipped form to ensure data integrity.
672 Translations statistics
673 Date: Sun, 11 May 2008 12:03:37 +0200
675 Note: completion % in the chart below may not be quite correct
676 when fuzzy translations exist but do not appear in the source.
677 For exact results, run make update-po with up to date POTFILES.in.
678 comp % = trans / (trans + fuzzy + untrans)
680 Language Comp(%) Trans Fuzzy Untrans Total
681 fr 100.00 985 0 0 985
682 be 90.56 892 25 68 985
683 eu 68.53 675 150 160 985
684 eo 68.22 672 153 160 985
685 vi 68.02 670 156 159 985
686 it 67.82 668 154 163 985
687 pt_BR 67.82 668 154 163 985
688 zh_TW 66.90 659 150 176 985
689 sk 66.50 655 158 172 985
690 fi 64.37 634 176 175 985
691 nl 64.37 634 179 172 985
692 sv 64.16 632 175 178 985
693 bg 64.06 631 175 179 985
694 ca 64.06 631 175 179 985
695 cs 64.06 631 175 179 985
696 de 64.06 631 175 179 985
697 es 64.06 631 175 179 985
698 ja 64.06 631 175 179 985
699 ru 64.06 631 175 179 985
700 pl 60.61 597 148 240 985
701 ar 42.94 423 315 247 985
702 ro 37.56 370 342 273 985
703 hu 36.14 356 332 297 985
704 id 19.70 194 408 383 985
705 et 19.29 190 407 388 985
706 uk 17.16 169 411 405 985
707 nb 15.94 157 416 412 985
708 zh_CN.GB2312 15.94 157 416 412 985
709 th 15.13 149 413 423 985
710 sl 14.72 145 419 421 985
711 da 12.99 128 402 455 985
712 ko 11.37 112 52 821 985
713 tr 6.60 65 398 522 985