1geeqie(1)                   General Commands Manual                  geeqie(1)
2
3
4

NAME

6       Geeqie - GTK based multiformat image viewer
7

SYNOPSIS

9       geeqie [options] [path]
10
11

DESCRIPTION

13       Geeqie  is an interactive GTK based image viewer that supports multiple
14       image formats, zooming, panning, thumbnails  and  sorting  images  into
15       collections.
16
17

OPTIONS

19       +t,--with-tools
20              Force the toolbox to be shown.
21
22       -t,--without-tools
23              Force the toolbox to be hidden.
24
25       -f,--fullscreen
26              Start in full screen mode.
27
28       -s,--slideshow
29              Start in slideshow mode.
30
31       -l,--list[files...][collections...]
32              Open collection window for command line files.
33
34       --blank
35              Start with blank file list.
36
37       --geometry=XxY+XOFF+YOFF
38              Set main window location.
39
40       -n,--new-instance
41              Open a new instance of Geeqie.
42
43       -r,--remote
44              Send following commands to open window.
45
46       -rh,--remote-help
47              Print remote command list.
48
49       --debug[=level]
50              Turn on debugging output.
51
52       -g:<regexp>,--grep:<regexp>
53              Filter debug output.
54
55       +w,--show-log-window
56              Show log window.
57
58       -o:<FILE>,--log-file:<FILE>
59              Save log data to FILE.
60
61       -v,--version
62              Print version.
63
64       -h,--help
65              Print command line options.
66
67       --disable-clutter
68              Disable use of Clutter library (i.e. GPU accel.).
69
70

REMOTE OPTIONS

72       -n,--next
73              Next image.
74
75       -b,--back
76              Previous image.
77
78       --first
79              First image.
80
81       --last Last image.
82
83       -f,--fullscreen
84              Toggle full screen.
85
86       -fs,--fullscreen-start
87              Start full screen.
88
89       -fS,--fullscreen-stop
90              Stop full screen.
91
92       -s,--slideshow
93              Toggle slideshow.
94
95       -ss,--slideshow-start
96              Start slideshow.
97
98       -sS,--slideshow-stop
99              Stop slideshow.
100
101       --slideshow-recurse:<FOLDER>
102              Start recursive slide show in FOLDER.
103
104       -d<[HRS:][MINS:][N][.M]>,--delay=<[hrs:][mins][N][.M]>
105              Set slide show delay to Hrs Mins N.M seconds.
106
107       +t,--tools-show
108              Show tools.
109
110       -t,--tools-hide
111              Hide tools.
112
113       -q,--quit
114              Quit.
115
116       --config-load:<FILE>|layout ID
117              Load configuration from FILE.
118
119       --get-sidecars:<FILE>
120              Get list of sidecars of FILE.
121
122       --get-destination:<FILE>
123              Get destination path of FILE.
124
125       file:<FILE>|<URL>
126              Open FILE or URL, bring Geeqie window to the top.
127
128       --file:<FILE>|<URL>
129              Open FILE or URL, bring Geeqie window to the top.
130
131       File:<FILE>|<URL>
132              Open FILE or URL, do not bring Geeqie window to the top.
133
134       --File:<FILE>|<URL>
135              Open FILE or URL, do not bring Geeqie window to the top.
136
137       --tell Print filename [and Collection] of current image.
138
139       --pixel-info
140              Print X, Y and RGB of mouse pointer on current image.
141
142       --get-rectangle
143              Get rectangle co-ordinates.
144
145       --get-render-intent
146              Get render intent.
147
148       --get-filelist:[<FOLDER>]
149              Get list of files and class.
150
151       --get-filelist-recurse:[<FOLDER>]
152              Get list of file and class recursive.
153
154       --get-collection:<COLLECTION>
155              Get collection content.
156
157       --get-collection-list
158              Get collection list.
159
160       --get-file-info
161              Get file info.
162
163       view:<FILE>
164              Open FILE in new window.
165
166       --view:<FILE>
167              Open FILE in new window.
168
169       --list-clear
170              Clear command line collection list.
171
172       --list-add:<FILE>
173              Add FILE to command line collection list.
174
175       raise  Bring the Geeqie window to the top.
176
177       --raise
178              Bring the Geeqie window to the top.
179
180       --id:<ID>
181              Window ID for following commands.
182
183       --new-window
184              Open new window.
185
186       --close-window
187              Close window.
188
189       --geometry=[XxY][+XOFF+YOFF]
190              Set window geometry.
191
192       -ct:clear|clean,--cache-thumbs:clear|clean
193              Clear or clean thumbnail cache.
194
195       -cs:clear|clean,--cache-shared:clear|clean
196              Clear or clean shared thumbnail cache.
197
198       -cm,--cache-metadata
199              Clean metadata cache.
200
201       -cr:<folder>,--cache-render:<folder>
202              Render thumbnails.
203
204       -crr:<folder>,--cache-render-recurse:<folder>
205              Render thumbnails recursively.
206
207       -crs:<folder>,--cache-render-shared:<folder>
208              Render thumbnails (see Help).
209
210       -crsr:<folder>,--cache-render-shared-recurse:<folder>
211              Render thumbnails recursively (see Help).
212
213       --lua:<FILE>,<lua-script>
214              Run lua script on FILE.
215
216       --PWD:<PWD>
217              Use PWD as working directory for following commands.
218
219       --print0
220              Terminate returned data with null character instead of newline.
221
222

