###################################################################
## Geeqie 1.0alpha1 ##
## ##
## Copyright (C) 2008 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. ##
###################################################################
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 in alpha state. Everybody is encouraged
to try the new features, however for stable software look at
the original project.
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
Required libraries:
GTK+ 2.4.x: 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')
lirc, for remote control support: http://www.lirc.org/
(disable with configure option: '--disable-lirc')
======== Notes and changes for this release [section:release_notes]
Changes:
+ Add support for color profiles (requires lcms, see Notes).
+ Add ability to delete a folder and it's contents (with restrictions).
- Add support for jpegs embedded in pentax and olympus raw files.
- Add icons for image state, enabled with I keyboard shortcut.
- For pan view calendar only show months that contain an image.
- Make scrolling with overlays (full screen info display) a bit smoother.
- Make sort menus display choices as radio group instead of checkbox.
- Use white background for transparent images when printing.
* Escape filename characters "`$\ before passing them to the system shell
when running an editor command.
* Fix occasional crash in icon view when removing files.
* Always use aligned memory access in EXIF parser, fixes crash
with BUS error on sparc.
* Fix progress bar warning when removing files while loading thumbnails.
* Fix image count in full screen information overlay when in slideshow.
* Fix memory leak when unable to start a slideshow.
Notes:
For translation status list, see further below.
Version in parenthesis indicates first appearance of feature or change.
!!! FIXME Geeqie changes !!!
Below are GQView releases:
(2.1.5) Add support for color profiles when lcms is installed. To
disable color profiles and use of lcms, run configure
with '--without-lcms'.
(2.1.1) Add support for viewing jpeg images and EXIF embedded within
raw files for Canon (.crw, .cr2) Fujifilm (.raf), and Nikon (.nef).
Note that not all cameras that support a raw format will necessarily
save a usable jpeg in the raw file (for example some Nikon cameras only
store a tiny thumbnail within the raw .nef file).
(1.5.6) The "shared thumbnail cache" is a proposal to unify the method
of storing thumbnails, so that they are compatible between different
applications. Using this option will allow GQview to share it's
thumbnails with, and use thumbnails from, other applications. Current
releases of GNOME (through nautilus and gthumb) and the gimp use this
new thumbnailing system. The latest draft of the thumbnail standard
is located on freedesktop.org in the standards section, and links to:
http://triq.net/~jens/thumbnail-spec/index.html
The shared thumbnail standard and GQview's classic mechanism can
not be used at the same time, enabling the "use shared thumbnail cache"
option will disable the use of classic thumbnails and use the new
shared thumbnails.
(1.5.6) Collections contained in $HOME/.gqview/collections are now
updated when moving or renaming files, even if the collection is not
open at the time.
(1.5.6) The new option to the keep the full screen window above other
windows is only available when using at least GTK+ 2.4.0
(1.5.5) Dialog buttons are now ordered as recommended by the GNOME HIG.
The GNOME Human Interface Guidelines live at:
http://developer.gnome.org/projects/gup/hig/
To restore the old button order you must be using GTK 2.6 and set
the "gtk-alternative-button-order" key to TRUE in the gtkrc file:
$HOME/.gtkrc-2.0
by changing or adding this line:
gtk-alternative-button-order = 1
(1.5.5) The dithering option is now a hidden option, to change it
please refer to section 10.7 of the manual (help -> contents).
(1.5.0) Keywords and comments can now be entered for a file. Two places
allow keyword and comment entry. The first is via the new image details
sidebar accessed with (Ctrl-K), and the second is a details tab in the
properties dialog. If multiple files are selected, two buttons are
available: One allows adding the keywords to the selected files, the
other replaces existing keywords with the new keywords.
Keyword and comment metadata is stored in $(HOME)/.gqview/metadata, and
mirrors the existing filesystem tree. Metadata filenames have a suffix
of .meta appended. If 'cache into .thumbnails' is enabled, metadata is
stored locally to the original file in a hidden subfolder ".metadata".
If write permissions do not allow local saving of metadata, GQview falls
back to the default $(HOME)/.gqview/metadata location.
(1.5.0) Search dialog (F3 key) types:
Path searches files in the entered folder.
Comments searches all file metadata stored in ~/.gqview/metadata.
Results searches the current list of results, allowing refinement.
(1.3.6) Drag and drop has been significantly improved, with a few
changes. Button 1 will now initiate a drag, button 2 will still work
for this, the difference is button 2 will not change the selection.
(1.3.6) A middle button click will now toggle selection of clicked item.
(1.3.5) UTF-8 and filenames: GQview works fine if your filenames
correctly match the prefered locale encoding (LANG environment
variable), and prints errors on the console when they do not.
(1.3.3) Safe delete does not include undo, you will need to go to the
trash folder and retrieve the file(s) manually. The files can be viewed
by clicking the view button near the safe delete option in the preferences
window. Files moved to the trash folder are prefixed with a 6 digit
number. Lower numbers are older, and deleted (permanently) first when the
trash size limit is reached.
(1.3.2) New in 1.3.2 are sidebars for exif data display and a sort
manager. Exif (ctrl + E) should be self explanatory. The Sort manager is a
directory list that allows copying or moving the displayed image to that
destination with one click of the button - very helpful when visually
sorting many images into subdirectories. To edit, reorder, or remove items
in the sort list, use the right click menu. The keyboard can also be used
by moving the focus to the desired button, then pressing menu/ctrl+f10 key
to display the popup menu, or shift+up/shift+down keys to change the
button location in the list. Items can also be added to the list by
dragging a directory onto the list.
Code hackers:
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. A good example is porting any part of
GQview that uses deprecated widgets to GTK2 widgets, there are already
several such patches floating around. This is especially true if the
change is listed in the TODO!
The Geeqie Team
Known bugs:
see the Geeqie Bug Tracker at TODO file.
======== Installation
Compilation: ./configure ; make
General install: make install
Removal: make uninstall
!!! FIXME !!!
- To build an RPM binary:
on RedHat 6.x, 7.x use 'rpm -tb gqview-x.x.x.tar.gz'.
on RedHat 8 and 9 use 'rpmbuild -tb gqview-x.x.x.tar.gz'.
on other rpm distros, it depends on which version of rpm is used, if
the option fails with the rpm command, try rpmbuild.
Where the resulting package is placed is distribution specific, for
example in RedHat it is placed in /usr/src/redhat/RPMS/{architecture}/
======== Description / Features
Geeqie is a graphics file viewer. Basic features:
- Single click image viewing / navigation.
- Zoom functions.
- Thumbnails, with optional caching and .xvpics support.
- Multiple file selection for move, copy, delete, rename, drag and drop.
- Drag and drop.
- 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.
======== Documentation (brief) [section:documentation]
Keyboard commands:
[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
Keyboard commands valid when image has focus (image has black rectangle)
arrow keys, [Keypad arrows] pan image
[Shift] - arrow keys pan image faster
[Space] next image
[Backspace] , B previous image
File menu related:
[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 GQview
Edit menu related:
[Ctrl] - 1 .. 0 run external editor
[Ctrl] - A select all files
[Ctrl] - [Shift] - A unselect all files
[Ctrl] - P display image properties window
[Ctrl] - O configure Options
] rotate image clockwise
[ rotate image counterclockwise
[Shift] - R rotate image 180 degrees
[Shift] - M mirror image (horizontal)
[Shift] - F flip image (verticle)
[Shift] - G grayscale image
View menu related:
+, =, [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
1, 2, 3, 4 zoom to Nx (3 = 3x)
9, 8, 7 zoom to -2, -3, -4, respectively
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
L (Un)float file selection area
[ctrl] - H (Un)hide file selection area
[Ctrl] - K toggle Keywords sidebar
[Ctrl] - E toggle EXIF sidebar
[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
[Ctrl] - 1 .. 0 open selected image(s) in editor
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:
Button 1 view next image
Button 2 view previous image
Button 3 context menu
Button 1 drag scroll/pan image
Button 2 drag initiate drag and drop
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]
Any one of the following filename markers may be used:
%f Replaced with list of selected files, may occur once.
%p Command is run once for each selected file, may occur multiple times.
none When neither %f or %p exist, list of files is appended to command.
Use of the following to display output window for the command:
%v Display result of command in output window, must occur as first two
characters in the command, or immediately after the "%w" macro.
%V Like v above, but when used with %p, only displays output window for
multiple files. The output of a single file is suppressed.
Additional macros:
%w Prevent full screen from deactivating when command is executed,
must occur as the first two characters.
======== Overlay Info [section:overlay]
Overlay info format string syntax is: %tag[:max_length][:extra]%
%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
To access exif data use the exif name:
%Exif.Photo.DateTimeOriginal% Date of the original shot
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
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 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:*\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 *\n" -> display collection name in bold prefixed by
"Collection " and a newline is appended
======== Additional comments:
Hidden options:
These options are not adjustable in the preferences window, to change
them edit $(HOME)/.geeqie/geeqierc while Geeqie is not running. An option
becomes 'hidden' when it is removed from the user's visibility, and
only remains so that those few users that really want it will not complain
about it's removal :)
lazy_image_sync: false
Set true to enable the old behavior of lazy image updates when changing
directories. (viewed image will remain until a new file is selected)
display_dialogs_under_mouse: false
Set true to force dialogs to display under the current mouse position,
note that this goes against the preference set for the window manager.
======== Credits [section:credits]
Translations:
Grzegorz Kowal
Zbigniew Chyla
Emil Nowak
Wit Wilinski
for Polish translation
Christopher R. Gabriel
Di Maggio Salvatore
Costantino
for Italian translation
Sandokan
Ivan Priesol
Mgr. Peter Tuharsky
for Slovak translation
Rodrigo Sancho Senosiain
Ariel Fermani
for Spanish translation
Laurent Monin
Eric Lassauge
Jean-Pierre Pedron
Pascal Bleser
Nicolas Boos
Nicolas Bonifas
for French translation
Fâtih Demir
for Turkish translation
Kam Tik
Abel Cheung
S.J. Luo
for Traditional Chinese (Big5) translation
Junichi Uekawa
Oleg Andrjushenko
Michael Bravo
Sergey Pinaev
for Russian translation
Guilherme M. Schroeder
Vitor Fernandes
Herval Ribeiro de Azevêdo
for Brazilian Portuguese translation
Shingo Akagaki
Yuuki Ninomiya
Sato Satoru
Takeshi AIHANA
for Japanese translation
Matthias Warkus
Thomas Klausner
Danny Milosavljevic
Ronny Steiner
for German translation
Matej Erman
for Slovene translation
MÃtyÃs Tibor
Koblinger Egmont
Sári Gábor
for Hungarian translation
Wu Yulun
Charles Wang
for simplified Chinese translation
H.J.Visser
Tino Meinen
for Dutch translation
Lauri Nurmi
for Finnish translation
Ilmar Kerm
for Estonian translation
Volodymyr M. Lisivka
for Ukrainian translation
Birger Langkjer
for Danish translation
Torgeir Ness Sundli
for Norwegian translation
Jan Raska
Michal Bukovjan
for Czech translation
Phanumas Thanyaboon
for Thai translation
Harald Ersch
for Romanian translation
pclouds
for Vietnamese translation
Tedi Heriyanto
for Indonesian translation
Vladimir Petrov
for Bulgarian translation
Hans Öfverbeck
for Swedish translation
Youssef Assad
for Arabic translation
catux.org
for Catalan translation
Hyun-Jin Moon
for Belarusian translation
Piarres Beobide
for Basque translation
Antonio C. Codazzi
for Esperanto translation
Fixes, additions, and patches:
Eric Swalens
Quy Tonthat
for initial Exif support.
Daniel M. German
for Canon raw image support.
Lars Ellenberg
for Fujifilm raw image support.
Diederen Damien
for .xvpics thumbnail reading support.
Nick Rusnov
Ryan Murray
for man page.
Martin Pool
for sort by number, misc. improvements.
Jörg Mensmann
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
And...
Thanks to the users for finding Geeqie useful.
======== Translation status:
Please send po files/patches in gzipped form to ensure data integrity.
Translations statistics
Date: Sun, 11 May 2008 12:03:37 +0200
Note: completion % in the chart below may not be quite correct
when fuzzy translations exist but do not appear in the source.
For exact results, run make update-po with up to date POTFILES.in.
comp % = trans / (trans + fuzzy + untrans)
Language Comp(%) Trans Fuzzy Untrans Total
fr 100.00 985 0 0 985
be 90.56 892 25 68 985
eu 68.53 675 150 160 985
eo 68.22 672 153 160 985
vi 68.02 670 156 159 985
it 67.82 668 154 163 985
pt_BR 67.82 668 154 163 985
zh_TW 66.90 659 150 176 985
sk 66.50 655 158 172 985
fi 64.37 634 176 175 985
nl 64.37 634 179 172 985
sv 64.16 632 175 178 985
bg 64.06 631 175 179 985
ca 64.06 631 175 179 985
cs 64.06 631 175 179 985
de 64.06 631 175 179 985
es 64.06 631 175 179 985
ja 64.06 631 175 179 985
ru 64.06 631 175 179 985
pl 60.61 597 148 240 985
ar 42.94 423 315 247 985
ro 37.56 370 342 273 985
hu 36.14 356 332 297 985
id 19.70 194 408 383 985
et 19.29 190 407 388 985
uk 17.16 169 411 405 985
nb 15.94 157 416 412 985
zh_CN.GB2312 15.94 157 416 412 985
th 15.13 149 413 423 985
sl 14.72 145 419 421 985
da 12.99 128 402 455 985
ko 11.37 112 52 821 985
tr 6.60 65 398 522 985
========