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, bring Geeqie window to the top.
168 Open FILE, do not bring Geeqie window to the top.
172 Open FILE, do not bring Geeqie window to the top.
176 Print filename [and Collection] of current image.
180 Print X, Y and RGB of mouse pointer on current image.
183 .IP \-\-get\-rectangle
184 Get rectangle co-ordinates.
187 .IP \-\-get\-render\-intent
191 .IP \-\-get\-filelist:[<FOLDER>]
192 Get list of files and class.
195 .IP \-\-get\-filelist-recurse:[<FOLDER>]
196 Get list of file and class recursive.
199 .IP \-\-get\-collection:<COLLECTION>
200 Get collection content.
203 .IP \-\-get\-collection\-list
208 Open FILE in new window.
212 Open FILE in new window.
216 Clear command line collection list.
219 .IP \-\-list-add:<FILE>
220 Add FILE to command line collection list.
224 Bring the Geeqie window to the top.
228 Bring the Geeqie window to the top.
232 Window ID for following commands.
243 .IP \-ct:clear|clean,\-\-cache-thumbs:clear|clean
244 Clear or clean thumbnail cache.
247 .IP \-cs:clear|clean,\-\-cache-shared:clear|clean
248 Clear or clean shared thumbnail cache.
251 .IP \-cm,\-\-cache-metadata
252 Clean metadata cache.
255 .IP \-cr:<folder>,\-\-cache-render:<folder>
259 .IP \-crr:<folder>,\-\-cache-render-recurse:<folder>
260 Render thumbnails recursively.
263 .IP \-crs:<folder>,\-\-cache-render-shared:<folder>
264 Render thumbnails (see Help).
267 .IP \-crsr:<folder>,\-\-cache-render-shared-recurse:<folder>
268 Render thumbnails recursively (see Help).
271 .IP \-\-lua:<FILE>,<lua-script>
272 Run lua script on FILE.
276 Use PWD as working directory for following commands.
280 Terminate returned data with null character instead of newline.
284 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.
287 (on image) next image
290 .IP middle-mouse-click
291 (on image) previous image
298 .IP middle-mouse-drag
299 drag and drop operations
303 (on image) Changes to the next or previous image, or if option is enabled, scrolls the image vertically.
306 .IP mouse-wheel+Shift-key
307 (on image) Inverts the mouse wheel behavior between scrolling image or changing image.
310 .IP mouse-wheel+Control-key
311 (on image) Zooms the image in and out.
332 tab completion in path entry window
336 cancel completion in path entry window or stop generating thumbnails
339 Keys that are valid when the image part of the window is focused.
356 .SS FILE RELATED KEYS
367 open the Find Duplicates window
401 .SS EDIT MENU RELATED KEYS
416 go to the Configuration window
420 display image properties
424 rotate image clockwise
428 rotate image counterclockwise
432 rotate image 180 degrees
436 mirror image (horizontal)
440 flip image (vertical)
442 .SS VIEW MENU RELATED KEYS
453 zoom to original size
461 zoom in to X scale factor
465 zoom to \-2, \-3, \-4, respectively
469 toggle thumbnail display
473 display files in list format
477 display files in icon format
481 toggle tree view for directories
489 toggle floating of file selection area
493 toggle hiding of file selection area
497 toggle full-screen mode
501 toggle slide-show mode
505 toggle pause of slideshow
509 toggle display of exif sidebar
513 toggle display of sort manager
515 .SS COLLECTION WINDOW KEYS
522 select multiple images
526 move selector without changing selection
530 select the image under the selector
534 toggle selection of the image under the selector
538 move selector to the top image
542 move selector to bottom image
544 Adding Shift or Control to Home and End has a similar effect as adding them to the arrows.
555 remove image form collection (does not delete the file)
559 add images to collection form main file list
563 sort collection by name
567 sort collection by date
571 sort collection by file size
575 sort collection by pathname
579 sort collection by name numerically (*)
583 view image under selector in the main image window
587 view image under selector in new window
591 open selected image(s) in external editor
603 append current collection to existing collection
615 rename selected files
619 delete selected files
625 .SS DUPLICATES WINDOW KEYS
636 select group 1 images
640 select group 2 images
644 add images from main window file list
648 add selected images to new collection
652 remove selected images from list
660 view image with focus in main window
664 view image with focus in new window
668 open selected image(s) in editor
672 display properties window for selected images
684 rename selected files
688 delete selected files
696 The following data lists the locations Geeqie uses for various actions. The
697 uppercase symbols are environment variables. If they are not set on your system
698 the fallback locations are listed in parentheses. Geeqie will first attempt to
699 load a configuration file from:
701 .B /etc/geeqie/geeqierc.xml
703 It will then continue with the following locations.
704 Most of Geeqie's configuration files are contained in the folder, and sub-folders of:
706 .B $XDG_CONFIG_HOME/geeqie/
707 .B ($~/.config/geeqie/)
709 Geeqie's standard configuration file is:
713 An alternative configuration file may be used by executing:
715 .B geeqie -r --config-load:<filename>
717 Geeqie-created desktop files used by Plugins are in the folder:
721 Lua script files for Lua Extensions are in the folder:
725 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:
729 Keyboard shortcut maps are contained in this text file:
733 The location for Collections is in the folder:
735 .B $XDG_DATA_HOME/geeqie/collections
737 .B ($~/.local/share/geeqie/collections)
739 The lirc Infra-red controller configuration file must be located at:
743 Thumbnails are stored in a location specified in Thumbnail Preferences
745 Metadata is stored either in the image file or in the location specified in Safe Delete
747 The safe delete folder is specified in the Metadata tab of main Preferences
750 Copyright (C) 1999-2004 by John Ellis.
751 Copyright (C) 2004-2017 by The Geeqie Team.
752 Use this software at your own risk!
753 This software released under the GNU General Public License. Please read the COPYING file for more information.
755 Please send bug reports and feedback to https://github.com/BestImageViewer/geeqie/issues
760 Manpage originally prepared by