Preparing for release v2.0
[geeqie.git] / geeqie.1
1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.1.
2 .TH GEEQIE "1" "August 2022" "Geeqie 2.0 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
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\-sidecars\fR:<FILE>
156 get list of sidecars of FILE
157 .TP
158 \fB\-\-id\fR:<ID>
159 window id for following commands
160 .TP
161 \fB\-\-last\fR
162 last image
163 .TP
164 \fB\-\-list\-add\fR:<FILE>
165 add FILE to command line collection list
166 .TP
167 \fB\-\-list\-clear\fR
168 clear command line collection list
169 .TP
170 \fB\-\-lua\fR:<FILE>,<lua script>
171 run lua script on FILE
172 .TP
173 \fB\-\-new\-window\fR
174 new window
175 .TP
176 \fB\-n\fR   \fB\-\-next\fR
177 next image
178 .TP
179 \fB\-\-pixel\-info\fR
180 print pixel info of mouse pointer on current image
181 .TP
182 \fB\-\-print0\fR
183 terminate returned data with null character instead of newline
184 .TP
185 \fB\-\-PWD\fR:<PWD>
186 use PWD as working directory for following commands
187 .TP
188 \fB\-q\fR   \fB\-\-quit\fR
189 quit
190 .TP
191 \fB\-\-raise\fR
192 bring the Geeqie window to the top
193 .TP
194 raise
195 bring the Geeqie window to the top
196 .TP
197 \fB\-s\fR   \fB\-\-slideshow\fR
198 toggle slide show
199 .TP
200 \fB\-\-slideshow\-recurse\fR:<FOLDER>
201 start recursive slide show in FOLDER
202 .TP
203 \fB\-ss\fR  \fB\-\-slideshow\-start\fR
204 start slide show
205 .TP
206 \fB\-sS\fR  \fB\-\-slideshow\-stop\fR
207 stop slide show
208 .TP
209 \fB\-\-tell\fR
210 print filename [and Collection] of current image
211 .TP
212 +t   \fB\-\-tools\-show\fR
213 show tools
214 .TP
215 \fB\-t\fR   \fB\-\-tools\-hide\fR
216 hide tools
217 .TP
218 \fB\-\-view\fR:<FILE>
219 open FILE in new window
220 .TP
221 view:<FILE>
222 open FILE in new window
223 .IP
224 All other command line parameters are used as plain files if they exist.
225 .IP
226 The name of a collection, with or without either path or extension (.gqv) may be used.
227 .SH BUGS
228 Please send bug reports and feedback to https://github.com/BestImageViewer/geeqie/issues
229 .SH COPYRIGHT
230 Copyright (C) 1999-2004 by John Ellis. Copyright (C) 2004-2022 by The Geeqie Team. Use this software  at  your
231 own  risk! This  software released under the GNU General Public License. Please read the COPYING file for more
232 information.
233 .SH "SEE ALSO"
234 Full documentation: https://www.geeqie.org/help/GuideIndex.html