X-Git-Url: http://geeqie.org/cgi-bin/gitweb.cgi?p=geeqie.git;a=blobdiff_plain;f=geeqie.1;h=430b266ff2b9b6cf571217be19fdf0aa25cb83a2;hp=23486a0612e62c18c471b685a74c01dc69416063;hb=refs%2Fheads%2Fmaster;hpb=bb224a9fd6d794525076129c7e123445cb87ef74 diff --git a/geeqie.1 b/geeqie.1 index 23486a06..45d716bf 100644 --- a/geeqie.1 +++ b/geeqie.1 @@ -1,649 +1,249 @@ -.\"Created with GNOME Manpages Editor -.\"http://gmanedit.sourceforge.net -.\"Sergio Rua -.\" -.\" -.\" Geeqie manual page. -.\" (C)2004 John Ellis -.\" -.\" This document is free to modify and distribute. -.\" -.TH geeqie 1 "Geeqie" - +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. +.TH GEEQIE "1" "April 2024" "Geeqie 2.4+git20240413-fc816858 GTK3" "User Commands" .SH NAME -Geeqie \- GTK based multiformat image viewer +Geeqie - GTK based multiformat image viewer .SH SYNOPSIS .B geeqie -.RI [ options ] -.RI [ path ] -.br - +[\fI\,options\/\fR] [\fI\,path\/\fR] .SH DESCRIPTION -\fBGeeqie\fP is an interactive GTK based image viewer that supports multiple image formats, zooming, panning, thumbnails and sorting images into collections. - -.SH OPTIONS -.B -.IP \+t,\-\-with\-tools -Force the toolbox to be shown. -.br -.B -.IP \-t,\-\-without\-tools -Force the toolbox to be hidden. -.br -.B -.IP \-f,\-\-fullscreen -Start in full screen mode. -.br -.B -.IP \-s,\-\-slideshow -Start in slideshow mode. -.br -.B -.IP \-l,\-\-list[files...][collections...] -Open collection window for command line files. -.br -.B -.IP \-\-blank -Start with blank file list. -.br -.B -.IP \-\-geometry=XxY+XOFF+YOFF -Set main window location. -.br -.B -.IP \-r,\-\-remote -Send following commands to open window. -.br -.B -.IP \-rh,\-\-remote-help -Print remote command list. -.br -.B -.IP \-\-debug[=level] -Turn on debugging output. -.br -.B -.IP \-g:,\-\-grep: -Filter debug output. -.br -.B -.IP \+w,\-\-show-log-window -Show log window. -.br -.B -.IP \-o:,\-\-log-file: -Save log data to FILE. -.br -.B -.IP \-v,\-\-version -Print version. -.br -.B -.IP \-h,\-\-help -Print command line options. - -.SH REMOTE OPTIONS -.B -.IP \-n,\-\-next -Next image. -.br -.B -.IP \-b,\-\-back -Previous image. -.br -.B -.IP \-\-first -First image. -.br -.B -.IP \-\-last -Last image. -.br -.B -.IP \-f,\-\-fullscreen -Toggle full screen. -.br -.B -.IP \-fs,\-\-fullscreen-start -Start full screen. -.br -.B -.IP \-fS,\-\-fullscreen-stop -Stop full screen. -.br -.B -.IP \-s,\-\-slideshow -Toggle slideshow. -.br -.B -.IP \-ss,\-\-slideshow-start -Start slideshow. -.br -.B -.IP \-sS,\-\-slideshow-stop -Stop slideshow. -.br -.B -.IP \-\-slideshow-recurse: -Start recursive slide show in FOLDER. -.br -.B -.IP \-d<[HRS:][MINS:][N][.M]>,\-\-delay=<[hrs:][mins][N][.M]> -Set slide show delay to Hrs Mins N.M seconds. -.br -.B -.IP \+t,\-\-tools-show -Show tools. -.br -.B -.IP \-t,\-\-tools-hide -Hide tools. -.br -.B -.IP \-q,\-\-quit -Quit. -.br -.B -.IP \-\-config-load: -Load configuration from FILE. -.br -.B -.IP \-\-get-sidecars: -Get list of sidecars of FILE. -.br -.B -.IP \-\-get-destination: -Get destination path of FILE. -.br -.B -.IP \-\-file: -Open FILE, bring Geeqie window to the top. -.br -.B -.IP \-\-File: -Open FILE, do not bring Geeqie window to the top. -.br -.B -.IP \-\-tell -Print filename of current image. -.br -.B -.IP \-\-pixel\-info -Print X, Y and RGB of mouse pointer on current image. -.br -.B -.IP \-\-view: -Open FILE in new window. -.br -.B -.IP \-\-list-clear -Clear command line collection list. -.br -.B -.IP \-\-list-add: -Add FILE to command line collection list. -.br -.B -.IP raise -Bring the Geeqie window to the top. -.br -.B -.IP \-ct:clear|clean,\-\-cache-thumbs:clear|clean -Clear or clean thumbnail cache. -.br -.B -.IP \-cs:clear|clean,\-\-cache-shared:clear|clean -Clear or clean shared thumbnail cache. -.br -.B -.IP \-cm,\-\-cache-metadata -Clean metadata cache. -.br -.B -.IP \-cr:,\-\-cache-render: -Render thumbnails. -.br -.B -.IP \-crr:,\-\-cache-render-recurse: -Render thumbnails recursively. -.br -.B -.IP \-crs:,\-\-cache-render-shared: -Render thumbnails (see Help). -.br -.B -.IP \-crsr:,\-\-cache-render-shared-recurse: -Render thumbnails recursively (see Help). -.br -.B -.IP \-\-lua:, -Run lua script on FILE. -.br +Geeqie is an interactive GTK based image viewer that supports multiple image formats, +zooming, panning, thumbnails and sorting images into collections. -.SH USAGE -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. -.B -.IP left-mouse-click -(on image) next image -.br -.B -.IP middle-mouse-click -(on image) previous image -.br -.B -.IP right-mouse -context menu -.br -.B -.IP middle-mouse-drag -drag and drop operations -.br -.B -.IP mouse-wheel -(on image) Changes to the next or previous image, or if option is enabled, scrolls the image vertically. -.br -.B -.IP mouse-wheel+Shift-key -(on image) Inverts the mouse wheel behavior between scrolling image or changing image. -.br -.B -.IP mouse-wheel+Control-key -(on image) Zooms the image in and out. -.br -.SS GENERAL KEYS -.B -.IP PageDown -next image -.br -.B -.IP PageUp -previous image -.br -.B -.IP Home -first image in list -.br -.B -.IP End -last image in list -.br -.B -.IP Tab -tab completion in path entry window -.br -.B -.IP Escape -cancel completion in path entry window or stop generating thumbnails -.br -.SS IMAGE KEYS -Keys that are valid when the image part of the window is focused. -.B -.IP Arrows -pan image -.br -.B -.IP Shift+Arrows -pan image faster -.br -.B -.IP Space,N -next image -.br -.B -.IP Backspace,B +Generated for version: +.PP +Geeqie 2.4+git20240413\-fc816858 +.SS "Valid options:" +.TP +\fB\-\-blank\fR +start with blank file list +.TP +\fB\-\-cache\-maintenance=\fR +run cache maintenance in non\-GUI mode +.TP +\fB\-\-disable\-clutter\fR +disable use of Clutter library (i.e. GPU accel.) +.TP +\fB\-f\fR, \fB\-\-fullscreen\fR +start in full screen mode +.TP +\fB\-\-geometry\fR=\fI\,WxH\/\fR+XOFF+YOFF +set main window location +.TP +\fB\-h\fR, \fB\-\-help\fR +show this message +.HP +\fB\-l\fR, \fB\-\-list\fR [files] [collections] open collection window for command line +.TP +\fB\-n\fR, \fB\-\-new\-instance\fR +open a new instance of Geeqie * +.TP +\fB\-o\fR, \fB\-\-log\-file=\fR +save log data to file +.TP +\fB\-r\fR, \fB\-\-remote\fR +send following commands to open window +.TP +\fB\-\-remote\-help\fR +print remote command list +.TP +\fB\-s\fR, \fB\-\-slideshow\fR +start in slideshow mode +.TP +\fB\-T\fR, \fB\-\-with\-tools\fR +force show of tools +.TP +\fB\-t\fR, \fB\-\-without\-tools\fR +force hide of tools +.TP +\fB\-v\fR, \fB\-\-version\fR +print version info +.TP +\fB\-w\fR, \fB\-\-show\-log\-window\fR +show log window +.TP +\fB\-\-debug\fR[=\fI\,level\/\fR] +turn on debug output +.TP +\fB\-g\fR, \fB\-\-grep=\fR +filter debug output +.PP +* Normally a single set of configuration files is used for all instances. +However, the environment variables XDG_CONFIG_HOME, XDG_CACHE_HOME, XDG_DATA_HOME +can be used to modify this behavior on an individual basis e.g. +.PP +XDG_CONFIG_HOME=/tmp/a XDG_CACHE_HOME=/tmp/b geeqie +.SS "Remote command list:" +.TP +\fB\-\-action=\fR +execute keyboard action (See Help/Reference/Remote Keyboard Actions) +.TP +\fB\-\-action\-list\fR +list available keyboard actions (some are redundant) +.TP +\fB\-b\fR \fB\-\-back\fR previous image -.br -.SS FILE RELATED KEYS -.B -.IP C -new empty collection -.br -.B -.IP O -open collection -.br -.B -.IP D -open the Find Duplicates window -.br -.B -.IP C-F -new folder -.br -.B -.IP C-C -copy file -.br -.B -.IP C-M -move file -.br -.B -.IP C-R -rename file -.br -.B -.IP C-D,Delete -delete file -.br -.B -.IP C-N -new window -.br -.B -.IP C-W +.TP +\fB\-\-close\-window\fR close window -.br -.B -.IP C-Q +.TP +\fB\-\-config\-load=\fR|layout ID +load configuration from FILE +.TP +\fB\-\-cache\-metadata\fR +clean the metadata cache +.TP +\fB\-\-cache\-render=\fR +render thumbnails +.TP +\fB\-\-cache\-render\-recurse=\fR +render thumbnails recursively +.TP +\fB\-\-cache\-render\-shared=\fR +render thumbnails (see Help) +.TP +\fB\-\-cache\-render\-shared\-recurse=\fR +render thumbnails recursively (see Help) +.TP +\fB\-\-cache\-shared\fR=\fI\,clean\/\fR|clear +clean or clear shared thumbnail cache +.TP +\fB\-\-cache\-thumbs\fR=\fI\,clean\/\fR|clear +clean or clear thumbnail cache +.TP +\fB\-d\fR \fB\-\-delay=\fR<[H=][M=][N][.M]> +set slide show delay to Hrs Mins N.M seconds +.TP +\fB\-\-first\fR +first image +.TP +\fB\-f\fR \fB\-\-fullscreen\fR +toggle full screen +.TP +\fB\-\-file=\fR| +open FILE or URL, bring Geeqie window to the top +.TP +\fB\-\-File=\fR| +open FILE or URL, do not bring Geeqie window to the top +.TP +\fB\-\-fullscreen\-start\fR +start full screen +.TP +\fB\-\-fullscreen\-stop\fR +stop full screen +.TP +\fB\-\-geometry=\fR +set window geometry +.TP +\fB\-\-get\-collection=\fR +get collection content +.TP +\fB\-\-get\-collection\-list\fR +get collection list +.TP +\fB\-\-get\-destination=\fR +get destination path of FILE (See Plugins Configuration) +.TP +\fB\-\-get\-file\-info\fR +get file info +.TP +\fB\-\-get\-filelist\fR=\fI\,[\/\fR] +get list of files and class +.TP +\fB\-\-get\-filelist\-recurse\fR=\fI\,[\/\fR] +get list of files and class recursive +.TP +\fB\-\-get\-rectangle\fR +get rectangle co\-ordinates +.TP +\fB\-\-get\-render\-intent\fR +get render intent +.TP +\fB\-\-get\-selection\fR +get list of selected files +.TP +\fB\-\-get\-sidecars=\fR +get list of sidecars of FILE +.TP +\fB\-\-get\-window\-list\fR +get window list +.TP +\fB\-\-id=\fR +window id for following commands +.TP +\fB\-\-last\fR +last image +.TP +\fB\-\-list\-add=\fR +add FILE to command line collection list +.TP +\fB\-\-list\-clear\fR +clear command line collection list +.TP +\fB\-\-lua=\fR, +run lua script on FILE +.TP +\fB\-\-new\-window\fR +new window +.TP +\fB\-n\fR \fB\-\-next\fR +next image +.TP +\fB\-\-pixel\-info\fR +print pixel info of mouse pointer on current image +.TP +\fB\-\-print0\fR +terminate returned data with null character instead of newline +.TP +\fB\-\-PWD=\fR +use PWD as working directory for following commands +.TP +\fB\-q\fR \fB\-\-quit\fR quit -.br -.SS EDIT MENU RELATED KEYS -.B -.IP C-1,2..9,0 -run external editor -.br -.B -.IP C-A -select all files -.br -.B -.IP C-S-A -unselect all files -.br -.B -.IP C-O -go to the Configuration window -.br -.B -.IP C-P -display image properties -.br -.B -.IP ] -rotate image clockwise -.br -.B -.IP [ -rotate image counterclockwise -.br -.B -.IP S-R -rotate image 180 degrees -.br -.B -.IP S-M -mirror image (horizontal) -.br -.B -.IP S-F -flip image (vertical) -.br -.SS VIEW MENU RELATED KEYS -.B -.IP +,= -zoom in -.br -.B -.IP - -zoom out -.br -.B -.IP Z,KeyPad-/ -zoom to original size -.br -.B -.IP X,KeyPad-* -zoom to fit window -.br -.B -.IP 1,2,3,4 -zoom in to X scale factor -.br -.B -.IP 9,8,7 -zoom to \-2, \-3, \-4, respectively -.br -.B -.IP T -toggle thumbnail display -.br -.B -.IP C-L -display files in list format -.br -.B -.IP C-I -display files in icon format -.br -.B -.IP C-T -toggle tree view for directories -.br -.B -.IP R -refresh file list -.br -.B -.IP L -toggle floating of file selection area -.br -.B -.IP H -toggle hiding of file selection area -.br -.B -.IP F,V -toggle full-screen mode -.br -.B -.IP S -toggle slide-show mode -.br -.B -.IP P -toggle pause of slideshow -.br -.B -.IP C-E -toggle display of exif sidebar -.br -.B -.IP C-S -toggle display of sort manager -.br -.SS COLLECTION WINDOW KEYS -.B -.IP Arrows -move selection -.br -.B -.IP Shift+Arrows -select multiple images -.br -.B -.IP Control+Arrows -move selector without changing selection -.br -.B -.IP Space -select the image under the selector -.br -.B -.IP Control+Space -toggle selection of the image under the selector -.br -.B -.IP Home -move selector to the top image -.br -.B -.IP End -move selector to bottom image -.br -Adding Shift or Control to Home and End has a similar effect as adding them to the arrows. -.B -.IP C-A -select all images -.br -.B -.IP C-S-A -unselect all images -.br -.B -.IP Delete -remove image form collection (does not delete the file) -.br -.B -.IP C-L -add images to collection form main file list -.br -.B -.IP N -sort collection by name -.br -.B -.IP D -sort collection by date -.br -.B -.IP B -sort collection by file size -.br -.B -.IP P -sort collection by pathname -.br -.B -.IP I -sort collection by name numerically (*) -.br -.B -.IP Enter -view image under selector in the main image window -.br -.B -.IP V -view image under selector in new window -.br -.B -.IP C-1,2..9,0 -open selected image(s) in external editor -.br -.B -.IP S -save collection -.br -.B -.IP C-S -save collection as -.br -.B -.IP A -append current collection to existing collection -.br -.B -.IP C-C -copy selected files -.br -.B -.IP C-M -move selected files -.br -.B -.IP C-R -rename selected files -.br -.B -.IP C-D -delete selected files -.br -.B -.IP C-W -close window -.br -.SS DUPLICATES WINDOW KEYS -.B -.IP C-A -select all images -.br -.B -.IP C-S-A -unselect all images -.br -.B -.IP 1 -select group 1 images -.br -.B -.IP 2 -select group 2 images -.br -.B -.IP C-L -add images from main window file list -.br -.B -.IP C -add selected images to new collection -.br -.B -.IP Delete -remove selected images from list -.br -.B -.IP C-Delete -clear window -.br -.B -.IP Enter -view image with focus in main window -.br -.B -.IP V -view image with focus in new window -.br -.B -.IP C-1,2..9,0 -open selected image(s) in editor -.br -.B -.IP C-P -display properties window for selected images -.br -.B -.IP C-C -copy selected files -.br -.B -.IP C-M -move selected files -.br -.B -.IP C-R -rename selected files -.br -.B -.IP C-D -delete selected files -.br -.B -.IP C-W -close window -.br - - -.SH LICENSE -Copyright (C) 1999-2004 by John Ellis. -Copyright (C) 2004-2017 by The Geeqie Team. -Use this software at your own risk! -This software released under the GNU General Public License. Please read the COPYING file for more information. +.TP +\fB\-\-raise\fR +bring the Geeqie window to the top +.TP +\fB\-\-selection\-add\fR=\fI\,[\/\fR] +adds the current file (or the specified file) to the current selection +.TP +\fB\-\-selection\-clear\fR +clears the current selection +.TP +\fB\-\-selection\-remove\fR=\fI\,[\/\fR] +removes the current file (or the specified file) from the current selection +.TP +\fB\-s\fR \fB\-\-slideshow\fR +toggle slide show +.TP +\fB\-\-slideshow\-recurse=\fR +start recursive slide show in FOLDER +.TP +\fB\-\-slideshow\-start\fR +start slide show +.TP +\fB\-\-slideshow\-stop\fR +stop slide show +.TP +\fB\-\-tell\fR +print filename [and Collection] of current image +.TP +\fB\-T\fR \fB\-\-tools\-show\fR +show tools +.TP +\fB\-t\fR \fB\-\-tools\-hide\fR +hide tools +.TP +\fB\-\-view=\fR +open FILE in new window +.IP +All other command line parameters are used as plain files if they exist. +.IP +The name of a collection, with or without either path or extension (.gqv) may be used. .SH BUGS Please send bug reports and feedback to https://github.com/BestImageViewer/geeqie/issues -.SH AUTHOR -.B John Ellis - -.br -Manpage originally prepared by -.B Nick Rusnov - +.SH COPYRIGHT +Copyright (C) 1999-2004 by John Ellis. Copyright (C) 2004-2024 by The Geeqie Team. Use this software at your +own risk! This software released under the GNU General Public License. Please read the COPYING file for more +information. +.SH "SEE ALSO" +Full documentation: https://www.geeqie.org/help/GuideIndex.html