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.).
94 .IP \-\-cache-maintenance\ <path>
95 Run cache maintenance in non-GUI mode.
115 .IP \-f,\-\-fullscreen
119 .IP \-fs,\-\-fullscreen-start
123 .IP \-fS,\-\-fullscreen-stop
127 .IP \-s,\-\-slideshow
131 .IP \-ss,\-\-slideshow-start
135 .IP \-sS,\-\-slideshow-stop
139 .IP \-\-slideshow-recurse:<FOLDER>
140 Start recursive slide show in FOLDER.
143 .IP \-d<[HRS:][MINS:][N][.M]>,\-\-delay=<[hrs:][mins][N][.M]>
144 Set slide show delay to Hrs Mins N.M seconds.
147 .IP \+t,\-\-tools-show
151 .IP \-t,\-\-tools-hide
159 .IP \-\-config-load:<FILE>|layout\ ID
160 Load configuration from FILE.
163 .IP \-\-get-sidecars:<FILE>
164 Get list of sidecars of FILE.
167 .IP \-\-get-destination:<FILE>
168 Get destination path of FILE.
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, bring Geeqie window to the top.
179 .IP File:<FILE>|<URL>
180 Open FILE or URL, do not bring Geeqie window to the top.
183 .IP \-\-File:<FILE>|<URL>
184 Open FILE or URL, do not bring Geeqie window to the top.
188 Print filename [and Collection] of current image.
192 Print X, Y and RGB of mouse pointer on current image.
195 .IP \-\-get\-rectangle
196 Get rectangle co-ordinates.
199 .IP \-\-get\-render\-intent
203 .IP \-\-get\-filelist:[<FOLDER>]
204 Get list of files and class.
207 .IP \-\-get\-filelist-recurse:[<FOLDER>]
208 Get list of file and class recursive.
211 .IP \-\-get\-collection:<COLLECTION>
212 Get collection content.
215 .IP \-\-get\-collection\-list
219 .IP \-\-get\-file\-info
224 Open FILE in new window.
228 Open FILE in new window.
232 Clear command line collection list.
235 .IP \-\-list-add:<FILE>
236 Add FILE to command line collection list.
240 Bring the Geeqie window to the top.
244 Bring the Geeqie window to the top.
248 Window ID for following commands.
259 .IP \-\-geometry=[XxY][+XOFF+YOFF]
263 .IP \-ct:clear|clean,\-\-cache-thumbs:clear|clean
264 Clear or clean thumbnail cache.
267 .IP \-cs:clear|clean,\-\-cache-shared:clear|clean
268 Clear or clean shared thumbnail cache.
271 .IP \-cm,\-\-cache-metadata
272 Clean metadata cache.
275 .IP \-cr:<folder>,\-\-cache-render:<folder>
279 .IP \-crr:<folder>,\-\-cache-render-recurse:<folder>
280 Render thumbnails recursively.
283 .IP \-crs:<folder>,\-\-cache-render-shared:<folder>
284 Render thumbnails (see Help).
287 .IP \-crsr:<folder>,\-\-cache-render-shared-recurse:<folder>
288 Render thumbnails recursively (see Help).
291 .IP \-\-lua:<FILE>,<lua-script>
292 Run lua script on FILE.
296 Use PWD as working directory for following commands.
300 Terminate returned data with null character instead of newline.
304 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.
307 (on image) next image
310 .IP middle-mouse-click
311 (on image) previous image
318 .IP middle-mouse-drag
319 drag and drop operations
323 (on image) Changes to the next or previous image, or if option is enabled, scrolls the image vertically.
326 .IP mouse-wheel+Shift-key
327 (on image) Inverts the mouse wheel behavior between scrolling image or changing image.
330 .IP mouse-wheel+Control-key
331 (on image) Zooms the image in and out.
352 tab completion in path entry window
356 cancel completion in path entry window or stop generating thumbnails
359 Keys that are valid when the image part of the window is focused.
376 .SS FILE RELATED KEYS
387 open the Find Duplicates window
421 .SS EDIT MENU RELATED KEYS
436 go to the Configuration window
440 display image properties
444 rotate image clockwise
448 rotate image counterclockwise
452 rotate image 180 degrees
456 mirror image (horizontal)
460 flip image (vertical)
462 .SS VIEW MENU RELATED KEYS
473 zoom to original size
481 zoom in to X scale factor
485 zoom to \-2, \-3, \-4, respectively
489 toggle thumbnail display
493 display files in list format
497 display files in icon format
501 toggle tree view for directories
509 toggle floating of file selection area
513 toggle hiding of file selection area
517 toggle full-screen mode
521 toggle slide-show mode
525 toggle pause of slideshow
529 toggle display of exif sidebar
533 toggle display of sort manager
535 .SS COLLECTION WINDOW KEYS
542 select multiple images
546 move selector without changing selection
550 select the image under the selector
554 toggle selection of the image under the selector
558 move selector to the top image
562 move selector to bottom image
564 Adding Shift or Control to Home and End has a similar effect as adding them to the arrows.
575 remove image form collection (does not delete the file)
579 add images to collection form main file list
583 sort collection by name
587 sort collection by date
591 sort collection by file size
595 sort collection by pathname
599 sort collection by name numerically (*)
603 view image under selector in the main image window
607 view image under selector in new window
611 open selected image(s) in external editor
623 append current collection to existing collection
635 rename selected files
639 delete selected files
645 .SS DUPLICATES WINDOW KEYS
656 select group 1 images
660 select group 2 images
664 add images from main window file list
668 add selected images to new collection
672 remove selected images from list
680 view image with focus in main window
684 view image with focus in new window
688 open selected image(s) in editor
692 display properties window for selected images
704 rename selected files
708 delete selected files
716 The following data lists the locations Geeqie uses for various actions. The
717 uppercase symbols are environment variables. If they are not set on your system
718 the fallback locations are listed in parentheses. Geeqie will first attempt to
719 load a configuration file from:
721 .B /etc/geeqie/geeqierc.xml
723 It will then continue with the following locations.
724 Most of Geeqie's configuration files are contained in the folder, and sub-folders of:
726 .B $XDG_CONFIG_HOME/geeqie/
727 .B ($~/.config/geeqie/)
729 Geeqie's standard configuration file is:
733 An alternative configuration file may be used by executing:
735 .B geeqie -r --config-load:<filename>
737 Geeqie-created desktop files used by Plugins are in the folder:
741 Lua script files for Lua Extensions are in the folder:
745 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:
749 Keyboard shortcut maps are contained in this text file:
753 The location for Collections is in the folder:
755 .B $XDG_DATA_HOME/geeqie/collections
757 .B ($~/.local/share/geeqie/collections)
759 The lirc Infra-red controller configuration file must be located at:
763 Thumbnails are stored in a location specified in Thumbnail Preferences
765 Metadata is stored either in the image file or in the location specified in Safe Delete
767 The safe delete folder is specified in the Metadata tab of main Preferences
770 Copyright (C) 1999-2004 by John Ellis.
771 Copyright (C) 2004-2017 by The Geeqie Team.
772 Use this software at your own risk!
773 This software released under the GNU General Public License. Please read the COPYING file for more information.
775 Please send bug reports and feedback to https://github.com/BestImageViewer/geeqie/issues
780 Manpage originally prepared by