1 .\"Created with GNOME Manpages Editor
2 .\"http://gmanedit.sourceforge.net
3 .\"Sergio Rua <srua@gpul.org>
6 .\" Geeqie manual page.
7 .\" (C)2004 John Ellis <johne@verizon.net>
9 .\" This document is free to modify and distribute.
14 Geeqie \- GTK based multiformat image viewer
22 \fBGeeqie\fP is an interactive GTK based image viewer that supports multiple image formats, zooming, panning, thumbnails and sorting images into collections.
26 .IP \+t,\-\-with\-tools
27 Force the toolbox to be shown.
30 .IP \-t,\-\-without\-tools
31 Force the toolbox to be hidden.
34 .IP \-f,\-\-fullscreen
35 Start in full screen mode.
39 Start in slideshow mode.
42 .IP \-l,\-\-list[files...][collections...]
43 Open collection window for command line files.
47 Start with blank file list.
50 .IP \-\-geometry=XxY+XOFF+YOFF
51 Set main window location.
55 Send following commands to open window.
58 .IP \-rh,\-\-remote-help
59 Print remote command list.
63 Turn on debugging output.
66 .IP \-g:<regexp>,\-\-grep:<regexp>
70 .IP \+w,\-\-show-log-window
74 .IP \-o:<FILE>,\-\-log-file:<FILE>
75 Save log data to FILE.
83 Print command line options.
103 .IP \-f,\-\-fullscreen
107 .IP \-fs,\-\-fullscreen-start
111 .IP \-fS,\-\-fullscreen-stop
115 .IP \-s,\-\-slideshow
119 .IP \-ss,\-\-slideshow-start
123 .IP \-sS,\-\-slideshow-stop
127 .IP \-\-slideshow-recurse:<FOLDER>
128 Start recursive slide show in FOLDER.
131 .IP \-d<[HRS:][MINS:][N][.M]>,\-\-delay=<[hrs:][mins][N][.M]>
132 Set slide show delay to Hrs Mins N.M seconds.
135 .IP \+t,\-\-tools-show
139 .IP \-t,\-\-tools-hide
147 .IP \-\-config-load:<FILE>
148 Load configuration from FILE.
151 .IP \-\-get-sidecars:<FILE>
152 Get list of sidecars of FILE.
155 .IP \-\-get-destination:<FILE>
156 Get destination path of FILE.
160 Open FILE, bring Geeqie window to the top.
164 Open FILE, do not bring Geeqie window to the top.
168 Print filename [and Collection] of current image.
172 Print X, Y and RGB of mouse pointer on current image.
175 .IP \-\-get\-rectangle
176 Get rectangle co-ordinates.
179 .IP \-\-get\-render\-intent
183 .IP \-\-get\-filelist:[<FOLDER>]
184 Get list of files and class.
187 .IP \-\-get\-filelist-recurse:[<FOLDER>]
188 Get list of file and class recursive.
191 .IP \-\-get\-collection:<COLLECTION>
192 Get collection content.
195 .IP \-\-get\-collection\-list
200 Open FILE in new window.
204 Clear command line collection list.
207 .IP \-\-list-add:<FILE>
208 Add FILE to command line collection list.
212 Bring the Geeqie window to the top.
216 Window ID for following commands.
227 .IP \-ct:clear|clean,\-\-cache-thumbs:clear|clean
228 Clear or clean thumbnail cache.
231 .IP \-cs:clear|clean,\-\-cache-shared:clear|clean
232 Clear or clean shared thumbnail cache.
235 .IP \-cm,\-\-cache-metadata
236 Clean metadata cache.
239 .IP \-cr:<folder>,\-\-cache-render:<folder>
243 .IP \-crr:<folder>,\-\-cache-render-recurse:<folder>
244 Render thumbnails recursively.
247 .IP \-crs:<folder>,\-\-cache-render-shared:<folder>
248 Render thumbnails (see Help).
251 .IP \-crsr:<folder>,\-\-cache-render-shared-recurse:<folder>
252 Render thumbnails recursively (see Help).
255 .IP \-\-lua:<FILE>,<lua-script>
256 Run lua script on FILE.
260 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.
263 (on image) next image
266 .IP middle-mouse-click
267 (on image) previous image
274 .IP middle-mouse-drag
275 drag and drop operations
279 (on image) Changes to the next or previous image, or if option is enabled, scrolls the image vertically.
282 .IP mouse-wheel+Shift-key
283 (on image) Inverts the mouse wheel behavior between scrolling image or changing image.
286 .IP mouse-wheel+Control-key
287 (on image) Zooms the image in and out.
308 tab completion in path entry window
312 cancel completion in path entry window or stop generating thumbnails
315 Keys that are valid when the image part of the window is focused.
332 .SS FILE RELATED KEYS
343 open the Find Duplicates window
377 .SS EDIT MENU RELATED KEYS
392 go to the Configuration window
396 display image properties
400 rotate image clockwise
404 rotate image counterclockwise
408 rotate image 180 degrees
412 mirror image (horizontal)
416 flip image (vertical)
418 .SS VIEW MENU RELATED KEYS
429 zoom to original size
437 zoom in to X scale factor
441 zoom to \-2, \-3, \-4, respectively
445 toggle thumbnail display
449 display files in list format
453 display files in icon format
457 toggle tree view for directories
465 toggle floating of file selection area
469 toggle hiding of file selection area
473 toggle full-screen mode
477 toggle slide-show mode
481 toggle pause of slideshow
485 toggle display of exif sidebar
489 toggle display of sort manager
491 .SS COLLECTION WINDOW KEYS
498 select multiple images
502 move selector without changing selection
506 select the image under the selector
510 toggle selection of the image under the selector
514 move selector to the top image
518 move selector to bottom image
520 Adding Shift or Control to Home and End has a similar effect as adding them to the arrows.
531 remove image form collection (does not delete the file)
535 add images to collection form main file list
539 sort collection by name
543 sort collection by date
547 sort collection by file size
551 sort collection by pathname
555 sort collection by name numerically (*)
559 view image under selector in the main image window
563 view image under selector in new window
567 open selected image(s) in external editor
579 append current collection to existing collection
591 rename selected files
595 delete selected files
601 .SS DUPLICATES WINDOW KEYS
612 select group 1 images
616 select group 2 images
620 add images from main window file list
624 add selected images to new collection
628 remove selected images from list
636 view image with focus in main window
640 view image with focus in new window
644 open selected image(s) in editor
648 display properties window for selected images
660 rename selected files
664 delete selected files
672 The following data lists the locations Geeqie uses for various actions. The
673 uppercase symbols are environment variables. If they are not set on your system
674 the fallback locations are listed in parentheses. Geeqie will first attempt to
675 load a configuration file from:
677 .B /etc/geeqie/geeqierc.xml
679 It will then continue with the following locations.
680 Most of Geeqie's configuration files are contained in the folder, and sub-folders of:
682 .B $XDG_CONFIG_HOME/geeqie/
683 .B ($~/.config/geeqie/)
685 Geeqie's standard configuration file is:
689 An alternative configuration file may be used by executing:
691 .B geeqie -r --config-load:<filename>
693 Geeqie-created desktop files used by Plugins are in the folder:
697 Lua script files for Lua Extensions are in the folder:
701 Historic data such as last several folders visited, bookmarks, and recently used collections, as well as default print settings are contained in this text file:
705 Keyboard shortcut maps are contained in this text file:
709 The location for Collections is in the folder:
711 .B $XDG_DATA_HOME/geeqie/collections
713 .B ($~/.local/share/geeqie/collections)
715 The lirc Infra-red controller configuration file must be located at:
719 Thumbnails are stored in a location specified in Thumbnail Preferences
721 Metadata is stored either in the image file or in the location specified in Safe Delete
723 The safe delete folder is specified in the Metadata tab of main Preferences
726 Copyright (C) 1999-2004 by John Ellis.
727 Copyright (C) 2004-2017 by The Geeqie Team.
728 Use this software at your own risk!
729 This software released under the GNU General Public License. Please read the COPYING file for more information.
731 Please send bug reports and feedback to https://github.com/BestImageViewer/geeqie/issues
736 Manpage originally prepared by