USAGE

224       Key naming is similar to that of emacs(1): C-key indicates that control
225       should be held, and key should be pressed; S-key  indicates that  shift
226       should  be  held  and key should be pressed; these two can be combined,
227       also, into C-S-key.
228
229       left-mouse-click
230              (on image) next image
231
232       middle-mouse-click
233              (on image) previous image
234
235       right-mouse
236              context menu
237
238       middle-mouse-drag
239              drag and drop operations
240
241       mouse-wheel
242              (on image) Changes to the next or previous image, or  if  option
243              is enabled, scrolls the image vertically.
244
245       mouse-wheel+Shift-key
246              (on  image)  Inverts  the mouse wheel behavior between scrolling
247              image or changing image.
248
249       mouse-wheel+Control-key
250              (on image) Zooms the image in and out.
251
252   GENERAL KEYS
253       PageDown
254              next image
255
256       PageUp previous image
257
258       Home   first image in list
259
260       End    last image in list
261
262       Tab    tab completion in path entry window
263
264       Escape cancel completion in path entry window or stop generating thumb‐
265              nails
266
267   IMAGE KEYS
268       Keys that are valid when the image part of the window is focused.
269
270       Arrows pan image
271
272       Shift+Arrows
273              pan image faster
274
275       Space,N
276              next image
277
278       Backspace,B
279              previous image
280
281   FILE RELATED KEYS
282       C      new empty collection
283
284       O      open collection
285
286       D      open the Find Duplicates window
287
288       C-F    new folder
289
290       C-C    copy file
291
292       C-M    move file
293
294       C-R    rename file
295
296       C-D,Delete
297              delete file
298
299       C-N    new window
300
301       C-W    close window
302
303       C-Q    quit
304
305   EDIT MENU RELATED KEYS
306       C-1,2..9,0
307              run external editor
308
309       C-A    select all files
310
311       C-S-A  unselect all files
312
313       C-O    go to the Configuration window
314
315       C-P    display image properties
316
317       ]      rotate image clockwise
318
319       [      rotate image counterclockwise
320
321       S-R    rotate image 180 degrees
322
323       S-M    mirror image (horizontal)
324
325       S-F    flip image (vertical)
326
327   VIEW MENU RELATED KEYS
328       +,=    zoom in
329
330       -      zoom out
331
332       Z,KeyPad-/
333              zoom to original size
334
335       X,KeyPad-*
336              zoom to fit window
337
338       1,2,3,4
339              zoom in to X scale factor
340
341       9,8,7  zoom to -2, -3, -4, respectively
342
343       T      toggle thumbnail display
344
345       C-L    display files in list format
346
347       C-I    display files in icon format
348
349       C-T    toggle tree view for directories
350
351       R      refresh file list
352
353       L      toggle floating of file selection area
354
355       H      toggle hiding of file selection area
356
357       F,V    toggle full-screen mode
358
359       S      toggle slide-show mode
360
361       P      toggle pause of slideshow
362
363       C-E    toggle display of exif sidebar
364
365       C-S    toggle display of sort manager
366
367   COLLECTION WINDOW KEYS
368       Arrows move selection
369
370       Shift+Arrows
371              select multiple images
372
373       Control+Arrows
374              move selector without changing selection
375
376       Space  select the image under the selector
377
378       Control+Space
379              toggle selection of the image under the selector
380
381       Home   move selector to the top image
382
383       End    move selector to bottom image
384              Adding  Shift or Control to Home and End has a similar effect as
385              adding them to the arrows.
386
387       C-A    select all images
388
389       C-S-A  unselect all images
390
391       Delete remove image form collection (does not delete the file)
392
393       C-L    add images to collection form main file list
394
395       N      sort collection by name
396
397       D      sort collection by date
398
399       B      sort collection by file size
400
401       P      sort collection by pathname
402
403       I      sort collection by name numerically (*)
404
405       Enter  view image under selector in the main image window
406
407       V      view image under selector in new window
408
409       C-1,2..9,0
410              open selected image(s) in external editor
411
412       S      save collection
413
414       C-S    save collection as
415
416       A      append current collection to existing collection
417
418       C-C    copy selected files
419
420       C-M    move selected files
421
422       C-R    rename selected files
423
424       C-D    delete selected files
425
426       C-W    close window
427
428   DUPLICATES WINDOW KEYS
429       C-A    select all images
430
431       C-S-A  unselect all images
432
433       1      select group 1 images
434
435       2      select group 2 images
436
437       C-L    add images from main window file list
438
439       C      add selected images to new collection
440
441       Delete remove selected images from list
442
443       C-Delete
444              clear window
445
446       Enter  view image with focus in main window
447
448       V      view image with focus in new window
449
450       C-1,2..9,0
451              open selected image(s) in editor
452
453       C-P    display properties window for selected images
454
455       C-C    copy selected files
456
457       C-M    move selected files
458
459       C-R    rename selected files
460
461       C-D    delete selected files
462
463       C-W    close window
464
465

FILES

467       The following data lists the locations Geeqie uses for various actions.
468       The uppercase symbols are environment variables. If they are not set on
469       your system the fallback locations are listed  in  parentheses.  Geeqie
470       will first attempt to load a configuration file from:
471
472       /etc/geeqie/geeqierc.xml
473
474       It  will  then continue with the following locations.  Most of Geeqie's
475       configuration files are contained in the folder, and sub-folders of:
476
477       $XDG_CONFIG_HOME/geeqie/ ($~/.config/geeqie/)
478
479       Geeqie's standard configuration file is:
480
481       .../geeqierc.xml
482
483       An alternative configuration file may be used by executing:
484
485       geeqie -r --config-load:<filename>
486
487       Geeqie-created desktop files used by Plugins are in the folder:
488
489       .../applications
490
491       Lua script files for Lua Extensions are in the folder:
492
493       .../lua
494
495       Historic data such as last several folders visited, bookmarks, and  re‐
496       cently  used  collections,  as  well as default print settings are con‐
497       tained in this text file:
498
499       .../history
500
501       Keyboard shortcut maps are contained in this text file:
502
503       .../accels
504
505       The location for Collections is in the folder:
506
507       $XDG_DATA_HOME/geeqie/collections
508       ($~/.local/share/geeqie/collections)
509
510       The lirc Infra-red controller configuration file must be located at:
511
512       $HOME/.lircrc
513
514       Thumbnails are stored in a location specified in Thumbnail Preferences
515
516       Metadata is stored either in the image file or in the  location  speci‐
517       fied in Safe Delete
518
519       The safe delete folder is specified in the Metadata tab of main Prefer‐
520       ences
521
522

LICENSE

524       Copyright (C) 1999-2004 by John Ellis.  Copyright (C) 2004-2017 by  The
525       Geeqie  Team.   Use  this software at your own risk!  This software re‐
526       leased under the GNU General Public License. Please  read  the  COPYING
527       file for more information.
528

BUGS

530       Please  send  bug  reports  and  feedback to https://github.com/BestIm
531       ageViewer/geeqie/issues
532

AUTHOR

534       John Ellis <johne@verizon.net>
535       Manpage originally prepared by Nick Rusnov <nick@grawk.net>
536
537
538
539                                    Geeqie                           geeqie(1)
Impressum