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.
54 .IP \-n,\-\-new-instance
55 Open a new instance of Geeqie.
59 Send following commands to open window.
62 .IP \-rh,\-\-remote-help
63 Print remote command list.
67 Turn on debugging output.
70 .IP \-g:<regexp>,\-\-grep:<regexp>
74 .IP \+w,\-\-show-log-window
78 .IP \-o:<FILE>,\-\-log-file:<FILE>
79 Save log data to FILE.
87 Print command line options.
90 .IP \-\-disable-clutter
91 Disable use of Clutter library (i.e. GPU accel.).
111 .IP \-f,\-\-fullscreen
115 .IP \-fs,\-\-fullscreen-start
119 .IP \-fS,\-\-fullscreen-stop
123 .IP \-s,\-\-slideshow
127 .IP \-ss,\-\-slideshow-start
131 .IP \-sS,\-\-slideshow-stop
135 .IP \-\-slideshow-recurse:<FOLDER>
136 Start recursive slide show in FOLDER.
139 .IP \-d<[HRS:][MINS:][N][.M]>,\-\-delay=<[hrs:][mins][N][.M]>
140 Set slide show delay to Hrs Mins N.M seconds.
143 .IP \+t,\-\-tools-show
147 .IP \-t,\-\-tools-hide
155 .IP \-\-config-load:<FILE>|layout\ ID
156 Load configuration from FILE.
159 .IP \-\-get-sidecars:<FILE>
160 Get list of sidecars of FILE.
163 .IP \-\-get-destination:<FILE>
164 Get destination path of FILE.
167 .IP file:<FILE>|<URL>
168 Open FILE or URL, bring Geeqie window to the top.
171 .IP \-\-file:<FILE>|<URL>
172 Open FILE or URL, bring Geeqie window to the top.
175 .IP File:<FILE>|<URL>
176 Open FILE or URL, do not bring Geeqie window to the top.
179 .IP \-\-File:<FILE>|<URL>
180 Open FILE or URL, do not bring Geeqie window to the top.
184 Print filename [and Collection] of current image.
188 Print X, Y and RGB of mouse pointer on current image.
191 .IP \-\-get\-rectangle
192 Get rectangle co-ordinates.
195 .IP \-\-get\-render\-intent
199 .IP \-\-get\-filelist:[<FOLDER>]
200 Get list of files and class.
203 .IP \-\-get\-filelist-recurse:[<FOLDER>]
204 Get list of file and class recursive.
207 .IP \-\-get\-collection:<COLLECTION>
208 Get collection content.
211 .IP \-\-get\-collection\-list
215 .IP \-\-get\-file\-info
220 Open FILE in new window.
224 Open FILE in new window.
228 Clear command line collection list.
231 .IP \-\-list-add:<FILE>
232 Add FILE to command line collection list.
236 Bring the Geeqie window to the top.
240 Bring the Geeqie window to the top.
244 Window ID for following commands.
255 .IP \-\-geometry=[XxY][+XOFF+YOFF]
259 .IP \-ct:clear|clean,\-\-cache-thumbs:clear|clean
260 Clear or clean thumbnail cache.
263 .IP \-cs:clear|clean,\-\-cache-shared:clear|clean
264 Clear or clean shared thumbnail cache.
267 .IP \-cm,\-\-cache-metadata
268 Clean metadata cache.
271 .IP \-cr:<folder>,\-\-cache-render:<folder>
275 .IP \-crr:<folder>,\-\-cache-render-recurse:<folder>
276 Render thumbnails recursively.
279 .IP \-crs:<folder>,\-\-cache-render-shared:<folder>
280 Render thumbnails (see Help).
283 .IP \-crsr:<folder>,\-\-cache-render-shared-recurse:<folder>
284 Render thumbnails recursively (see Help).
287 .IP \-\-lua:<FILE>,<lua-script>
288 Run lua script on FILE.
292 Use PWD as working directory for following commands.
296 Terminate returned data with null character instead of newline.
300 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.
303 (on image) next image
306 .IP middle-mouse-click
307 (on image) previous image
314 .IP middle-mouse-drag
315 drag and drop operations
319 (on image) Changes to the next or previous image, or if option is enabled, scrolls the image vertically.
322 .IP mouse-wheel+Shift-key
323 (on image) Inverts the mouse wheel behavior between scrolling image or changing image.
326 .IP mouse-wheel+Control-key
327 (on image) Zooms the image in and out.
348 tab completion in path entry window
352 cancel completion in path entry window or stop generating thumbnails
355 Keys that are valid when the image part of the window is focused.
372 .SS FILE RELATED KEYS
383 open the Find Duplicates window
417 .SS EDIT MENU RELATED KEYS
432 go to the Configuration window
436 display image properties
440 rotate image clockwise
444 rotate image counterclockwise
448 rotate image 180 degrees
452 mirror image (horizontal)
456 flip image (vertical)
458 .SS VIEW MENU RELATED KEYS
469 zoom to original size
477 zoom in to X scale factor
481 zoom to \-2, \-3, \-4, respectively
485 toggle thumbnail display
489 display files in list format
493 display files in icon format
497 toggle tree view for directories
505 toggle floating of file selection area
509 toggle hiding of file selection area
513 toggle full-screen mode
517 toggle slide-show mode
521 toggle pause of slideshow
525 toggle display of exif sidebar
529 toggle display of sort manager
531 .SS COLLECTION WINDOW KEYS
538 select multiple images
542 move selector without changing selection
546 select the image under the selector
550 toggle selection of the image under the selector
554 move selector to the top image
558 move selector to bottom image
560 Adding Shift or Control to Home and End has a similar effect as adding them to the arrows.
571 remove image form collection (does not delete the file)
575 add images to collection form main file list
579 sort collection by name
583 sort collection by date
587 sort collection by file size
591 sort collection by pathname
595 sort collection by name numerically (*)
599 view image under selector in the main image window
603 view image under selector in new window
607 open selected image(s) in external editor
619 append current collection to existing collection
631 rename selected files
635 delete selected files
641 .SS DUPLICATES WINDOW KEYS
652 select group 1 images
656 select group 2 images
660 add images from main window file list
664 add selected images to new collection
668 remove selected images from list
676 view image with focus in main window
680 view image with focus in new window
684 open selected image(s) in editor
688 display properties window for selected images
700 rename selected files
704 delete selected files
712 The following data lists the locations Geeqie uses for various actions. The
713 uppercase symbols are environment variables. If they are not set on your system
714 the fallback locations are listed in parentheses. Geeqie will first attempt to
715 load a configuration file from:
717 .B /etc/geeqie/geeqierc.xml
719 It will then continue with the following locations.
720 Most of Geeqie's configuration files are contained in the folder, and sub-folders of:
722 .B $XDG_CONFIG_HOME/geeqie/
723 .B ($~/.config/geeqie/)
725 Geeqie's standard configuration file is:
729 An alternative configuration file may be used by executing:
731 .B geeqie -r --config-load:<filename>
733 Geeqie-created desktop files used by Plugins are in the folder:
737 Lua script files for Lua Extensions are in the folder:
741 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:
745 Keyboard shortcut maps are contained in this text file:
749 The location for Collections is in the folder:
751 .B $XDG_DATA_HOME/geeqie/collections
753 .B ($~/.local/share/geeqie/collections)
755 The lirc Infra-red controller configuration file must be located at:
759 Thumbnails are stored in a location specified in Thumbnail Preferences
761 Metadata is stored either in the image file or in the location specified in Safe Delete
763 The safe delete folder is specified in the Metadata tab of main Preferences
766 Copyright (C) 1999-2004 by John Ellis.
767 Copyright (C) 2004-2017 by The Geeqie Team.
768 Use this software at your own risk!
769 This software released under the GNU General Public License. Please read the COPYING file for more information.
771 Please send bug reports and feedback to https://github.com/BestImageViewer/geeqie/issues
776 Manpage originally prepared by