###################################################################
-## GQview 0.8.1 (04/14/2000) ##
-## This software is Copyright (C) 2000 by John Ellis. ##
-## Use this software at your own risk. I am not responsible for ##
-## anything this software may do to your computer. ##
-## This software falls under the GNU Public License. Please read ##
-## the COPYING file for more information ##
+## Geeqie 1.1 ##
+## ##
+## Copyright (C) 2008 - 2012 The Geeqie Team ##
+## Copyright (C) 1999 - 2006 John Ellis. ##
+## ##
+## Use at your own risk! ##
+## ##
+## This software released under the GNU General Public License. ##
+## Please read the COPYING file for more information. ##
###################################################################
-Author: John Ellis
-e-mail: gqview@email.com
-homepage: gqview.sourceforge.net
- gqview.netpedia.net (site just has a link back to above)
+This is Geeqie, a successor of GQview.
+
+Geeqie has been forked from GQview project, because it was not
+possible to contact gqview author and the only maintainer.
+Geeqie projects goal is to move the development forward and
+also integrate the existing patches.
+
+Geeqie is currently considered stable.
+Please report any crash or odd behavior to the bugtracker:
+https://sourceforge.net/tracker/?group_id=222125&atid=1054680
+
+For more info see:
+http://geeqie.sourceforge.net
+
+Vladimir Nadvornik
+Petr Ostadal
+
+Please send any question or suggestions to
+geeqie-devel@lists.sourceforge.net
+
+
+
+
+======== README contents:
+
+ * Requirements
+ * Notes and changes for this release
+ * Installation
+ * Description / Features
+ * Documentation (keyboard shortcuts)
+ * Editor command macros
+ * Additional comments
+ * Translation status
+ * Credits
======== Requirements
- GTK+-1.2.x: ftp://ftp.gtk.org/pub/gtk
- Imlib 1.9: ftp://ftp.labs.redhat.com/pub/imlib
+ Required libraries:
+ GTK+ 2.20: ftp://ftp.gtk.org/pub/gtk
+
+ Optional libraries:
+ lcms, for color management support: http://www.littlecms.com
+ (disable with configure option: '--without-lcms')
+ exiv2, for enhanced exif support: http://www.exiv2.org/
+ (disable with configure option: '--without-exiv2')
+ - due to fast development, newer versions work significantly better
+ FIXME: minimal version ?
+ lirc, for remote control support: http://www.lirc.org/
+ (disable with configure option: '--disable-lirc')
+ libchamplain - experimental map support, dissabled by default
+ http://projects.gnome.org/libchamplain/
+ WARNING: this library has a lot of dependencise
+
+======== Notes and changes for this release [section:release_notes]
+
+See http://geeqie.wiki.sourceforge.net/new_features
+
-======== Notes and changes for this release
+ Code hackers:
- Changes:
- > New translations for es, fr, sk, and updated tr.
- > Mouse wheel scrolls image, or optionally changes image
- next or back. (Wheel must be mapped to buttons 4 and 5)
- * Fix to include RPM spec file in source.
+ If you plan on making any major changes to the code that will be offered
+ for inclusion to the main source, please contact us first - so that we
+ can avoid duplication of effort.
+ The Geeqie Team
- Notes:
- bt_br.po is corrupt (my fault).
+ Known bugs:
+
+ see the Geeqie Bug Tracker at TODO file.
======== Installation
======== Description / Features
- GQview is a graphics file viewer. Basic features:
+ Geeqie is a graphics file viewer. Basic features:
+
- Single click image viewing / navigation.
- Zoom functions.
- Thumbnails, with optional caching and .xvpics support.
- Slideshow.
- Full screen.
- Ability to open images in external editors (configurable).
+ - Collections.
+ - Comparison of images to find duplicates by name, size, date,
+ dimensions, or image content similarity.
+ - EXIF support.
+
+ Geeqie 1.1:
+ - support for stereoscopic images
+ - input: side-by-side (JPS) and MPO format
+ - output: single image, anaglyph, SBS, mirror, SBS half size (3DTV)
-======== Documentation (brief)
+======== Documentation (brief) [section:documentation]
+
+This sections lists default hotkeys. Most of the hotkeys can be redefined
+in the Preferences dialog.
Keyboard commands:
- [PageDown] next image
- [PageUp] previous image
- [Home] first image in list
- [End] last image in list
+ [PageDown], [Keypad PageDown] next image
+ [PageUp], [Keypad PageUp] previous image
+ [Home], [Keypad Home] first image in list
+ [End], [Keypad End] last image in list
[Tab] tab completion in path entry window
- [Escape], cancel completion in path entry window
- [Escape] stop generating thumbnails
+ [Escape] cancel completion in path entry window
Keyboard commands valid when image has focus (image has black rectangle)
- arrow keys pan image
+ arrow keys, [Keypad arrows] pan image
[Shift] - arrow keys pan image faster
[Space] next image
- [Backspace] previous image
+ [Backspace] , B previous image
File menu related:
- [Ctrl] - N New directory
- [Ctrl] - C Copy file
- [Ctrl] - M Move file
- [Ctrl] - R Rename file
- [Ctrl] - D, [Delete] Delete file
- [Ctrl] - Q, Q Exit
+ [Ctrl] - N new window
+ C new empty collection
+ O open collection
+ D open a Find Duplicates window
+ [Shift]- P open Print dialog
+ [Ctrl] - F new folder
+ [Ctrl] - C copy file
+ [Ctrl] - M move file
+ [Ctrl] - R rename file
+ [Ctrl] - D, [Delete] delete file
+ [Ctrl] - W close window
+ [Ctrl] - Q exit Geeqie
Edit menu related:
- [Ctrl] - 1 .. 8 run external editor
+ 1 .. 6 toggle mark
+ [Ctrl] - 1..6 select mark
+ [Ctrl] - A select all files
+ [Ctrl] - [Shift] - A unselect all files
+ [Ctrl] - P display image properties window
[Ctrl] - O configure Options
- [Ctrl] - S Save options
- [Ctrl] - T Maintain thumbnails
+ ] rotate image clockwise
+ [ rotate image counterclockwise
+ [Shift] - R rotate image 180 degrees
+ [Shift] - M mirror image (horizontal)
+ [Shift] - F flip image (vertical)
+ [Shift] - G grayscale image
View menu related:
- +, = zoom in
- - zoom out
- Z zoom to original size
- X zoom to fit
- T toggle thumbnail display
+ +, =, [Keypad +] zoom in
+ -, [Keypad -] zoom out
+ Z, [Keypad /] zoom to original size
+ X, [Keypad *] zoom to fit within window
+ W zoom to fit width of window
+ H zoom to fit height of window
+ T toggle thumbnails in list view
+ [Ctrl] - L display files as list view
+ [Ctrl] - I display files as icon view
+ [Ctrl] - T toggle tree view of directories
R refresh list
- F (Un)float file selection area
- H (Un)hide file selection area
- V Toggle full screen
- S Toggle slide show
+ L (Un)float file selection area
+ [ctrl] - H (Un)hide file selection area
+ [Ctrl] - K toggle sidebar with EXIF or keywords
+ [Ctrl] - E show EXIF window
+ [Ctrl] - S toggle sort manager sidebar
+ F, V toggle full screen
+ S toggle slide show
+ P (Un)pause slideshow
+ [Ctrl] - V display current image in new window
+
+ Collection windows:
+
+ arrows, [Keypad arrows] move selection
+ [Shift] + arrows select multiple images
+ [Ctrl] + arrows move without changing selection
+ [Space] select only image with focus
+ [Ctrl] + [Space] toggle selection of image with focus
+ [Home], [Keypad Home] move focus to top of images
+ [End], [Keypad End] move focus to end of images
+ (shift and ctrl work with Home, End, PageUp/Down as with arrows)
+ [Ctrl] - A select all images
+ [Ctrl] - [Shift] - A unselect all images
+
+ [Delete], [Keypad Delete] remove selected images from collection
+ (does not delete file)
+ [Ctrl] - L add images from main window file list
+
+ [Ctrl] - T toggle display of icon filename text
+
+ N sort collection by name
+ D sort collection by date
+ B sort collection by size (bytes)
+ P sort collection by location (path)
+ I (*) sort collection by name numerically
+ (file1 file10 file2 -> file1 file2 file10)
+
+ [Enter], [Keypad Enter] view image with focus in main window
+ V view image with focus in new window
+
+ S save collection
+ [Ctrl] - S save collection as...
+ A append to collection...
+
+ [Shift] - P print selected images...
+
+ [Ctrl] - C copy selected files...
+ [Ctrl] - M move selected files...
+ [Ctrl] - R rename selected files...
+ [Ctrl] - D delete selected files
+
+ [Ctrl] - P display image properties window
+
+ [Ctrl] - W close window
+
+ Find Duplicates window:
+
+ [Ctrl] - A select all images
+ [Ctrl] - [Shift] - A unselect all images
+ 1 select group 1 duplicates
+ 2 select group 2 duplicates
+
+ [Ctrl] - L add images from main window file list
+ C add selected images to new collection
+
+ [Delete], [Keypad Delete] remove selected images from list
+ [Ctrl] - [Delete] clear window
+
+ [Enter], [Keypad Enter] view image with focus in main window
+ V view image with focus in new window
+ [Ctrl] - 1 .. 0 open selected image(s) in editor
+
+ [Ctrl] - C copy selected files...
+ [Ctrl] - M move selected files...
+ [Ctrl] - R rename selected files...
+ [Ctrl] - D delete selected files
+
+ [Ctrl] - P display image properties window
+
+ [Ctrl] - W close window
+
+ Pan View:
+
+ [Ctrl] - F, / show search bar
+ [Ctrl] - G repeat previous search
+
+ (*) This is a compile time option enabled when strverscmp is found.
+
+ Mouse image control:
-======== Thanks go to the following:
+ Button 1 view next image
+ Button 2 view previous image
+ Button 3 context menu
- Translations:
+ Button 1 drag scroll/pan image
+ Button 2 drag initiate drag and drop
- "Sandokan" <cortex@nextra.sk>
- for Slovak translation
+ Wheel up/down change to previous/next image
+ Wheel up/down + [Shift] scroll image up/down
+ Wheel up/down + [Control] zoom image in/out
+
+
+======== Editor command macros [section:editors]
+
+Editors are configured via standard desktop files, see
+https://sourceforge.net/apps/trac/geeqie/wiki/GuideEditorsConfig
- Rodrigo Sancho Senosiain <ruy_ikari@bigfoot.com>
- for Spanish translation
- Jean-pierre PEDRON <jppedron@club-internet.fr>
- for French translation
+======== Overlay Info [section:overlay]
- Fâtih Demir <kabalak@gmx.net>
- for Turkish translation
+Overlay info format string syntax is: %tag[:max_length][:extra]%
- Kam Tik <kamtik@hongkong.com>
- for Triditional Chinese (Big5) translation
+ %name% Filename of the picture.
+ %collection% Name of the collection
+ %number% Current number of image in the list
+ %total% Total number of images
+ %date% File date
+ %size% File size
+ %width% Image width
+ %height% Image height
+ %res% Image resolution
+ %keywords% Image keywords from metadata
+ %comment% Image comment from metadata
- Oleg Andrjushenko <oandr@itec.cn.ua>
- for Russian translation
+ To access exif data use the exif name:
+ %Exif.Photo.DateTimeOriginal% Date of the original shot
- Vitor Fernandes <vitor_fernandes@SoftHome.net>
- for Brazilian Portuguese translation
+ Pre-formatted exif data is also available:
+ formatted.Camera Camera and sofware name
+ formatted.DateTime Image Date
+ formatted.ShutterSpeed Shutter speed in seconds (ie. 1/60s)
+ formatted.Aperture Aperture (ie. f5.6)
+ formatted.ExposureBias Exposure bias (ie. +0.3)
+ formatted.ISOSpeedRating ISO sensitivity (ie. 100)
+ formatted.FocalLength Focal length
+ formatted.FocalLength35mmFilm Focal length 35mm
+ formatted.SubjectDistance Subject distance
+ formatted.Flash Flash
+ formatted.Resolution Resolution
+ formatted.ColorProfile Color profile
+ formatted.GPSPosition GPS position
+ formatted.GPSAltitude GPS altitude
+
+ You can limit the length of displayed data using :number notation:
+ %formatted.Camera:20% will truncate the displayed data to 20 characters
+ and will add 3 dots at the end to denote the truncation.
+
+ If two or more variables are connected with the |-sign, it prints available
+ variables with a separator:
+ %formatted.ShutterSpeed%|%formatted.ISOSpeedRating%|%formatted.FocalLength%
+ could show:
+ "1/20s - 400 - 80 mm"
+ or
+ "1/200 - 80 mm" if there's no ISO information in the Exif data.
+
+ If a line is empty, it is removed.
+ This allows one to add lines that totally disappear when no data is available.
+
+ Extra string uses special character '*' to mark the position of the data.
+ If no '*' is present, then extra string is just appended to data.
+ Any "\n" is replaced by a newline on display.
+ Pango mark up is accepted in left and right parts.
+ If data is empty, nothing will be displayed.
+
+ Examples:
+ "%name:<i>*</i>\n%" -> name is displayed in italics ended with a newline
+ "%size:\n%" -> size is displayed with a newline at end
+ "%formatted.ISOSpeedRating:ISO *%" -> ie. "ISO 100"
+ "%collection: Collection <b>*</b>\n%" -> display collection name in bold prefixed by
+ "Collection " and a newline is appended
- Shingo Akagaki <akagaki@ece.numazu-ct.ac.jp>a
- for Japanese translation
- Matthias Warkus <mawarkus@t-online.de>
- for German translation.
+======== Credits [section:credits]
+
+
+ Translations:
+
+ Grzegorz Kowal <g_kowal@poczta.onet.pl>
+ Zbigniew Chyla <cyba@gnome.pl>
+ Emil Nowak <emil5@go2.pl>
+ Wit Wilinski <wit.wilinski@gmail.com>
+ for Polish translation
+
+ Christopher R. Gabriel <cgabriel@pluto.linux.it>
+ Di Maggio Salvatore <Salvatore.Dimaggio@bologna.marelli.it>
+ Costantino <inverness1ATvirgilio.it>
+ for Italian translation
+
+ Sandokan <cortex@nextra.sk>
+ Ivan Priesol <priesol@iris-sk.sk>
+ Mgr. Peter Tuharsky <tuharsky@misbb.sk>
+ for Slovak translation
+
+ Rodrigo Sancho Senosiain <ruy_ikari@bigfoot.com>
+ Ariel Fermani <the_end@bbs.frc.utn.edu.ar>
+ for Spanish translation
+
+ Laurent Monin <i18n@norz.org>
+ Eric Lassauge <lassauge@users.sf.net>
+ Jean-Pierre Pedron <jppedron@club-internet.fr>
+ Pascal Bleser <pascal.bleser@atosorigin.com>
+ Nicolas Boos <nicolas.boos@wanadoo.fr>
+ Nicolas Bonifas <nicolas_bonifas@users.sf.net>
+ for French translation
+
+ Fâtih Demir <kabalak@gmx.net>
+ for Turkish translation
+
+ Kam Tik <kamtik@hongkong.com>
+ Abel Cheung <deaddog@deaddog.ws>
+ S.J. Luo <crystal@mickey.ee.nctu.edu.tw>
+ for Traditional Chinese (Big5) translation
+
+ Junichi Uekawa <dancer@debian.org>
+ Oleg Andrjushenko <oandr@itec.cn.ua>
+ Michael Bravo <mbravo@tag-ltd.spb.ru>
+ Sergey Pinaev <dfo@antex.ru>
+ for Russian translation
+
+ Guilherme M. Schroeder <slump@ieg.com.br>
+ Vitor Fernandes <vitor_fernandes@SoftHome.net>
+ Herval Ribeiro de Azevêdo <heraze@gmail.com>
+ for Brazilian Portuguese translation
+
+ Shingo Akagaki <akagaki@ece.numazu-ct.ac.jp>
+ Yuuki Ninomiya <gm@debian.or.jp>
+ Sato Satoru <ss@gnome.gr.jp>
+ Takeshi AIHANA <aihana@gnome.gr.jp>
+ for Japanese translation
+
+ Matthias Warkus <mawarkus@t-online.de>
+ Thomas Klausner <wiz@danbala.ifoer.tuwien.ac.at>
+ Danny Milosavljevic <danny_milo@yahoo.com>
+ Ronny Steiner <Post@SIRSteiner.de>
+ Klaus Ethgen <Klaus@Ethgen.de>
+ for German translation
+
+ Matej Erman <matej.erman@guest.arnes.si>
+ for Slovene translation
+
+ MÃtyÃs Tibor <templar@tempi.scene.hu>
+ Koblinger Egmont <egmont@uhulinux.hu>
+ Sári Gábor <saga@externet.hu>
+ for Hungarian translation
+
+ Wu Yulun <migr@operamail.com>
+ Charles Wang <charlesw1234cn@yahoo.com.cn>
+ for simplified Chinese translation
+
+ H.J.Visser <H.J.Visser@harrie.mine.nu>
+ Tino Meinen <a.t.meinen@chello.nl>
+ for Dutch translation
+
+ Lauri Nurmi <lanurmi@iki.fi>
+ for Finnish translation
+
+ Ilmar Kerm <ikerm@hot.ee>
+ for Estonian translation
+
+ Volodymyr M. Lisivka <lvm@mystery.lviv.net>
+ for Ukrainian translation
+
+ Birger Langkjer <birger.langkjer@image.dk>
+ for Danish translation
+
+ Torgeir Ness Sundli <torgeir@mp3bil.no>
+ for Norwegian translation
+
+ Jan Raska <jan.raska@tiscali.cz>
+ Michal Bukovjan <bukm@centrum.cz>
+ for Czech translation
+
+ Phanumas Thanyaboon <maskung@hotmail.com>
+ for Thai translation
+
+ Harald Ersch <hersch@romatsa.ro>
+ for Romanian translation
+
+ pclouds <pclouds@vnlinux.org>
+ for Vietnamese translation
+
+ Tedi Heriyanto <tedi_h@gmx.net>
+ for Indonesian translation
+
+ Vladimir Petrov <vladux@mail.bg>
+ for Bulgarian translation
+
+ Hans Öfverbeck <hans.ofverbeck@home.se>
+ for Swedish translation
+
+ Youssef Assad <youssef@devcabal.org>
+ for Arabic translation
+
+ catux.org <mecatxis@ya.com>
+ for Catalan translation
+
+ Hyun-Jin Moon <moonhyunjin@gmail.com
+ for Korean translation
+
+ Pavel Piatruk <berserker@neolocation.com>
+ for Belarusian translation
+
+ Piarres Beobide <pi@beobide.net>
+ for Basque translation
+
+ Antonio C. Codazzi <f_sophia@libero.it>
+ for Esperanto translation
Fixes, additions, and patches:
- Diederen Damien <D.Diederen@student.ulg.ac.be>
- for .xvpics thumbnail reading support.
+ Eric Swalens
+ Quy Tonthat
+ for initial Exif support.
+
+ Daniel M. German <dmgerman at uvic.ca>
+ for Canon raw image support.
+
+ Lars Ellenberg
+ for Fujifilm raw image support.
+
+ Diederen Damien <D.Diederen@student.ulg.ac.be>
+ for .xvpics thumbnail reading support.
+
+ Nick Rusnov <nick@grawk.net>
+ Ryan Murray <rmurray@debian.org>
+ for man page.
+
+ Martin Pool <mbp@samba.org>
+ for sort by number, misc. improvements.
+
+ Jörg Mensmann <joerg.mensmann@gmx.de>
+ for Xinerama support patch.
+
+ Vadim Shliakhov
+ for miscellaneous fixes.
+
+ Uwe Ohse
+ for Exif enhancements, histogram and other patches
+
+ Timo Horstschäfer
+ for customizable fullscreen overlay
+
+ Michael Mokeev
+ for print related enhancements
+
+ Carles Pina i Estany
+ for copy path to clipboard patch
+
+ Kjell Morgenstern
+ for random slide show speedup patch
- All those that I failed to list here.
+ Klaus Ethgen <Klaus@Ethgen.de>
+ for GPS integration, Search enhancement and other patches
+ And...
+ Thanks to the users for finding Geeqie useful.
-========