1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
|
###################################################################
## GQview 2.0.4 (December 2, 2006) ##
## ##
## 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 <johne@verizon.net>
e-mail: gqview@users.sourceforge.net
homepage: http://gqview.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+ >= 2.4.x: ftp://ftp.gtk.org/pub/gtk
======== Notes and changes for this release [section:release_notes]
Changes in 2.0.4:
- Make sort menus display choices as radio group instead of checkbox.
- Use white background for transparent images when printing.
* 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.
* Fix memory leak when unable to start a slideshow.
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
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.
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 )
Known bugs:
see the TODO file.
======== Installation
Compilation: ./configure ; make
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:
- 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)
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
(*) 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.
======== 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 2.0.4)
Please send po files/patches in gzipped form to ensure data integrity.
Note: completion % in the chart below may not be quite correct when fuzzy
translations exist but do not appear in the source.
comp % = trans / (trans + fuzzy + untrans)
Language Comp (%) Trans Fuzzy Untrans Warn
--------------------------------------------------
ar 67 449 150 70
be 99 668 1 0
bg 99 667 2 0
ca 99 667 2 0
cs 99 667 2 0
da 20 138 287 244
de 99 667 2 0
eo 99 668 1 0
es 99 668 1 0
et 30 204 284 181
eu 100 669 0 0
fi 99 668 1 0
fr 99 667 2 0
hu 55 374 187 108
id 31 208 285 176
it 99 667 2 0
ja 99 667 2 0
ko 17 114 1 554
nl 99 668 1 0
no 25 169 297 203
pl 90 606 1 62
pt_BR 99 668 1 0
ro 57 388 189 92
ru 99 667 2 0
sk 97 655 1 13
sl 23 155 303 211
sv 99 665 3 1
th 24 161 296 212
tr 10 71 287 311
uk 26 180 293 196
vi 99 668 1 0
zh_CN.GB2312 25 169 297 203
zh_TW 99 668 1 0
--------------------------------------------------
======== 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
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>
Tetralet <tetralet@luna.com.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>
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 Belarusion translation
Piarres Beobide <pi@beobide.net>
for Basque translation
Antonio C. Codazzi <f_sophia@libero.it>
for Esperanto translation
Fixes, additions, and patches:
Eric Swalens
Quy Tonthat
for Exif 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.
And...
Thanks to the users for finding GQview useful.
========
|
