1 ###################################################################
4 ## Copyright (C) 2008 - 2010 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')
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.
108 ======== Documentation (brief) [section:documentation]
110 This sections lists default hotkeys. Most of the hotkeys can be redefined
111 in the Preferences dialog.
114 [PageDown], [Keypad PageDown] next image
115 [PageUp], [Keypad PageUp] previous image
116 [Home], [Keypad Home] first image in list
117 [End], [Keypad End] last image in list
118 [Tab] tab completion in path entry window
119 [Escape] cancel completion in path entry window
121 Keyboard commands valid when image has focus (image has black rectangle)
122 arrow keys, [Keypad arrows] pan image
123 [Shift] - arrow keys pan image faster
125 [Backspace] , B previous image
128 [Ctrl] - N new window
129 C new empty collection
131 D open a Find Duplicates window
132 [Shift]- P open Print dialog
133 [Ctrl] - F new folder
136 [Ctrl] - R rename file
137 [Ctrl] - D, [Delete] delete file
138 [Ctrl] - W close window
139 [Ctrl] - Q exit Geeqie
143 [Ctrl] - 1..6 select mark
144 [Ctrl] - A select all files
145 [Ctrl] - [Shift] - A unselect all files
146 [Ctrl] - P display image properties window
147 [Ctrl] - O configure Options
148 ] rotate image clockwise
149 [ rotate image counterclockwise
150 [Shift] - R rotate image 180 degrees
151 [Shift] - M mirror image (horizontal)
152 [Shift] - F flip image (vertical)
153 [Shift] - G grayscale image
156 +, =, [Keypad +] zoom in
157 -, [Keypad -] zoom out
158 Z, [Keypad /] zoom to original size
159 X, [Keypad *] zoom to fit within window
160 W zoom to fit width of window
161 H zoom to fit height of window
162 T toggle thumbnails in list view
163 [Ctrl] - L display files as list view
164 [Ctrl] - I display files as icon view
165 [Ctrl] - T toggle tree view of directories
167 L (Un)float file selection area
168 [ctrl] - H (Un)hide file selection area
169 [Ctrl] - K toggle sidebar with EXIF or keywords
170 [Ctrl] - E show EXIF window
171 [Ctrl] - S toggle sort manager sidebar
172 F, V toggle full screen
174 P (Un)pause slideshow
175 [Ctrl] - V display current image in new window
179 arrows, [Keypad arrows] move selection
180 [Shift] + arrows select multiple images
181 [Ctrl] + arrows move without changing selection
182 [Space] select only image with focus
183 [Ctrl] + [Space] toggle selection of image with focus
184 [Home], [Keypad Home] move focus to top of images
185 [End], [Keypad End] move focus to end of images
186 (shift and ctrl work with Home, End, PageUp/Down as with arrows)
187 [Ctrl] - A select all images
188 [Ctrl] - [Shift] - A unselect all images
190 [Delete], [Keypad Delete] remove selected images from collection
191 (does not delete file)
192 [Ctrl] - L add images from main window file list
194 [Ctrl] - T toggle display of icon filename text
196 N sort collection by name
197 D sort collection by date
198 B sort collection by size (bytes)
199 P sort collection by location (path)
200 I (*) sort collection by name numerically
201 (file1 file10 file2 -> file1 file2 file10)
203 [Enter], [Keypad Enter] view image with focus in main window
204 V view image with focus in new window
207 [Ctrl] - S save collection as...
208 A append to collection...
210 [Shift] - P print selected images...
212 [Ctrl] - C copy selected files...
213 [Ctrl] - M move selected files...
214 [Ctrl] - R rename selected files...
215 [Ctrl] - D delete selected files
217 [Ctrl] - P display image properties window
219 [Ctrl] - W close window
221 Find Duplicates window:
223 [Ctrl] - A select all images
224 [Ctrl] - [Shift] - A unselect all images
225 1 select group 1 duplicates
226 2 select group 2 duplicates
228 [Ctrl] - L add images from main window file list
229 C add selected images to new collection
231 [Delete], [Keypad Delete] remove selected images from list
232 [Ctrl] - [Delete] clear window
234 [Enter], [Keypad Enter] view image with focus in main window
235 V view image with focus in new window
236 [Ctrl] - 1 .. 0 open selected image(s) in editor
238 [Ctrl] - C copy selected files...
239 [Ctrl] - M move selected files...
240 [Ctrl] - R rename selected files...
241 [Ctrl] - D delete selected files
243 [Ctrl] - P display image properties window
245 [Ctrl] - W close window
249 [Ctrl] - F, / show search bar
250 [Ctrl] - G repeat previous search
252 (*) This is a compile time option enabled when strverscmp is found.
256 Button 1 view next image
257 Button 2 view previous image
258 Button 3 context menu
260 Button 1 drag scroll/pan image
261 Button 2 drag initiate drag and drop
263 Wheel up/down change to previous/next image
264 Wheel up/down + [Shift] scroll image up/down
265 Wheel up/down + [Control] zoom image in/out
268 ======== Editor command macros [section:editors]
270 Editors are configured via standard desktop files, see
271 https://sourceforge.net/apps/trac/geeqie/wiki/GuideEditorsConfig
274 ======== Overlay Info [section:overlay]
276 Overlay info format string syntax is: %tag[:max_length][:extra]%
278 %name% Filename of the picture.
279 %collection% Name of the collection
280 %number% Current number of image in the list
281 %total% Total number of images
285 %height% Image height
286 %res% Image resolution
287 %keywords% Image keywords from metadata
288 %comment% Image comment from metadata
290 To access exif data use the exif name:
291 %Exif.Photo.DateTimeOriginal% Date of the original shot
293 Pre-formatted exif data is also available:
294 formatted.Camera Camera and sofware name
295 formatted.DateTime Image Date
296 formatted.ShutterSpeed Shutter speed in seconds (ie. 1/60s)
297 formatted.Aperture Aperture (ie. f5.6)
298 formatted.ExposureBias Exposure bias (ie. +0.3)
299 formatted.ISOSpeedRating ISO sensitivity (ie. 100)
300 formatted.FocalLength Focal length
301 formatted.FocalLength35mmFilm Focal length 35mm
302 formatted.SubjectDistance Subject distance
303 formatted.Flash Flash
304 formatted.Resolution Resolution
305 formatted.ColorProfile Color profile
306 formatted.GPSPosition GPS position
307 formatted.GPSAltitude GPS altitude
309 You can limit the length of displayed data using :number notation:
310 %formatted.Camera:20% will truncate the displayed data to 20 characters
311 and will add 3 dots at the end to denote the truncation.
313 If two or more variables are connected with the |-sign, it prints available
314 variables with a separator:
315 %formatted.ShutterSpeed%|%formatted.ISOSpeedRating%|%formatted.FocalLength%
317 "1/20s - 400 - 80 mm"
319 "1/200 - 80 mm" if there's no ISO information in the Exif data.
321 If a line is empty, it is removed.
322 This allows to add lines that totally disappear when no data is available.
324 Extra string uses special character '*' to mark the position of the data.
325 If no '*' is present, then extra string is just appended to data.
326 Any "\n" is replaced by a newline on display.
327 Pango mark up is accepted in left and right parts.
328 If data is empty, nothing will be displayed.
331 "%name:<i>*</i>\n%" -> name is displayed in italics ended with a newline
332 "%size:\n%" -> size is displayed with a newline at end
333 "%formatted.ISOSpeedRating:ISO *%" -> ie. "ISO 100"
334 "Collection <b>*</b>\n" -> display collection name in bold prefixed by
335 "Collection " and a newline is appended
338 ======== Credits [section:credits]
343 Grzegorz Kowal <g_kowal@poczta.onet.pl>
344 Zbigniew Chyla <cyba@gnome.pl>
345 Emil Nowak <emil5@go2.pl>
346 Wit Wilinski <wit.wilinski@gmail.com>
347 for Polish translation
349 Christopher R. Gabriel <cgabriel@pluto.linux.it>
350 Di Maggio Salvatore <Salvatore.Dimaggio@bologna.marelli.it>
351 Costantino <inverness1ATvirgilio.it>
352 for Italian translation
354 Sandokan <cortex@nextra.sk>
355 Ivan Priesol <priesol@iris-sk.sk>
356 Mgr. Peter Tuharsky <tuharsky@misbb.sk>
357 for Slovak translation
359 Rodrigo Sancho Senosiain <ruy_ikari@bigfoot.com>
360 Ariel Fermani <the_end@bbs.frc.utn.edu.ar>
361 for Spanish translation
363 Laurent Monin <i18n@norz.org>
364 Eric Lassauge <lassauge@users.sf.net>
365 Jean-Pierre Pedron <jppedron@club-internet.fr>
366 Pascal Bleser <pascal.bleser@atosorigin.com>
367 Nicolas Boos <nicolas.boos@wanadoo.fr>
368 Nicolas Bonifas <nicolas_bonifas@users.sf.net>
369 for French translation
371 Fâtih Demir <kabalak@gmx.net>
372 for Turkish translation
374 Kam Tik <kamtik@hongkong.com>
375 Abel Cheung <deaddog@deaddog.ws>
376 S.J. Luo <crystal@mickey.ee.nctu.edu.tw>
377 for Traditional Chinese (Big5) translation
379 Junichi Uekawa <dancer@debian.org>
380 Oleg Andrjushenko <oandr@itec.cn.ua>
381 Michael Bravo <mbravo@tag-ltd.spb.ru>
382 Sergey Pinaev <dfo@antex.ru>
383 for Russian translation
385 Guilherme M. Schroeder <slump@ieg.com.br>
386 Vitor Fernandes <vitor_fernandes@SoftHome.net>
387 Herval Ribeiro de Azevêdo <heraze@gmail.com>
388 for Brazilian Portuguese translation
390 Shingo Akagaki <akagaki@ece.numazu-ct.ac.jp>
391 Yuuki Ninomiya <gm@debian.or.jp>
392 Sato Satoru <ss@gnome.gr.jp>
393 Takeshi AIHANA <aihana@gnome.gr.jp>
394 for Japanese translation
396 Matthias Warkus <mawarkus@t-online.de>
397 Thomas Klausner <wiz@danbala.ifoer.tuwien.ac.at>
398 Danny Milosavljevic <danny_milo@yahoo.com>
399 Ronny Steiner <Post@SIRSteiner.de>
400 Klaus Ethgen <Klaus@Ethgen.de>
401 for German translation
403 Matej Erman <matej.erman@guest.arnes.si>
404 for Slovene translation
406 MÃtyÃs Tibor <templar@tempi.scene.hu>
407 Koblinger Egmont <egmont@uhulinux.hu>
408 Sári Gábor <saga@externet.hu>
409 for Hungarian translation
411 Wu Yulun <migr@operamail.com>
412 Charles Wang <charlesw1234cn@yahoo.com.cn>
413 for simplified Chinese translation
415 H.J.Visser <H.J.Visser@harrie.mine.nu>
416 Tino Meinen <a.t.meinen@chello.nl>
417 for Dutch translation
419 Lauri Nurmi <lanurmi@iki.fi>
420 for Finnish translation
422 Ilmar Kerm <ikerm@hot.ee>
423 for Estonian translation
425 Volodymyr M. Lisivka <lvm@mystery.lviv.net>
426 for Ukrainian translation
428 Birger Langkjer <birger.langkjer@image.dk>
429 for Danish translation
431 Torgeir Ness Sundli <torgeir@mp3bil.no>
432 for Norwegian translation
434 Jan Raska <jan.raska@tiscali.cz>
435 Michal Bukovjan <bukm@centrum.cz>
436 for Czech translation
438 Phanumas Thanyaboon <maskung@hotmail.com>
441 Harald Ersch <hersch@romatsa.ro>
442 for Romanian translation
444 pclouds <pclouds@vnlinux.org>
445 for Vietnamese translation
447 Tedi Heriyanto <tedi_h@gmx.net>
448 for Indonesian translation
450 Vladimir Petrov <vladux@mail.bg>
451 for Bulgarian translation
453 Hans Öfverbeck <hans.ofverbeck@home.se>
454 for Swedish translation
456 Youssef Assad <youssef@devcabal.org>
457 for Arabic translation
459 catux.org <mecatxis@ya.com>
460 for Catalan translation
462 Hyun-Jin Moon <moonhyunjin@gmail.com
463 for Korean translation
465 Pavel Piatruk <berserker@neolocation.com>
466 for Belarusian translation
468 Piarres Beobide <pi@beobide.net>
469 for Basque translation
471 Antonio C. Codazzi <f_sophia@libero.it>
472 for Esperanto translation
474 Fixes, additions, and patches:
478 for initial Exif support.
480 Daniel M. German <dmgerman at uvic.ca>
481 for Canon raw image support.
484 for Fujifilm raw image support.
486 Diederen Damien <D.Diederen@student.ulg.ac.be>
487 for .xvpics thumbnail reading support.
489 Nick Rusnov <nick@grawk.net>
490 Ryan Murray <rmurray@debian.org>
493 Martin Pool <mbp@samba.org>
494 for sort by number, misc. improvements.
496 Jörg Mensmann <joerg.mensmann@gmx.de>
497 for Xinerama support patch.
500 for miscellaneous fixes.
503 for Exif enhancements, histogram and other patches
506 for customizable fullscreen overlay
509 for print related enhancements
512 for copy path to clipboard patch
515 for random slide show speedup patch
517 Klaus Ethgen <Klaus@Ethgen.de>
518 for GPS integration, Search enhancement and other patches
521 Thanks to the users for finding Geeqie useful.