Documentation update
[geeqie.git] / geeqie.1
1 .\"Created with GNOME Manpages Editor
2 .\"http://gmanedit.sourceforge.net
3 .\"Sergio Rua <srua@gpul.org>
4 .\"
5 .\"
6 .\" Geeqie manual page.
7 .\" (C)2004 John Ellis <johne@verizon.net>
8 .\"
9 .\" This document is free to modify and distribute.
10 .\"
11 .TH geeqie 1 "Geeqie"
12
13 .SH NAME
14 Geeqie \- GTK based multiformat image viewer
15 .SH SYNOPSIS
16 .B geeqie
17 .RI [ options ] 
18 .RI [ path ]
19 .br
20
21 .SH DESCRIPTION
22 \fBGeeqie\fP is an interactive GTK based image viewer that supports multiple image formats, zooming, panning, thumbnails and sorting images into collections.
23
24 .SH OPTIONS
25 .B
26 .IP +t,\-\-with\-tools
27 Force the toolbox to be shown.
28 .br
29 .B
30 .IP \-t,\-\-without\-tools
31 Force the toolbox to be hidden.
32 .br
33 .B
34 .IP \-f,\-\-fullscreen
35 Start in full screen mode.
36 .br
37 .B
38 .IP \-s,\-\-slideshow
39 Start in slideshow mode.
40 .br
41 .B
42 .IP \-l,\-\-list
43 Open collection window for command line files.
44 .br
45 .B
46 .IP \-\-debug
47 Turn on debugging output.
48 .br
49 .B
50 .IP \-v,\-\-version
51 Print version.
52 .br
53 .B
54 .IP \-h,\-\-help
55 Print command line options.
56
57 .SH USAGE
58 Key naming is similar to that of \fBemacs\fP(1): \fIC-key\fP indicates that control should be held, and key should be pressed; \fIS-key\fP  indicates that shift should be held and key should be pressed; these two can be combined, also, into \fIC-S-key\fP.
59 .B
60 .IP left-mouse-click
61 (on image) next image
62 .br
63 .B
64 .IP middle-mouse-click
65 (on image) previous image
66 .br
67 .B
68 .IP right-mouse
69 context menu
70 .br
71 .B
72 .IP middle-mouse-drag
73 drag and drop operations
74 .br
75 .B
76 .IP mouse-wheel
77 (on image) Changes to the next or previous image, or if option is enabled, scrolls the image vertically.
78 .br
79 .B
80 .IP mouse-wheel+Shift-key
81 (on image) Inverts the mouse wheel behavior between scrolling image or changing image.
82 .br
83 .B
84 .IP mouse-wheel+Control-key
85 (on image) Zooms the image in and out.
86 .br
87 .SS GENERAL  KEYS
88 .B
89 .IP PageDown
90 next image
91 .br
92 .B
93 .IP PageUp
94 previous image
95 .br
96 .B
97 .IP Home                             
98 first image in list
99 .br
100 .B
101 .IP End
102 last image in list
103 .br
104 .B
105 .IP Tab
106 tab completion in path entry window
107 .br
108 .B
109 .IP Escape
110 cancel completion in path entry window or stop generating thumbnails
111 .br
112 .SS IMAGE KEYS
113 Keys that are valid when the image part of the window is focused.
114 .B
115 .IP Arrows
116 pan image
117 .br
118 .B
119 .IP Shift+Arrows
120 pan image faster
121 .br
122 .B
123 .IP Space,N
124 next image
125 .br
126 .B
127 .IP Backspace,B
128 previous image
129 .br
130 .SS FILE RELATED KEYS
131 .B
132 .IP C
133 new empty collection
134 .br
135 .B
136 .IP O
137 open collection
138 .br
139 .B
140 .IP D
141 open the Find Duplicates window
142 .br
143 .B
144 .IP C-F
145 new folder
146 .br
147 .B
148 .IP C-C
149 copy file
150 .br
151 .B
152 .IP C-M
153 move file
154 .br
155 .B
156 .IP C-R
157 rename file
158 .br
159 .B
160 .IP C-D,Delete
161 delete file
162 .br
163 .B
164 .IP C-N
165 new window
166 .br
167 .B
168 .IP C-W
169 close window
170 .br
171 .B
172 .IP C-Q
173 quit
174 .br
175 .SS EDIT MENU RELATED KEYS
176 .B
177 .IP C-1,2..9,0
178 run external editor
179 .br
180 .B
181 .IP C-A
182 select all files
183 .br
184 .B
185 .IP C-S-A
186 unselect all files
187 .br
188 .B
189 .IP C-O
190 go to the Configuration window
191 .br
192 .B
193 .IP C-P
194 display image properties
195 .br
196 .B
197 .IP ]
198 rotate image clockwise
199 .br
200 .B
201 .IP [
202 rotate image counterclockwise
203 .br
204 .B
205 .IP S-R
206 rotate image 180 degrees
207 .br
208 .B
209 .IP S-M
210 mirror image (horizontal)
211 .br
212 .B
213 .IP S-F
214 flip image (vertical)
215 .br
216 .SS VIEW MENU RELATED KEYS
217 .B
218 .IP +,=
219 zoom in
220 .br
221 .B
222 .IP -
223 zoom out
224 .br
225 .B
226 .IP Z,KeyPad-/
227 zoom to original size
228 .br
229 .B
230 .IP X,KeyPad-*
231 zoom to fit window
232 .br
233 .B
234 .IP 1,2,3,4
235 zoom in to X scale factor
236 .br
237 .B
238 .IP 9,8,7
239 zoom to \-2, \-3, \-4, respectively
240 .br
241 .B
242 .IP T
243 toggle thumbnail display
244 .br
245 .B
246 .IP C-L
247 display files in list format
248 .br
249 .B
250 .IP C-I
251 display files in icon format
252 .br
253 .B
254 .IP C-T
255 toggle tree view for directories
256 .br
257 .B
258 .IP R
259 refresh file list
260 .br
261 .B
262 .IP L
263 toggle floating of file selection area
264 .br
265 .B
266 .IP H
267 toggle hiding of file selection area
268 .br
269 .B
270 .IP F,V
271 toggle full-screen mode
272 .br
273 .B
274 .IP S
275 toggle slide-show mode
276 .br
277 .B
278 .IP P
279 toggle pause of slideshow
280 .br
281 .B
282 .IP C-E
283 toggle display of exif sidebar
284 .br
285 .B
286 .IP C-S
287 toggle display of sort manager
288 .br
289 .SS COLLECTION WINDOW KEYS
290 .B
291 .IP Arrows
292 move selection
293 .br
294 .B
295 .IP Shift+Arrows
296 select multiple images
297 .br
298 .B
299 .IP Control+Arrows
300 move selector without changing selection
301 .br
302 .B
303 .IP Space
304 select the image under the selector
305 .br
306 .B
307 .IP Control+Space
308 toggle selection of the image under the selector
309 .br
310 .B
311 .IP Home
312 move selector to the top image
313 .br
314 .B
315 .IP End
316 move selector to bottom image
317 .br
318 Adding Shift or Control to Home and End has a similar effect as adding them to the arrows.
319 .B
320 .IP C-A
321 select all images
322 .br
323 .B
324 .IP C-S-A
325 unselect all images
326 .br
327 .B
328 .IP Delete
329 remove image form collection (does not delete the file)
330 .br
331 .B
332 .IP C-L
333 add images to collection form main file list
334 .br
335 .B
336 .IP N
337 sort collection by name
338 .br
339 .B
340 .IP D
341 sort collection by date
342 .br
343 .B
344 .IP B
345 sort collection by file size
346 .br
347 .B
348 .IP P
349 sort collection by pathname
350 .br
351 .B
352 .IP I
353 sort collection by name numerically (*)
354 .br
355 .B
356 .IP Enter
357 view image under selector in the main image window
358 .br
359 .B
360 .IP V
361 view image under selector in new window
362 .br
363 .B
364 .IP C-1,2..9,0
365 open selected image(s) in external editor
366 .br
367 .B
368 .IP S
369 save collection
370 .br
371 .B
372 .IP C-S
373 save collection as
374 .br
375 .B
376 .IP A
377 append current collection to existing collection
378 .br
379 .B
380 .IP C-C
381 copy selected files
382 .br
383 .B
384 .IP C-M
385 move selected files
386 .br
387 .B
388 .IP C-R
389 rename selected files
390 .br
391 .B
392 .IP C-D
393 delete selected files
394 .br
395 .B
396 .IP C-W
397 close window
398 .br
399 .SS DUPLICATES WINDOW KEYS
400 .B
401 .IP C-A
402 select all images
403 .br
404 .B
405 .IP C-S-A
406 unselect all images
407 .br
408 .B
409 .IP 1
410 select group 1 images
411 .br
412 .B
413 .IP 2
414 select group 2 images
415 .br
416 .B
417 .IP C-L
418 add images from main window file list
419 .br
420 .B
421 .IP C
422 add selected images to new collection
423 .br
424 .B
425 .IP Delete
426 remove selected images from list
427 .br
428 .B
429 .IP C-Delete
430 clear window
431 .br
432 .B
433 .IP Enter
434 view image with focus in main window
435 .br
436 .B
437 .IP V
438 view image with focus in new window
439 .br
440 .B
441 .IP C-1,2..9,0
442 open selected image(s) in editor
443 .br
444 .B
445 .IP C-P
446 display properties window for selected images
447 .br
448 .B
449 .IP C-C
450 copy selected files
451 .br
452 .B
453 .IP C-M
454 move selected files
455 .br
456 .B
457 .IP C-R
458 rename selected files
459 .br
460 .B
461 .IP C-D
462 delete selected files
463 .br
464 .B
465 .IP C-W
466 close window
467 .br
468
469
470 .SH LICENSE
471 Copyright (C) 1999-2004 by John Ellis.
472 Use this software at your own risk!  
473 This software released under the GNU General Public License. Please read the COPYING file for more information.
474 .SH BUGS
475 Please send bug reports and feedback to geeqie-devel@lists.sourceforge.net
476 .SH AUTHOR
477 .B John Ellis
478 <johne@verizon.net>
479 .br
480 Manpage originally prepared by
481 .B Nick Rusnov
482 <nick@grawk.net>