1 ###################################################################
4 ## Copyright (C) 2008 - 2012 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 considered stable.
21 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.20: 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 - due to fast development, newer versions work significantly better
59 FIXME: minimal version ?
60 lirc, for remote control support: http://www.lirc.org/
61 (disable with configure option: '--disable-lirc')
62 libchamplain - experimental map support, dissabled by default
63 http://projects.gnome.org/libchamplain/
64 WARNING: this library has a lot of dependencise
66 ======== Notes and changes for this release [section:release_notes]
68 See http://geeqie.wiki.sourceforge.net/new_features
73 If you plan on making any major changes to the code that will be offered
74 for inclusion to the main source, please contact us first - so that we
75 can avoid duplication of effort.
80 see the Geeqie Bug Tracker at TODO file.
84 Compilation: ./configure ; make
85 General install: make install
86 Removal: make uninstall
88 ======== Description / Features
90 Geeqie is a graphics file viewer. Basic features:
92 - Single click image viewing / navigation.
94 - Thumbnails, with optional caching and .xvpics support.
95 - Multiple file selection for move, copy, delete, rename, drag and drop.
99 - Ability to open images in external editors (configurable).
101 - Comparison of images to find duplicates by name, size, date,
102 dimensions, or image content similarity.
106 - support for stereoscopic images
107 - input: side-by-side (JPS) and MPO format
108 - output: single image, anaglyph, SBS, mirror, SBS half size (3DTV)
110 ======== Documentation (brief) [section:documentation]
112 This sections lists default hotkeys. Most of the hotkeys can be redefined
113 in the Preferences dialog.
116 [PageDown], [Keypad PageDown] next image
117 [PageUp], [Keypad PageUp] previous image
118 [Home], [Keypad Home] first image in list
119 [End], [Keypad End] last image in list
120 [Tab] tab completion in path entry window
121 [Escape] cancel completion in path entry window
123 Keyboard commands valid when image has focus (image has black rectangle)
124 arrow keys, [Keypad arrows] pan image
125 [Shift] - arrow keys pan image faster
127 [Backspace] , B previous image
130 [Ctrl] - N new window
131 C new empty collection
133 D open a Find Duplicates window
134 [Shift]- P open Print dialog
135 [Ctrl] - F new folder
138 [Ctrl] - R rename file
139 [Ctrl] - D, [Delete] delete file
140 [Ctrl] - W close window
141 [Ctrl] - Q exit Geeqie
145 [Ctrl] - 1..6 select mark
146 [Ctrl] - A select all files
147 [Ctrl] - [Shift] - A unselect all files
148 [Ctrl] - P display image properties window
149 [Ctrl] - O configure Options
150 ] rotate image clockwise
151 [ rotate image counterclockwise
152 [Shift] - R rotate image 180 degrees
153 [Shift] - M mirror image (horizontal)
154 [Shift] - F flip image (vertical)
155 [Shift] - G grayscale image
158 +, =, [Keypad +] zoom in
159 -, [Keypad -] zoom out
160 Z, [Keypad /] zoom to original size
161 X, [Keypad *] zoom to fit within window
162 W zoom to fit width of window
163 H zoom to fit height of window
164 T toggle thumbnails in list view
165 [Ctrl] - L display files as list view
166 [Ctrl] - I display files as icon view
167 [Ctrl] - T toggle tree view of directories
169 L (Un)float file selection area
170 [ctrl] - H (Un)hide file selection area
171 [Ctrl] - K toggle sidebar with EXIF or keywords
172 [Ctrl] - E show EXIF window
173 [Ctrl] - S toggle sort manager sidebar
174 F, V toggle full screen
176 P (Un)pause slideshow
177 [Ctrl] - V display current image in new window
181 arrows, [Keypad arrows] move selection
182 [Shift] + arrows select multiple images
183 [Ctrl] + arrows move without changing selection
184 [Space] select only image with focus
185 [Ctrl] + [Space] toggle selection of image with focus
186 [Home], [Keypad Home] move focus to top of images
187 [End], [Keypad End] move focus to end of images
188 (shift and ctrl work with Home, End, PageUp/Down as with arrows)
189 [Ctrl] - A select all images
190 [Ctrl] - [Shift] - A unselect all images
192 [Delete], [Keypad Delete] remove selected images from collection
193 (does not delete file)
194 [Ctrl] - L add images from main window file list
196 [Ctrl] - T toggle display of icon filename text
198 N sort collection by name
199 D sort collection by date
200 B sort collection by size (bytes)
201 P sort collection by location (path)
202 I (*) sort collection by name numerically
203 (file1 file10 file2 -> file1 file2 file10)
205 [Enter], [Keypad Enter] view image with focus in main window
206 V view image with focus in new window
209 [Ctrl] - S save collection as...
210 A append to collection...
212 [Shift] - P print selected images...
214 [Ctrl] - C copy selected files...
215 [Ctrl] - M move selected files...
216 [Ctrl] - R rename selected files...
217 [Ctrl] - D delete selected files
219 [Ctrl] - P display image properties window
221 [Ctrl] - W close window
223 Find Duplicates window:
225 [Ctrl] - A select all images
226 [Ctrl] - [Shift] - A unselect all images
227 1 select group 1 duplicates
228 2 select group 2 duplicates
230 [Ctrl] - L add images from main window file list
231 C add selected images to new collection
233 [Delete], [Keypad Delete] remove selected images from list
234 [Ctrl] - [Delete] clear window
236 [Enter], [Keypad Enter] view image with focus in main window
237 V view image with focus in new window
238 [Ctrl] - 1 .. 0 open selected image(s) in editor
240 [Ctrl] - C copy selected files...
241 [Ctrl] - M move selected files...
242 [Ctrl] - R rename selected files...
243 [Ctrl] - D delete selected files
245 [Ctrl] - P display image properties window
247 [Ctrl] - W close window
251 [Ctrl] - F, / show search bar
252 [Ctrl] - G repeat previous search
254 (*) This is a compile time option enabled when strverscmp is found.
258 Button 1 view next image
259 Button 2 view previous image
260 Button 3 context menu
262 Button 1 drag scroll/pan image
263 Button 2 drag initiate drag and drop
265 Wheel up/down change to previous/next image
266 Wheel up/down + [Shift] scroll image up/down
267 Wheel up/down + [Control] zoom image in/out
270 ======== Editor command macros [section:editors]
272 Editors are configured via standard desktop files, see
273 https://sourceforge.net/apps/trac/geeqie/wiki/GuideEditorsConfig
276 ======== Overlay Info [section:overlay]
278 Overlay info format string syntax is: %tag[:max_length][:extra]%
280 %name% Filename of the picture.
281 %collection% Name of the collection
282 %number% Current number of image in the list
283 %total% Total number of images
287 %height% Image height
288 %res% Image resolution
289 %keywords% Image keywords from metadata
290 %comment% Image comment from metadata
292 To access exif data use the exif name:
293 %Exif.Photo.DateTimeOriginal% Date of the original shot
295 Pre-formatted exif data is also available:
296 formatted.Camera Camera and sofware name
297 formatted.DateTime Image Date
298 formatted.ShutterSpeed Shutter speed in seconds (ie. 1/60s)
299 formatted.Aperture Aperture (ie. f5.6)
300 formatted.ExposureBias Exposure bias (ie. +0.3)
301 formatted.ISOSpeedRating ISO sensitivity (ie. 100)
302 formatted.FocalLength Focal length
303 formatted.FocalLength35mmFilm Focal length 35mm
304 formatted.SubjectDistance Subject distance
305 formatted.Flash Flash
306 formatted.Resolution Resolution
307 formatted.ColorProfile Color profile
308 formatted.GPSPosition GPS position
309 formatted.GPSAltitude GPS altitude
311 You can limit the length of displayed data using :number notation:
312 %formatted.Camera:20% will truncate the displayed data to 20 characters
313 and will add 3 dots at the end to denote the truncation.
315 If two or more variables are connected with the |-sign, it prints available
316 variables with a separator:
317 %formatted.ShutterSpeed%|%formatted.ISOSpeedRating%|%formatted.FocalLength%
319 "1/20s - 400 - 80 mm"
321 "1/200 - 80 mm" if there's no ISO information in the Exif data.
323 If a line is empty, it is removed.
324 This allows one to add lines that totally disappear when no data is available.
326 Extra string uses special character '*' to mark the position of the data.
327 If no '*' is present, then extra string is just appended to data.
328 Any "\n" is replaced by a newline on display.
329 Pango mark up is accepted in left and right parts.
330 If data is empty, nothing will be displayed.
333 "%name:<i>*</i>\n%" -> name is displayed in italics ended with a newline
334 "%size:\n%" -> size is displayed with a newline at end
335 "%formatted.ISOSpeedRating:ISO *%" -> ie. "ISO 100"
336 "Collection <b>*</b>\n" -> display collection name in bold prefixed by
337 "Collection " and a newline is appended
340 ======== Credits [section:credits]
345 Grzegorz Kowal <g_kowal@poczta.onet.pl>
346 Zbigniew Chyla <cyba@gnome.pl>
347 Emil Nowak <emil5@go2.pl>
348 Wit Wilinski <wit.wilinski@gmail.com>
349 for Polish translation
351 Christopher R. Gabriel <cgabriel@pluto.linux.it>
352 Di Maggio Salvatore <Salvatore.Dimaggio@bologna.marelli.it>
353 Costantino <inverness1ATvirgilio.it>
354 for Italian translation
356 Sandokan <cortex@nextra.sk>
357 Ivan Priesol <priesol@iris-sk.sk>
358 Mgr. Peter Tuharsky <tuharsky@misbb.sk>
359 for Slovak translation
361 Rodrigo Sancho Senosiain <ruy_ikari@bigfoot.com>
362 Ariel Fermani <the_end@bbs.frc.utn.edu.ar>
363 for Spanish translation
365 Laurent Monin <i18n@norz.org>
366 Eric Lassauge <lassauge@users.sf.net>
367 Jean-Pierre Pedron <jppedron@club-internet.fr>
368 Pascal Bleser <pascal.bleser@atosorigin.com>
369 Nicolas Boos <nicolas.boos@wanadoo.fr>
370 Nicolas Bonifas <nicolas_bonifas@users.sf.net>
371 for French translation
373 Fâtih Demir <kabalak@gmx.net>
374 for Turkish translation
376 Kam Tik <kamtik@hongkong.com>
377 Abel Cheung <deaddog@deaddog.ws>
378 S.J. Luo <crystal@mickey.ee.nctu.edu.tw>
379 for Traditional Chinese (Big5) translation
381 Junichi Uekawa <dancer@debian.org>
382 Oleg Andrjushenko <oandr@itec.cn.ua>
383 Michael Bravo <mbravo@tag-ltd.spb.ru>
384 Sergey Pinaev <dfo@antex.ru>
385 for Russian translation
387 Guilherme M. Schroeder <slump@ieg.com.br>
388 Vitor Fernandes <vitor_fernandes@SoftHome.net>
389 Herval Ribeiro de Azevêdo <heraze@gmail.com>
390 for Brazilian Portuguese translation
392 Shingo Akagaki <akagaki@ece.numazu-ct.ac.jp>
393 Yuuki Ninomiya <gm@debian.or.jp>
394 Sato Satoru <ss@gnome.gr.jp>
395 Takeshi AIHANA <aihana@gnome.gr.jp>
396 for Japanese translation
398 Matthias Warkus <mawarkus@t-online.de>
399 Thomas Klausner <wiz@danbala.ifoer.tuwien.ac.at>
400 Danny Milosavljevic <danny_milo@yahoo.com>
401 Ronny Steiner <Post@SIRSteiner.de>
402 Klaus Ethgen <Klaus@Ethgen.de>
403 for German translation
405 Matej Erman <matej.erman@guest.arnes.si>
406 for Slovene translation
408 MÃtyÃs Tibor <templar@tempi.scene.hu>
409 Koblinger Egmont <egmont@uhulinux.hu>
410 Sári Gábor <saga@externet.hu>
411 for Hungarian translation
413 Wu Yulun <migr@operamail.com>
414 Charles Wang <charlesw1234cn@yahoo.com.cn>
415 for simplified Chinese translation
417 H.J.Visser <H.J.Visser@harrie.mine.nu>
418 Tino Meinen <a.t.meinen@chello.nl>
419 for Dutch translation
421 Lauri Nurmi <lanurmi@iki.fi>
422 for Finnish translation
424 Ilmar Kerm <ikerm@hot.ee>
425 for Estonian translation
427 Volodymyr M. Lisivka <lvm@mystery.lviv.net>
428 for Ukrainian translation
430 Birger Langkjer <birger.langkjer@image.dk>
431 for Danish translation
433 Torgeir Ness Sundli <torgeir@mp3bil.no>
434 for Norwegian translation
436 Jan Raska <jan.raska@tiscali.cz>
437 Michal Bukovjan <bukm@centrum.cz>
438 for Czech translation
440 Phanumas Thanyaboon <maskung@hotmail.com>
443 Harald Ersch <hersch@romatsa.ro>
444 for Romanian translation
446 pclouds <pclouds@vnlinux.org>
447 for Vietnamese translation
449 Tedi Heriyanto <tedi_h@gmx.net>
450 for Indonesian translation
452 Vladimir Petrov <vladux@mail.bg>
453 for Bulgarian translation
455 Hans Öfverbeck <hans.ofverbeck@home.se>
456 for Swedish translation
458 Youssef Assad <youssef@devcabal.org>
459 for Arabic translation
461 catux.org <mecatxis@ya.com>
462 for Catalan translation
464 Hyun-Jin Moon <moonhyunjin@gmail.com
465 for Korean translation
467 Pavel Piatruk <berserker@neolocation.com>
468 for Belarusian translation
470 Piarres Beobide <pi@beobide.net>
471 for Basque translation
473 Antonio C. Codazzi <f_sophia@libero.it>
474 for Esperanto translation
476 Fixes, additions, and patches:
480 for initial Exif support.
482 Daniel M. German <dmgerman at uvic.ca>
483 for Canon raw image support.
486 for Fujifilm raw image support.
488 Diederen Damien <D.Diederen@student.ulg.ac.be>
489 for .xvpics thumbnail reading support.
491 Nick Rusnov <nick@grawk.net>
492 Ryan Murray <rmurray@debian.org>
495 Martin Pool <mbp@samba.org>
496 for sort by number, misc. improvements.
498 Jörg Mensmann <joerg.mensmann@gmx.de>
499 for Xinerama support patch.
502 for miscellaneous fixes.
505 for Exif enhancements, histogram and other patches
508 for customizable fullscreen overlay
511 for print related enhancements
514 for copy path to clipboard patch
517 for random slide show speedup patch
519 Klaus Ethgen <Klaus@Ethgen.de>
520 for GPS integration, Search enhancement and other patches
523 Thanks to the users for finding Geeqie useful.