X-Git-Url: http://geeqie.org/cgi-bin/gitweb.cgi?p=geeqie.git;a=blobdiff_plain;f=README;h=9e123937586cf2fe5e387d7186f41c3fe563b241;hp=5bf390472b4ea81b920caf9242579d4cab2cb917;hb=a40d8f1e7f4bace37758d6f0bc4f598652b77b69;hpb=8d5a3868d93a4a93f5b3f57929988cbc16cedd14 diff --git a/README b/README index 5bf39047..9e123937 100644 --- a/README +++ b/README @@ -1,7 +1,8 @@ ################################################################### -## GQview 2.0.0 (February 26, 2005) ## +## Geeqie 1.1 ## ## ## -## Copyright (C) 1999 - 2005 John Ellis. ## +## Copyright (C) 2008 - 2012 The Geeqie Team ## +## Copyright (C) 1999 - 2006 John Ellis. ## ## ## ## Use at your own risk! ## ## ## @@ -9,9 +10,27 @@ ## Please read the COPYING file for more information. ## ################################################################### -Author: John Ellis -e-mail: gqview@users.sourceforge.net -homepage: http://gqview.sourceforge.net +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: @@ -28,141 +47,37 @@ homepage: http://gqview.sourceforge.net ======== Requirements - GTK+ 2.4.x: ftp://ftp.gtk.org/pub/gtk - + 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] - New features in 2.0: - - + Search utility. - + Ability to assign keywords and comments to an image. - + Printing, including proof sheets. - + Support for the Thumbnail Managing Standard, on by default. - + Fullscreen support for multihead configurations. - + Fullscreen can now delay showing next image until it is loaded. - + Image information now viewable in fullscreen (I key). - + Extensive user manual. - + Command line control of existing GQview process. - + Collections are now updated when moving or renaming a file. - - Shift + Click on an image will start mouse scrolling. - - Control + Arrows will jump to respective edges of image. - - Slideshow interval precision is now .1 second. - - Find duplicates by checksum now uses MD5 algorithm. - - Exif sidebar can now be customized. - - Sort manager now has symlink option. - - Sort manager can now add images to collections. - - Window maximization state now retained between sessions. - - Clean up all dialogs. - - Added hidden option scroll_reset_method (see docs chapter 10.7). - - Maintenance utility for caches and data used by GQview. - - Utility to create thumbnails ahead of time in one step. - - Now requires GTK+ >= 2.4 - - Changes since 1.5.9: - - - Update translations bg, es, it, ja, nl, pl, ru. - - - Notes: - - For translation status list, see further below. - - Version in perenthesis indicates first appearance of feature or change. - - (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. +See http://geeqie.wiki.sourceforge.net/new_features + 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 me 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! - -John ( johne@verizon.net ) + for inclusion to the main source, please contact us first - so that we + can avoid duplication of effort. + The Geeqie Team Known bugs: - see the TODO file. + see the Geeqie Bug Tracker at TODO file. ======== Installation @@ -170,19 +85,9 @@ homepage: http://gqview.sourceforge.net General install: make install Removal: make uninstall - - 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 - GQview is a graphics file viewer. Basic features: + Geeqie is a graphics file viewer. Basic features: - Single click image viewing / navigation. - Zoom functions. @@ -196,9 +101,17 @@ homepage: http://gqview.sourceforge.net - 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) [section:documentation] +This sections lists default hotkeys. Most of the hotkeys can be redefined +in the Preferences dialog. + Keyboard commands: [PageDown], [Keypad PageDown] next image [PageUp], [Keypad PageUp] previous image @@ -225,10 +138,11 @@ homepage: http://gqview.sourceforge.net [Ctrl] - R rename file [Ctrl] - D, [Delete] delete file [Ctrl] - W close window - [Ctrl] - Q exit GQview + [Ctrl] - Q exit Geeqie Edit menu related: - [Ctrl] - 1 .. 0 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 @@ -237,7 +151,8 @@ homepage: http://gqview.sourceforge.net [ rotate image counterclockwise [Shift] - R rotate image 180 degrees [Shift] - M mirror image (horizontal) - [Shift] - F flip image (verticle) + [Shift] - F flip image (vertical) + [Shift] - G grayscale image View menu related: +, =, [Keypad +] zoom in @@ -246,8 +161,6 @@ homepage: http://gqview.sourceforge.net 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 @@ -255,12 +168,13 @@ homepage: http://gqview.sourceforge.net 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] - 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: @@ -290,12 +204,13 @@ homepage: http://gqview.sourceforge.net [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... @@ -331,6 +246,11 @@ homepage: http://gqview.sourceforge.net [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: @@ -346,76 +266,75 @@ homepage: http://gqview.sourceforge.net 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. - %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 comments: - - Advanced options: - These options are not adjustable in the preferences window, to change - them edit $(HOME)/.gqview/gqviewrc while GQview is not running. An option - becomes 'advanced' 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. - -======== Translation status: - - (as of 1.5.8) - - Please send po files/patches in gzipped form to ensure data integrity. - -Language Comp (%) Trans Fuzzy Untrans Warn --------------------------------------------------- -ar 67 448 149 70 -bg 100 667 0 0 -cs 58 387 186 94 -da 20 137 286 244 -de 56 375 185 107 -es 100 667 0 0 -et 30 203 283 181 -fi 58 387 189 91 -fr 91 609 50 8 -hu 55 373 186 108 -id 31 207 284 176 -it 100 667 0 0 -ja 100 667 0 0 -nl 100 667 0 0 -no 25 168 296 203 -pl 80 538 51 78 -pt_BR 25 168 296 203 -ro 58 387 188 92 -ru 100 667 0 0 -sk 58 387 189 91 -sl 23 154 302 211 -sv 99 664 2 1 -th 24 161 295 211 -tr 10 70 286 311 -uk 26 179 292 196 -vi 56 380 189 98 -zh_CN.GB2312 25 168 296 203 -zh_TW 55 368 186 113 --------------------------------------------------- +======== Editor command macros [section:editors] +Editors are configured via standard desktop files, see +https://sourceforge.net/apps/trac/geeqie/wiki/GuideEditorsConfig + + +======== 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 + 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:*\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 *\n%" -> display collection name in bold prefixed by + "Collection " and a newline is appended ======== Credits [section:credits] @@ -436,12 +355,14 @@ zh_TW 55 368 186 113 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 @@ -465,6 +386,7 @@ zh_TW 55 368 186 113 Guilherme M. Schroeder Vitor Fernandes + Herval Ribeiro de Azevêdo for Brazilian Portuguese translation Shingo Akagaki @@ -476,6 +398,8 @@ zh_TW 55 368 186 113 Matthias Warkus Thomas Klausner Danny Milosavljevic + Ronny Steiner + Klaus Ethgen for German translation Matej Erman @@ -509,7 +433,7 @@ zh_TW 55 368 186 113 Torgeir Ness Sundli for Norwegian translation - Jan Raska + Jan Raska Michal Bukovjan for Czech translation @@ -534,11 +458,32 @@ zh_TW 55 368 186 113 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 Exif support. + 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. @@ -556,10 +501,25 @@ zh_TW 55 368 186 113 Vadim Shliakhov for miscellaneous fixes. + Uwe Ohse + for Exif enhancements, histogram and other patches - And... - Thanks to the users for finding GQview useful. + 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 + + Klaus Ethgen + for GPS integration, Search enhancement and other patches + And... + Thanks to the users for finding Geeqie useful. -========