1 <?xml version="1.0" encoding="UTF-8"?>
2 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
4 <!-- lifted from man+troff by doclifter -->
5 <refentry id='geeqie1'>
6 <!-- DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.4. -->
8 <refentrytitle>GEEQIE</refentrytitle>
9 <manvolnum>1</manvolnum>
10 <refmiscinfo class='source'>January 2022</refmiscinfo>
11 <refmiscinfo class='manual'>Geeqie 1.7 GTK3</refmiscinfo>
14 <refname>Geeqie</refname>
15 <refpurpose>GTK based multiformat image viewer</refpurpose>
17 <!-- body begins here -->
18 <refsynopsisdiv id='synopsis'>
20 <command>geeqie</command>
21 <arg choice='opt'><replaceable>options</replaceable></arg>
22 <arg choice='opt'><replaceable>path</replaceable></arg>
27 <refsect1 id='description'><title>DESCRIPTION</title>
28 <para>Geeqie is an interactive GTK based image viewer that supports multiple image formats,
29 zooming, panning, thumbnails and sorting images into collections.</para>
31 <para>Generated for version:</para>
33 <para>Geeqie 1.7</para>
35 <refsect2 id='valid_options'><title>Valid options:</title>
36 <variablelist remap='TP'>
38 <term><emphasis role='strong' remap='B'>--blank</emphasis></term>
40 <para>start with blank file list</para>
44 <term><emphasis role='strong' remap='B'>--cache-maintenance</emphasis> <path></term>
46 <para>run cache maintenance in non-GUI mode</para>
50 <term><emphasis role='strong' remap='B'>--disable-clutter</emphasis></term>
52 <para>disable use of Clutter library (i.e. GPU accel.)</para>
56 <term><emphasis role='strong' remap='B'>-f</emphasis>, <emphasis role='strong' remap='B'>--fullscreen</emphasis></term>
58 <para>start in full screen mode</para>
62 <term><emphasis role='strong' remap='B'>--geometry</emphasis>=<emphasis remap='I'>WxH</emphasis>+XOFF+YOFF</term>
64 <para>set main window location</para>
68 <term><emphasis role='strong' remap='B'>-h</emphasis>, <emphasis role='strong' remap='B'>--help</emphasis></term>
70 <para>show this message</para>
75 <para><emphasis role='strong' remap='B'>-l</emphasis>, <emphasis role='strong' remap='B'>--list</emphasis> [files] [collections] open collection window for command line</para>
76 <variablelist remap='TP'>
78 <term><emphasis role='strong' remap='B'>-n</emphasis>, <emphasis role='strong' remap='B'>--new-instance</emphasis></term>
80 <para>open a new instance of Geeqie</para>
84 <term><emphasis role='strong' remap='B'>-o</emphasis>:, <emphasis role='strong' remap='B'>--log-file</emphasis>:<file></term>
86 <para>save log data to file</para>
90 <term><emphasis role='strong' remap='B'>-r</emphasis>, <emphasis role='strong' remap='B'>--remote</emphasis></term>
92 <para>send following commands to open window</para>
96 <term><emphasis role='strong' remap='B'>-rh</emphasis>, <emphasis role='strong' remap='B'>--remote-help</emphasis></term>
98 <para>print remote command list</para>
102 <term><emphasis role='strong' remap='B'>-s</emphasis>, <emphasis role='strong' remap='B'>--slideshow</emphasis></term>
104 <para>start in slideshow mode</para>
108 <term>+t, <emphasis role='strong' remap='B'>--with-tools</emphasis></term>
110 <para>force show of tools</para>
114 <term><emphasis role='strong' remap='B'>-t</emphasis>, <emphasis role='strong' remap='B'>--without-tools</emphasis></term>
116 <para>force hide of tools</para>
120 <term><emphasis role='strong' remap='B'>-v</emphasis>, <emphasis role='strong' remap='B'>--version</emphasis></term>
122 <para>print version info</para>
126 <term>+w, <emphasis role='strong' remap='B'>--show-log-window</emphasis></term>
128 <para>show log window</para>
132 <term><emphasis role='strong' remap='B'>--debug</emphasis>[=<emphasis remap='I'>level</emphasis>]</term>
134 <para>turn on debug output</para>
138 <term><emphasis role='strong' remap='B'>-g</emphasis>:, <emphasis role='strong' remap='B'>--grep</emphasis>:<regexp></term>
140 <para>filter debug output</para>
146 <refsect2 id='remote_command_list'><title>Remote command list:</title>
147 <variablelist remap='TP'>
149 <term><emphasis role='strong' remap='B'>-b</emphasis> <emphasis role='strong' remap='B'>--back</emphasis></term>
151 <para>previous image</para>
155 <term><emphasis role='strong' remap='B'>--close-window</emphasis></term>
157 <para>close window</para>
161 <term><emphasis role='strong' remap='B'>--config-load</emphasis>: <FILE>|layout ID</term>
163 <para>load configuration from FILE</para>
167 <term><emphasis role='strong' remap='B'>-cm</emphasis> <emphasis role='strong' remap='B'>--cache-metadata</emphasis></term>
169 <para>clean the metadata cache</para>
173 <term><emphasis role='strong' remap='B'>-cr</emphasis>: <emphasis role='strong' remap='B'>--cache-render</emphasis>:<folder></term>
175 <para>render thumbnails</para>
179 <term><emphasis role='strong' remap='B'>-crr</emphasis>: <emphasis role='strong' remap='B'>--cache-render-recurse</emphasis>:<folder></term>
181 <para>render thumbnails recursively</para>
185 <term><emphasis role='strong' remap='B'>-crs</emphasis>: <emphasis role='strong' remap='B'>--cache-render-shared</emphasis>:<folder></term>
187 <para>render thumbnails (see Help)</para>
191 <term><emphasis role='strong' remap='B'>-crsr</emphasis>: <emphasis role='strong' remap='B'>--cache-render-shared-recurse</emphasis>:<folder></term>
193 <para>render thumbnails recursively (see Help)</para>
197 <term><emphasis role='strong' remap='B'>-cs</emphasis>: <emphasis role='strong' remap='B'>--cache-shared</emphasis>:clear|clean</term>
199 <para>clear or clean shared thumbnail cache</para>
203 <term><emphasis role='strong' remap='B'>-ct</emphasis>: <emphasis role='strong' remap='B'>--cache-thumbs</emphasis>:clear|clean</term>
205 <para>clear or clean thumbnail cache</para>
209 <term><emphasis role='strong' remap='B'>-d</emphasis> <emphasis role='strong' remap='B'>--delay=</emphasis><[H:][M:][N][.M]></term>
211 <para>set slide show delay to Hrs Mins N.M seconds</para>
215 <term><emphasis role='strong' remap='B'>--first</emphasis></term>
217 <para>first image</para>
221 <term><emphasis role='strong' remap='B'>-f</emphasis> <emphasis role='strong' remap='B'>--fullscreen</emphasis></term>
223 <para>toggle full screen</para>
227 <term><emphasis role='strong' remap='B'>--file</emphasis>:<FILE>|<URL></term>
229 <para>open FILE or URL, bring Geeqie window to the top</para>
233 <term>file:<FILE>|<URL></term>
235 <para>open FILE or URL, bring Geeqie window to the top</para>
239 <term><emphasis role='strong' remap='B'>--File</emphasis>:<FILE>|<URL></term>
241 <para>open FILE or URL, do not bring Geeqie window to the top</para>
245 <term>File:<FILE>|<URL></term>
247 <para>open FILE or URL, do not bring Geeqie window to the top</para>
251 <term><emphasis role='strong' remap='B'>-fs</emphasis> <emphasis role='strong' remap='B'>--fullscreen-start</emphasis></term>
253 <para>start full screen</para>
257 <term><emphasis role='strong' remap='B'>-fS</emphasis> <emphasis role='strong' remap='B'>--fullscreen-stop</emphasis></term>
259 <para>stop full screen</para>
263 <term><emphasis role='strong' remap='B'>--geometry=</emphasis><GEOMETRY></term>
265 <para>set window geometry</para>
269 <term><emphasis role='strong' remap='B'>--get-collection</emphasis>:<COLLECTION></term>
271 <para>get collection content</para>
275 <term><emphasis role='strong' remap='B'>--get-collection-list</emphasis></term>
277 <para>get collection list</para>
281 <term><emphasis role='strong' remap='B'>--get-destination</emphasis>:<FILE></term>
283 <para>get destination path of FILE (See Plugins Configuration)</para>
287 <term><emphasis role='strong' remap='B'>--get-file-info</emphasis></term>
289 <para>get file info</para>
293 <term><emphasis role='strong' remap='B'>--get-filelist</emphasis>:[<FOLDER>]</term>
295 <para>get list of files and class</para>
299 <term><emphasis role='strong' remap='B'>--get-filelist-recurse</emphasis>:[<FOLDER>]</term>
301 <para>get list of files and class recursive</para>
305 <term><emphasis role='strong' remap='B'>--get-rectangle</emphasis></term>
307 <para>get rectangle co-ordinates</para>
311 <term><emphasis role='strong' remap='B'>--get-render-intent</emphasis></term>
313 <para>get render intent</para>
317 <term><emphasis role='strong' remap='B'>--get-sidecars</emphasis>:<FILE></term>
319 <para>get list of sidecars of FILE</para>
323 <term><emphasis role='strong' remap='B'>--id</emphasis>:<ID></term>
325 <para>window id for following commands</para>
329 <term><emphasis role='strong' remap='B'>--last</emphasis></term>
331 <para>last image</para>
335 <term><emphasis role='strong' remap='B'>--list-add</emphasis>:<FILE></term>
337 <para>add FILE to command line collection list</para>
341 <term><emphasis role='strong' remap='B'>--list-clear</emphasis></term>
343 <para>clear command line collection list</para>
347 <term><emphasis role='strong' remap='B'>--lua</emphasis>:<FILE>,<lua script></term>
349 <para>run lua script on FILE</para>
353 <term><emphasis role='strong' remap='B'>--new-window</emphasis></term>
355 <para>new window</para>
359 <term><emphasis role='strong' remap='B'>-n</emphasis> <emphasis role='strong' remap='B'>--next</emphasis></term>
361 <para>next image</para>
365 <term><emphasis role='strong' remap='B'>--pixel-info</emphasis></term>
367 <para>print pixel info of mouse pointer on current image</para>
371 <term><emphasis role='strong' remap='B'>--print0</emphasis></term>
373 <para>terminate returned data with null character instead of newline</para>
377 <term><emphasis role='strong' remap='B'>--PWD</emphasis>:<PWD></term>
379 <para>use PWD as working directory for following commands</para>
383 <term><emphasis role='strong' remap='B'>-q</emphasis> <emphasis role='strong' remap='B'>--quit</emphasis></term>
389 <term><emphasis role='strong' remap='B'>--raise</emphasis></term>
391 <para>bring the Geeqie window to the top</para>
397 <para>bring the Geeqie window to the top</para>
401 <term><emphasis role='strong' remap='B'>-s</emphasis> <emphasis role='strong' remap='B'>--slideshow</emphasis></term>
403 <para>toggle slide show</para>
407 <term><emphasis role='strong' remap='B'>--slideshow-recurse</emphasis>:<FOLDER></term>
409 <para>start recursive slide show in FOLDER</para>
413 <term><emphasis role='strong' remap='B'>-ss</emphasis> <emphasis role='strong' remap='B'>--slideshow-start</emphasis></term>
415 <para>start slide show</para>
419 <term><emphasis role='strong' remap='B'>-sS</emphasis> <emphasis role='strong' remap='B'>--slideshow-stop</emphasis></term>
421 <para>stop slide show</para>
425 <term><emphasis role='strong' remap='B'>--tell</emphasis></term>
427 <para>print filename [and Collection] of current image</para>
431 <term>+t <emphasis role='strong' remap='B'>--tools-show</emphasis></term>
433 <para>show tools</para>
437 <term><emphasis role='strong' remap='B'>-t</emphasis> <emphasis role='strong' remap='B'>--tools-hide</emphasis></term>
439 <para>hide tools</para>
443 <term><emphasis role='strong' remap='B'>--view</emphasis>:<FILE></term>
445 <para>open FILE in new window</para>
449 <term>view:<FILE></term>
451 <para>open FILE in new window</para>
453 <para>All other command line parameters are used as plain files if they exist.</para>
455 <para>The name of a collection, with or without either path or extension (.gqv) may be used.</para>
462 <refsect1 id='bugs'><title>BUGS</title>
463 <para>Please send bug reports and feedback to https://github.com/BestImageViewer/geeqie/issues</para>
466 <refsect1 id='copyright'><title>COPYRIGHT</title>
467 <para>Copyright (C) 1999-2004 by John Ellis. Copyright (C) 2004-2022 by The Geeqie Team. Use this software at your
468 own risk! This software released under the GNU General Public License. Please read the COPYING file for more
472 <refsect1 id='see_also'><title>SEE ALSO</title>
473 <para>Full documentation: https://www.geeqie.org/help/GuideIndex.html</para>