1 ###################################################################
2 ## GQview 2.1.0 (March 5, 2005) ##
4 ## Copyright (C) 1999 - 2005 John Ellis. ##
6 ## Use at your own risk! ##
8 ## This software released under the GNU General Public License. ##
9 ## Please read the COPYING file for more information. ##
10 ###################################################################
12 Author: John Ellis <johne@verizon.net>
13 e-mail: gqview@users.sourceforge.net
14 homepage: http://gqview.sourceforge.net
17 BETA! BETA! BETA! BETA! BETA! BETA! BETA! BETA! BETA! BETA! BETA!
19 The 2.1.x series are all development releases, and as such may
20 contain incredible bugs. Only use if interested in the new features.
22 The stable release as of this writing is 2.0.0.
24 BETA! BETA! BETA! BETA! BETA! BETA! BETA! BETA! BETA! BETA! BETA!
27 ======== README contents:
30 * Notes and changes for this release
32 * Description / Features
33 * Documentation (keyboard shortcuts)
34 * Editor command macros
41 GTK+ 2.4.x: ftp://ftp.gtk.org/pub/gtk
43 ======== Notes and changes for this release [section:release_notes]
47 + Add Pan View window (name pending) for displaying images as a timeline,
48 calendar, folder tree, folder flower (name pending) and basic grid.
49 Keyboard shortcut for Pan View is Control + J (may change in future).
50 + Panning an image with the mouse while holding down the shift key will
52 + Add 'Fast jpeg thumbnailing' option, on by default.
53 - Demote xvpics support to a hidden option.
54 - Update French translation.
59 For translation status list, see further below.
61 Version in perenthesis indicates first appearance of feature or change.
63 (1.5.6) The "shared thumbnail cache" is a proposal to unify the method
64 of storing thumbnails, so that they are compatible between different
65 applications. Using this option will allow GQview to share it's
66 thumbnails with, and use thumbnails from, other applications. Current
67 releases of GNOME (through nautilus and gthumb) and the gimp use this
68 new thumbnailing system. The latest draft of the thumbnail standard
69 is located on freedesktop.org in the standards section, and links to:
71 http://triq.net/~jens/thumbnail-spec/index.html
73 The shared thumbnail standard and GQview's classic mechanism can
74 not be used at the same time, enabling the "use shared thumbnail cache"
75 option will disable the use of classic thumbnails and use the new
78 (1.5.6) Collections contained in $HOME/.gqview/collections are now
79 updated when moving or renaming files, even if the collection is not
82 (1.5.6) The new option to the keep the full screen window above other
83 windows is only available when using at least GTK+ 2.4.0
85 (1.5.5) Dialog buttons are now ordered as recommended by the GNOME HIG.
86 The GNOME Human Interface Guidelines live at:
87 http://developer.gnome.org/projects/gup/hig/
88 To restore the old button order you must be using GTK 2.6 and set
89 the "gtk-alternative-button-order" key to TRUE in the gtkrc file:
91 by changing or adding this line:
92 gtk-alternative-button-order = 1
94 (1.5.5) The dithering option is now a hidden option, to change it
95 please refer to section 10.7 of the manual (help -> contents).
97 (1.5.0) Keywords and comments can now be entered for a file. Two places
98 allow keyword and comment entry. The first is via the new image details
99 sidebar accessed with (Ctrl-K), and the second is a details tab in the
100 properties dialog. If multiple files are selected, two buttons are
101 available: One allows adding the keywords to the selected files, the
102 other replaces existing keywords with the new keywords.
104 Keyword and comment metadata is stored in $(HOME)/.gqview/metadata, and
105 mirrors the existing filesystem tree. Metadata filenames have a suffix
106 of .meta appended. If 'cache into .thumbnails' is enabled, metadata is
107 stored locally to the original file in a hidden subfolder ".metadata".
108 If write permissions do not allow local saving of metadata, GQview falls
109 back to the default $(HOME)/.gqview/metadata location.
111 (1.5.0) Search dialog (F3 key) types:
112 Path searches files in the entered folder.
113 Comments searches all file metadata stored in ~/.gqview/metadata.
114 Results searches the current list of results, allowing refinement.
116 (1.3.6) Drag and drop has been significantly improved, with a few
117 changes. Button 1 will now initiate a drag, button 2 will still work
118 for this, the difference is button 2 will not change the selection.
120 (1.3.6) A middle button click will now toggle selection of clicked item.
122 (1.3.5) UTF-8 and filenames: GQview works fine if your filenames
123 correctly match the prefered locale encoding (LANG environment
124 variable), and prints errors on the console when they do not.
126 (1.3.3) Safe delete does not include undo, you will need to go to the
127 trash folder and retrieve the file(s) manually. The files can be viewed
128 by clicking the view button near the safe delete option in the preferences
129 window. Files moved to the trash folder are prefixed with a 6 digit
130 number. Lower numbers are older, and deleted (permanently) first when the
131 trash size limit is reached.
133 (1.3.2) New in 1.3.2 are sidebars for exif data display and a sort
134 manager. Exif (ctrl + E) should be self explanatory. The Sort manager is a
135 directory list that allows copying or moving the displayed image to that
136 destination with one click of the button - very helpful when visually
137 sorting many images into subdirectories. To edit, reorder, or remove items
138 in the sort list, use the right click menu. The keyboard can also be used
139 by moving the focus to the desired button, then pressing menu/ctrl+f10 key
140 to display the popup menu, or shift+up/shift+down keys to change the
141 button location in the list. Items can also be added to the list by
142 dragging a directory onto the list.
146 If you plan on making any major changes to the code that will be offered
147 for inclusion to the main source, please contact me first - so that we
148 can avoid duplication of effort. A good example is porting any part of
149 GQview that uses deprecated widgets to GTK2 widgets, there are already
150 several such patches floating around. This is especially true if the
151 change is listed in the TODO!
152 -John ( johne@verizon.net )
158 ======== Installation
160 Compilation: ./configure ; make
161 General install: make install
162 Removal: make uninstall
164 - To build an RPM binary:
166 on RedHat 6.x, 7.x use 'rpm -tb gqview-x.x.x.tar.gz'.
167 on RedHat 8 and 9 use 'rpmbuild -tb gqview-x.x.x.tar.gz'.
168 on other rpm distros, it depends on which version of rpm is used, if
169 the option fails with the rpm command, try rpmbuild.
171 Where the resulting package is placed is distribution specific, for
172 example in RedHat it is placed in /usr/src/redhat/RPMS/{architecture}/
174 ======== Description / Features
176 GQview is a graphics file viewer. Basic features:
178 - Single click image viewing / navigation.
180 - Thumbnails, with optional caching and .xvpics support.
181 - Multiple file selection for move, copy, delete, rename, drag and drop.
185 - Ability to open images in external editors (configurable).
187 - Comparison of images to find duplicates by name, size, date,
188 dimensions, or image content similarity.
191 ======== Documentation (brief) [section:documentation]
194 [PageDown], [Keypad PageDown] next image
195 [PageUp], [Keypad PageUp] previous image
196 [Home], [Keypad Home] first image in list
197 [End], [Keypad End] last image in list
198 [Tab] tab completion in path entry window
199 [Escape] cancel completion in path entry window
201 Keyboard commands valid when image has focus (image has black rectangle)
202 arrow keys, [Keypad arrows] pan image
203 [Shift] - arrow keys pan image faster
205 [Backspace] , B previous image
208 [Ctrl] - N new window
209 C new empty collection
211 D open a Find Duplicates window
212 [Shift]- P open Print dialog
213 [Ctrl] - F new folder
216 [Ctrl] - R rename file
217 [Ctrl] - D, [Delete] delete file
218 [Ctrl] - W close window
219 [Ctrl] - Q exit GQview
222 [Ctrl] - 1 .. 0 run external editor
223 [Ctrl] - A select all files
224 [Ctrl] - [Shift] - A unselect all files
225 [Ctrl] - P display image properties window
226 [Ctrl] - O configure Options
227 ] rotate image clockwise
228 [ rotate image counterclockwise
229 [Shift] - R rotate image 180 degrees
230 [Shift] - M mirror image (horizontal)
231 [Shift] - F flip image (verticle)
234 +, =, [Keypad +] zoom in
235 -, [Keypad -] zoom out
236 Z, [Keypad /] zoom to original size
237 X, [Keypad *] zoom to fit within window
238 W zoom to fit width of window
239 H zoom to fit height of window
240 1, 2, 3, 4 zoom to Nx (3 = 3x)
241 9, 8, 7 zoom to -2, -3, -4, respectively
242 T toggle thumbnails in list view
243 [Ctrl] - L display files as list view
244 [Ctrl] - I display files as icon view
245 [Ctrl] - T toggle tree view of directories
247 L (Un)float file selection area
248 [ctrl] - H (Un)hide file selection area
249 [Ctrl] - K toggle Keywords sidebar
250 [Ctrl] - E toggle EXIF sidebar
251 [Ctrl] - S toggle sort manager sidebar
252 F, V toggle full screen
254 P (Un)pause slideshow
258 arrows, [Keypad arrows] move selection
259 [Shift] + arrows select multiple images
260 [Ctrl] + arrows move without changing selection
261 [Space] select only image with focus
262 [Ctrl] + [Space] toggle selection of image with focus
263 [Home], [Keypad Home] move focus to top of images
264 [End], [Keypad End] move focus to end of images
265 (shift and ctrl work with Home, End, PageUp/Down as with arrows)
266 [Ctrl] - A select all images
267 [Ctrl] - [Shift] - A unselect all images
269 [Delete], [Keypad Delete] remove selected images from collection
270 (does not delete file)
271 [Ctrl] - L add images from main window file list
273 [Ctrl] - T toggle display of icon filename text
275 N sort collection by name
276 D sort collection by date
277 B sort collection by size (bytes)
278 P sort collection by location (path)
279 I (*) sort collection by name numerically
280 (file1 file10 file2 -> file1 file2 file10)
282 [Enter], [Keypad Enter] view image with focus in main window
283 V view image with focus in new window
284 [Ctrl] - 1 .. 0 open selected image(s) in editor
287 [Ctrl] - S save collection as...
288 A append to collection...
290 [Ctrl] - C copy selected files...
291 [Ctrl] - M move selected files...
292 [Ctrl] - R rename selected files...
293 [Ctrl] - D delete selected files
295 [Ctrl] - P display image properties window
297 [Ctrl] - W close window
299 Find Duplicates window:
301 [Ctrl] - A select all images
302 [Ctrl] - [Shift] - A unselect all images
303 1 select group 1 duplicates
304 2 select group 2 duplicates
306 [Ctrl] - L add images from main window file list
307 C add selected images to new collection
309 [Delete], [Keypad Delete] remove selected images from list
310 [Ctrl] - [Delete] clear window
312 [Enter], [Keypad Enter] view image with focus in main window
313 V view image with focus in new window
314 [Ctrl] - 1 .. 0 open selected image(s) in editor
316 [Ctrl] - C copy selected files...
317 [Ctrl] - M move selected files...
318 [Ctrl] - R rename selected files...
319 [Ctrl] - D delete selected files
321 [Ctrl] - P display image properties window
323 [Ctrl] - W close window
325 (*) This is a compile time option enabled when strverscmp is found.
329 Button 1 view next image
330 Button 2 view previous image
331 Button 3 context menu
333 Button 1 drag scroll/pan image
334 Button 2 drag initiate drag and drop
336 Wheel up/down change to previous/next image
337 Wheel up/down + [Shift] scroll image up/down
338 Wheel up/down + [Control] zoom image in/out
340 ======== Editor command macros [section:editors]
342 Any one of the following filename markers may be used:
344 %f Replaced with list of selected files, may occur once.
345 %p Command is run once for each selected file, may occur multiple times.
346 none When neither %f or %p exist, list of files is appended to command.
348 Use of the following to display output window for the command:
350 %v Display result of command in output window, must occur as first two
351 characters in the command.
352 %V Like v above, but when used with %p, only displays output window for
353 multiple files. The output of a single file is suppressed.
355 ======== Additional comments:
358 These options are not adjustable in the preferences window, to change
359 them edit $(HOME)/.gqview/gqviewrc while GQview is not running. An option
360 becomes 'advanced' when it is removed from the user's visibility, and
361 only remains so that those few users that really want it will not complain
362 about it's removal :)
364 lazy_image_sync: false
365 Set true to enable the old behavior of lazy image updates when changing
366 directories. (viewed image will remain until a new file is selected)
368 display_dialogs_under_mouse: false
369 Set true to force dialogs to display under the current mouse position,
370 note that this goes against the preference set for the window manager.
372 ======== Translation status:
376 Please send po files/patches in gzipped form to ensure data integrity.
378 Language Comp (%) Trans Fuzzy Untrans Warn
379 --------------------------------------------------
406 zh_CN.GB2312 25 168 296 203
408 --------------------------------------------------
412 ======== Credits [section:credits]
417 Grzegorz Kowal <g_kowal@poczta.onet.pl>
418 Zbigniew Chyla <cyba@gnome.pl>
419 Emil Nowak <emil5@go2.pl>
420 Wit Wilinski <wit.wilinski@gmail.com>
421 for Polish translation
423 Christopher R. Gabriel <cgabriel@pluto.linux.it>
424 Di Maggio Salvatore <Salvatore.Dimaggio@bologna.marelli.it>
425 Costantino <inverness1ATvirgilio.it>
426 for Italian translation
428 Sandokan <cortex@nextra.sk>
429 Ivan Priesol <priesol@iris-sk.sk>
430 for Slovak translation
432 Rodrigo Sancho Senosiain <ruy_ikari@bigfoot.com>
433 Ariel Fermani <the_end@bbs.frc.utn.edu.ar>
434 for Spanish translation
436 Eric Lassauge <lassauge@users.sf.net>
437 Jean-Pierre Pedron <jppedron@club-internet.fr>
438 Pascal Bleser <pascal.bleser@atosorigin.com>
439 Nicolas Boos <nicolas.boos@wanadoo.fr>
440 Nicolas Bonifas <nicolas_bonifas@users.sf.net>
441 for French translation
443 Fâtih Demir <kabalak@gmx.net>
444 for Turkish translation
446 Kam Tik <kamtik@hongkong.com>
447 Abel Cheung <deaddog@deaddog.ws>
448 S.J. Luo <crystal@mickey.ee.nctu.edu.tw>
449 for Traditional Chinese (Big5) translation
451 Junichi Uekawa <dancer@debian.org>
452 Oleg Andrjushenko <oandr@itec.cn.ua>
453 Michael Bravo <mbravo@tag-ltd.spb.ru>
454 Sergey Pinaev <dfo@antex.ru>
455 for Russian translation
457 Guilherme M. Schroeder <slump@ieg.com.br>
458 Vitor Fernandes <vitor_fernandes@SoftHome.net>
459 for Brazilian Portuguese translation
461 Shingo Akagaki <akagaki@ece.numazu-ct.ac.jp>
462 Yuuki Ninomiya <gm@debian.or.jp>
463 Sato Satoru <ss@gnome.gr.jp>
464 Takeshi AIHANA <aihana@gnome.gr.jp>
465 for Japanese translation
467 Matthias Warkus <mawarkus@t-online.de>
468 Thomas Klausner <wiz@danbala.ifoer.tuwien.ac.at>
469 Danny Milosavljevic <danny_milo@yahoo.com>
470 for German translation
472 Matej Erman <matej.erman@guest.arnes.si>
473 for Slovene translation
475 MÃtyÃs Tibor <templar@tempi.scene.hu>
476 Koblinger Egmont <egmont@uhulinux.hu>
477 Sári Gábor <saga@externet.hu>
478 for Hungarian translation
480 Wu Yulun <migr@operamail.com>
481 Charles Wang <charlesw1234cn@yahoo.com.cn>
482 for simplified Chinese translation
484 H.J.Visser <H.J.Visser@harrie.mine.nu>
485 Tino Meinen <a.t.meinen@chello.nl>
486 for Dutch translation
488 Lauri Nurmi <lanurmi@iki.fi>
489 for Finnish translation
491 Ilmar Kerm <ikerm@hot.ee>
492 for Estonian translation
494 Volodymyr M. Lisivka <lvm@mystery.lviv.net>
495 for Ukrainian translation
497 Birger Langkjer <birger.langkjer@image.dk>
498 for Danish translation
500 Torgeir Ness Sundli <torgeir@mp3bil.no>
501 for Norwegian translation
503 Jan Raska <jan_raska@hotmail.com>
504 Michal Bukovjan <bukm@centrum.cz>
505 for Czech translation
507 Phanumas Thanyaboon <maskung@hotmail.com>
510 Harald Ersch <hersch@romatsa.ro>
511 for Romanian translation
513 pclouds <pclouds@vnlinux.org>
514 for Vietnamese translation
516 Tedi Heriyanto <tedi_h@gmx.net>
517 for Indonesian translation
519 Vladimir Petrov <vladux@mail.bg>
520 for Bulgarian translation
522 Hans Öfverbeck <hans.ofverbeck@home.se>
523 for Swedish translation
525 Youssef Assad <youssef@devcabal.org>
526 for Arabic translation
528 Fixes, additions, and patches:
534 Diederen Damien <D.Diederen@student.ulg.ac.be>
535 for .xvpics thumbnail reading support.
537 Nick Rusnov <nick@grawk.net>
538 Ryan Murray <rmurray@debian.org>
541 Martin Pool <mbp@samba.org>
542 for sort by number, misc. improvements.
544 Jörg Mensmann <joerg.mensmann@gmx.de>
545 for Xinerama support patch.
548 for miscellaneous fixes.
552 Thanks to the users for finding GQview useful.