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       -r,--remote
41              Send following commands to open window.
42
43       -rh,--remote-help
44              Print remote command list.
45
46       --debug[=level]
47              Turn on debugging output.
48
49       -g:<regexp>,--grep:<regexp>
50              Filter debug output.
51
52       +w,--show-log-window
53              Show log window.
54
55       -o:<FILE>,--log-file:<FILE>
56              Save log data to FILE.
57
58       -v,--version
59              Print version.
60
61       -h,--help
62              Print command line options.
63
64

REMOTE OPTIONS

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

USAGE

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

FILES

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

LICENSE

512       Copyright (C) 1999-2004 by John Ellis.  Copyright (C) 2004-2017 by  The
513       Geeqie  Team.   Use  this  software  at  your  own risk!  This software
514       released under the GNU General Public License. Please read the  COPYING
515       file for more information.
516

BUGS

518       Please  send  bug  reports  and  feedback to https://github.com/BestIm
519       ageViewer/geeqie/issues
520

AUTHOR

522       John Ellis <johne@verizon.net>
523       Manpage originally prepared by Nick Rusnov <nick@grawk.net>
524
525
526
527                                    Geeqie                           geeqie(1)
Impressum