Revert "FIXME: this can be rather slow and blocks until the size is known"
[geeqie.git] / geeqie.1
1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.2.
2 .TH GEEQIE "1" "March 2023" "Geeqie 2.0+git20230323-96b2cd4e 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.0+git20230323\-96b2cd4e
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\-rh\fR, \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 +t, \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 +w, \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 .SS "Remote command list:"
70 .TP
71 \fB\-b\fR   \fB\-\-back\fR
72 previous image
73 .TP
74 \fB\-\-close\-window\fR
75 close window
76 .TP
77 \fB\-\-config\-load\fR:<FILE>|layout ID
78 load configuration from FILE
79 .TP
80 \fB\-cm\fR  \fB\-\-cache\-metadata\fR
81 clean the metadata cache
82 .TP
83 \fB\-cr\fR: \fB\-\-cache\-render\fR:<folder>
84 render thumbnails
85 .TP
86 \fB\-crr\fR: \fB\-\-cache\-render\-recurse\fR:<folder>
87 render thumbnails recursively
88 .TP
89 \fB\-crs\fR: \fB\-\-cache\-render\-shared\fR:<folder>
90 render thumbnails (see Help)
91 .TP
92 \fB\-crsr\fR: \fB\-\-cache\-render\-shared\-recurse\fR:<folder>
93 render thumbnails recursively (see Help)
94 .TP
95 \fB\-cs\fR: \fB\-\-cache\-shared\fR:clear|clean
96 clear or clean shared thumbnail cache
97 .TP
98 \fB\-ct\fR: \fB\-\-cache\-thumbs\fR:clear|clean
99 clear or clean thumbnail cache
100 .TP
101 \fB\-d\fR   \fB\-\-delay=\fR<[H:][M:][N][.M]>
102 set slide show delay to Hrs Mins N.M seconds
103 .TP
104 \fB\-\-first\fR
105 first image
106 .TP
107 \fB\-f\fR   \fB\-\-fullscreen\fR
108 toggle full screen
109 .TP
110 \fB\-\-file\fR:<FILE>|<URL>
111 open FILE or URL, bring Geeqie window to the top
112 .TP
113 file:<FILE>|<URL>
114 open FILE or URL, bring Geeqie window to the top
115 .TP
116 \fB\-\-File\fR:<FILE>|<URL>
117 open FILE or URL, do not bring Geeqie window to the top
118 .TP
119 File:<FILE>|<URL>
120 open FILE or URL, do not bring Geeqie window to the top
121 .TP
122 \fB\-fs\fR  \fB\-\-fullscreen\-start\fR
123 start full screen
124 .TP
125 \fB\-fS\fR  \fB\-\-fullscreen\-stop\fR
126 stop full screen
127 .TP
128 \fB\-\-geometry=\fR<GEOMETRY>
129 set window geometry
130 .TP
131 \fB\-\-get\-collection\fR:<COLLECTION>
132 get collection content
133 .TP
134 \fB\-\-get\-collection\-list\fR
135 get collection list
136 .TP
137 \fB\-\-get\-destination\fR:<FILE>
138 get destination path of FILE (See Plugins Configuration)
139 .TP
140 \fB\-\-get\-file\-info\fR
141 get file info
142 .TP
143 \fB\-\-get\-filelist\fR:[<FOLDER>]
144 get list of files and class
145 .TP
146 \fB\-\-get\-filelist\-recurse\fR:[<FOLDER>]
147 get list of files and class recursive
148 .TP
149 \fB\-\-get\-rectangle\fR
150 get rectangle co\-ordinates
151 .TP
152 \fB\-\-get\-render\-intent\fR
153 get render intent
154 .TP
155 \fB\-\-get\-selection\fR
156 get list of selected files
157 .TP
158 \fB\-\-get\-sidecars\fR:<FILE>
159 get list of sidecars of FILE
160 .TP
161 \fB\-\-id\fR:<ID>
162 window id for following commands
163 .TP
164 \fB\-\-last\fR
165 last image
166 .TP
167 \fB\-\-list\-add\fR:<FILE>
168 add FILE to command line collection list
169 .TP
170 \fB\-\-list\-clear\fR
171 clear command line collection list
172 .TP
173 \fB\-\-lua\fR:<FILE>,<lua script>
174 run lua script on FILE
175 .TP
176 \fB\-\-new\-window\fR
177 new window
178 .TP
179 \fB\-n\fR   \fB\-\-next\fR
180 next image
181 .TP
182 \fB\-\-pixel\-info\fR
183 print pixel info of mouse pointer on current image
184 .TP
185 \fB\-\-print0\fR
186 terminate returned data with null character instead of newline
187 .TP
188 \fB\-\-PWD\fR:<PWD>
189 use PWD as working directory for following commands
190 .TP
191 \fB\-q\fR   \fB\-\-quit\fR
192 quit
193 .TP
194 \fB\-\-raise\fR
195 bring the Geeqie window to the top
196 .TP
197 raise
198 bring the Geeqie window to the top
199 .TP
200 \fB\-\-selection\-add\fR:[<FILE>]
201 adds the current file (or the specified file) to the current selection
202 .TP
203 \fB\-\-selection\-clear\fR
204 clears the current selection
205 .TP
206 \fB\-\-selection\-remove\fR:[<FILE>]
207 removes the current file (or the specified file) from the current selection
208 .TP
209 \fB\-s\fR   \fB\-\-slideshow\fR
210 toggle slide show
211 .TP
212 \fB\-\-slideshow\-recurse\fR:<FOLDER>
213 start recursive slide show in FOLDER
214 .TP
215 \fB\-ss\fR  \fB\-\-slideshow\-start\fR
216 start slide show
217 .TP
218 \fB\-sS\fR  \fB\-\-slideshow\-stop\fR
219 stop slide show
220 .TP
221 \fB\-\-tell\fR
222 print filename [and Collection] of current image
223 .TP
224 +t   \fB\-\-tools\-show\fR
225 show tools
226 .TP
227 \fB\-t\fR   \fB\-\-tools\-hide\fR
228 hide tools
229 .TP
230 \fB\-\-view\fR:<FILE>
231 open FILE in new window
232 .TP
233 view:<FILE>
234 open FILE in new window
235 .IP
236 All other command line parameters are used as plain files if they exist.
237 .IP
238 The name of a collection, with or without either path or extension (.gqv) may be used.
239 .SH BUGS
240 Please send bug reports and feedback to https://github.com/BestImageViewer/geeqie/issues
241 .SH COPYRIGHT
242 Copyright (C) 1999-2004 by John Ellis. Copyright (C) 2004-2023 by The Geeqie Team. Use this software  at  your
243 own  risk! This  software released under the GNU General Public License. Please read the COPYING file for more
244 information.
245 .SH "SEE ALSO"
246 Full documentation: https://www.geeqie.org/help/GuideIndex.html