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