Some command line options are not GNU/POSIX compliant (3)
[geeqie.git] / geeqie.1
1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
2 .TH GEEQIE "1" "April 2024" "Geeqie 2.4+git20240413-fc816858 GTK3" "User Commands"
3 .SH NAME
4 Geeqie - GTK based multiformat image viewer
5 .SH SYNOPSIS
6 .B geeqie
7 [\fI\,options\/\fR] [\fI\,path\/\fR]
8 .SH DESCRIPTION
9 Geeqie is an interactive GTK based image viewer that supports multiple image formats,
10 zooming, panning, thumbnails and sorting images into collections.
11
12 Generated for version:
13 .PP
14 Geeqie 2.4+git20240413\-fc816858
15 .SS "Valid options:"
16 .TP
17 \fB\-\-blank\fR
18 start with blank file list
19 .TP
20 \fB\-\-cache\-maintenance=\fR<path>
21 run cache maintenance in non\-GUI mode
22 .TP
23 \fB\-\-disable\-clutter\fR
24 disable use of Clutter library (i.e. GPU accel.)
25 .TP
26 \fB\-f\fR, \fB\-\-fullscreen\fR
27 start in full screen mode
28 .TP
29 \fB\-\-geometry\fR=\fI\,WxH\/\fR+XOFF+YOFF
30 set main window location
31 .TP
32 \fB\-h\fR, \fB\-\-help\fR
33 show this message
34 .HP
35 \fB\-l\fR, \fB\-\-list\fR [files] [collections] open collection window for command line
36 .TP
37 \fB\-n\fR, \fB\-\-new\-instance\fR
38 open a new instance of Geeqie *
39 .TP
40 \fB\-o\fR, \fB\-\-log\-file=\fR<file>
41 save log data to file
42 .TP
43 \fB\-r\fR, \fB\-\-remote\fR
44 send following commands to open window
45 .TP
46 \fB\-\-remote\-help\fR
47 print remote command list
48 .TP
49 \fB\-s\fR, \fB\-\-slideshow\fR
50 start in slideshow mode
51 .TP
52 \fB\-T\fR, \fB\-\-with\-tools\fR
53 force show of tools
54 .TP
55 \fB\-t\fR, \fB\-\-without\-tools\fR
56 force hide of tools
57 .TP
58 \fB\-v\fR, \fB\-\-version\fR
59 print version info
60 .TP
61 \fB\-w\fR, \fB\-\-show\-log\-window\fR
62 show log window
63 .TP
64 \fB\-\-debug\fR[=\fI\,level\/\fR]
65 turn on debug output
66 .TP
67 \fB\-g\fR, \fB\-\-grep=\fR<regexp>
68 filter debug output
69 .PP
70 * Normally a single set of configuration files is used for all instances.
71 However, the environment variables XDG_CONFIG_HOME, XDG_CACHE_HOME, XDG_DATA_HOME
72 can be used to modify this behavior on an individual basis e.g.
73 .PP
74 XDG_CONFIG_HOME=/tmp/a XDG_CACHE_HOME=/tmp/b geeqie
75 .SS "Remote command list:"
76 .TP
77 \fB\-\-action=\fR<ACTION>
78 execute keyboard action (See Help/Reference/Remote Keyboard Actions)
79 .TP
80 \fB\-\-action\-list\fR
81 list available keyboard actions (some are redundant)
82 .TP
83 \fB\-b\fR   \fB\-\-back\fR
84 previous image
85 .TP
86 \fB\-\-close\-window\fR
87 close window
88 .TP
89 \fB\-\-config\-load=\fR<FILE>|layout ID
90 load configuration from FILE
91 .TP
92 \fB\-\-cache\-metadata\fR
93 clean the metadata cache
94 .TP
95 \fB\-\-cache\-render=\fR<folder>
96 render thumbnails
97 .TP
98 \fB\-\-cache\-render\-recurse=\fR<folder>
99 render thumbnails recursively
100 .TP
101 \fB\-\-cache\-render\-shared=\fR<folder>
102 render thumbnails (see Help)
103 .TP
104 \fB\-\-cache\-render\-shared\-recurse=\fR<folder>
105 render thumbnails recursively (see Help)
106 .TP
107 \fB\-\-cache\-shared\fR=\fI\,clean\/\fR|clear
108 clean or clear shared thumbnail cache
109 .TP
110 \fB\-\-cache\-thumbs\fR=\fI\,clean\/\fR|clear
111 clean or clear thumbnail cache
112 .TP
113 \fB\-d\fR   \fB\-\-delay=\fR<[H=][M=][N][.M]>
114 set slide show delay to Hrs Mins N.M seconds
115 .TP
116 \fB\-\-first\fR
117 first image
118 .TP
119 \fB\-f\fR   \fB\-\-fullscreen\fR
120 toggle full screen
121 .TP
122 \fB\-\-file=\fR<FILE>|<URL>
123 open FILE or URL, bring Geeqie window to the top
124 .TP
125 \fB\-\-File=\fR<FILE>|<URL>
126 open FILE or URL, do not bring Geeqie window to the top
127 .TP
128 \fB\-\-fullscreen\-start\fR
129 start full screen
130 .TP
131 \fB\-\-fullscreen\-stop\fR
132 stop full screen
133 .TP
134 \fB\-\-geometry=\fR<GEOMETRY>
135 set window geometry
136 .TP
137 \fB\-\-get\-collection=\fR<COLLECTION>
138 get collection content
139 .TP
140 \fB\-\-get\-collection\-list\fR
141 get collection list
142 .TP
143 \fB\-\-get\-destination=\fR<FILE>
144 get destination path of FILE (See Plugins Configuration)
145 .TP
146 \fB\-\-get\-file\-info\fR
147 get file info
148 .TP
149 \fB\-\-get\-filelist\fR=\fI\,[\/\fR<FOLDER>]
150 get list of files and class
151 .TP
152 \fB\-\-get\-filelist\-recurse\fR=\fI\,[\/\fR<FOLDER>]
153 get list of files and class recursive
154 .TP
155 \fB\-\-get\-rectangle\fR
156 get rectangle co\-ordinates
157 .TP
158 \fB\-\-get\-render\-intent\fR
159 get render intent
160 .TP
161 \fB\-\-get\-selection\fR
162 get list of selected files
163 .TP
164 \fB\-\-get\-sidecars=\fR<FILE>
165 get list of sidecars of FILE
166 .TP
167 \fB\-\-get\-window\-list\fR
168 get window list
169 .TP
170 \fB\-\-id=\fR<ID>
171 window id for following commands
172 .TP
173 \fB\-\-last\fR
174 last image
175 .TP
176 \fB\-\-list\-add=\fR<FILE>
177 add FILE to command line collection list
178 .TP
179 \fB\-\-list\-clear\fR
180 clear command line collection list
181 .TP
182 \fB\-\-lua=\fR<FILE>,<lua script>
183 run lua script on FILE
184 .TP
185 \fB\-\-new\-window\fR
186 new window
187 .TP
188 \fB\-n\fR   \fB\-\-next\fR
189 next image
190 .TP
191 \fB\-\-pixel\-info\fR
192 print pixel info of mouse pointer on current image
193 .TP
194 \fB\-\-print0\fR
195 terminate returned data with null character instead of newline
196 .TP
197 \fB\-\-PWD=\fR<PWD>
198 use PWD as working directory for following commands
199 .TP
200 \fB\-q\fR   \fB\-\-quit\fR
201 quit
202 .TP
203 \fB\-\-raise\fR
204 bring the Geeqie window to the top
205 .TP
206 \fB\-\-selection\-add\fR=\fI\,[\/\fR<FILE>]
207 adds the current file (or the specified file) to the current selection
208 .TP
209 \fB\-\-selection\-clear\fR
210 clears the current selection
211 .TP
212 \fB\-\-selection\-remove\fR=\fI\,[\/\fR<FILE>]
213 removes the current file (or the specified file) from the current selection
214 .TP
215 \fB\-s\fR   \fB\-\-slideshow\fR
216 toggle slide show
217 .TP
218 \fB\-\-slideshow\-recurse=\fR<FOLDER>
219 start recursive slide show in FOLDER
220 .TP
221 \fB\-\-slideshow\-start\fR
222 start slide show
223 .TP
224 \fB\-\-slideshow\-stop\fR
225 stop slide show
226 .TP
227 \fB\-\-tell\fR
228 print filename [and Collection] of current image
229 .TP
230 \fB\-T\fR   \fB\-\-tools\-show\fR
231 show tools
232 .TP
233 \fB\-t\fR   \fB\-\-tools\-hide\fR
234 hide tools
235 .TP
236 \fB\-\-view=\fR<FILE>
237 open FILE in new window
238 .IP
239 All other command line parameters are used as plain files if they exist.
240 .IP
241 The name of a collection, with or without either path or extension (.gqv) may be used.
242 .SH BUGS
243 Please send bug reports and feedback to https://github.com/BestImageViewer/geeqie/issues
244 .SH COPYRIGHT
245 Copyright (C) 1999-2004 by John Ellis. Copyright (C) 2004-2024 by The Geeqie Team. Use this software  at  your
246 own  risk! This  software released under the GNU General Public License. Please read the COPYING file for more
247 information.
248 .SH "SEE ALSO"
249 Full documentation: https://www.geeqie.org/help/GuideIndex.html