<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
                   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<!-- lifted from man+troff by doclifter -->
<refentry id='geeqie1'>
<!-- DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3. -->
<refmeta>
<refentrytitle>GEEQIE</refentrytitle>
<manvolnum>1</manvolnum>
<refmiscinfo class='source'>March 2024</refmiscinfo>
<refmiscinfo class='manual'>Geeqie 2.4 GTK3</refmiscinfo>
</refmeta>
<refnamediv>
<refname>Geeqie</refname>
<refpurpose>GTK based multiformat image viewer</refpurpose>
</refnamediv>
<!-- body begins here -->
<refsynopsisdiv id='synopsis'>
<cmdsynopsis>
  <command>geeqie</command>    
    <arg choice='opt'><replaceable>options</replaceable></arg>
    <arg choice='opt'><replaceable>path</replaceable></arg>
</cmdsynopsis>
</refsynopsisdiv>


<refsect1 id='description'><title>DESCRIPTION</title>
<para>Geeqie is an interactive GTK based image viewer that supports multiple image formats,
zooming, panning, thumbnails and sorting images into collections.</para>

<para>Generated for version:</para>

<para>Geeqie 2.4</para>

<refsect2 id='valid_options'><title>Valid options:</title>
<variablelist remap='TP'>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>--blank</emphasis></term>
  <listitem>
<para>start with blank file list</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>--cache-maintenance</emphasis> &lt;path&gt;</term>
  <listitem>
<para>run cache maintenance in non-GUI mode</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>--disable-clutter</emphasis></term>
  <listitem>
<para>disable use of Clutter library (i.e. GPU accel.)</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>-f</emphasis>, <emphasis role='strong' remap='B'>--fullscreen</emphasis></term>
  <listitem>
<para>start in full screen mode</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>--geometry</emphasis>=<emphasis remap='I'>WxH</emphasis>+XOFF+YOFF</term>
  <listitem>
<para>set main window location</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>-h</emphasis>, <emphasis role='strong' remap='B'>--help</emphasis></term>
  <listitem>
<para>show this message</para>
  </listitem>
  </varlistentry>
</variablelist>

<para><emphasis role='strong' remap='B'>-l</emphasis>, <emphasis role='strong' remap='B'>--list</emphasis> [files] [collections] open collection window for command line</para>
<variablelist remap='TP'>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>-n</emphasis>, <emphasis role='strong' remap='B'>--new-instance</emphasis></term>
  <listitem>
<para>open a new instance of Geeqie *</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>-o</emphasis>:, <emphasis role='strong' remap='B'>--log-file</emphasis>:&lt;file&gt;</term>
  <listitem>
<para>save log data to file</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>-r</emphasis>, <emphasis role='strong' remap='B'>--remote</emphasis></term>
  <listitem>
<para>send following commands to open window</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>-rh</emphasis>, <emphasis role='strong' remap='B'>--remote-help</emphasis></term>
  <listitem>
<para>print remote command list</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>-s</emphasis>, <emphasis role='strong' remap='B'>--slideshow</emphasis></term>
  <listitem>
<para>start in slideshow mode</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term>+t, <emphasis role='strong' remap='B'>--with-tools</emphasis></term>
  <listitem>
<para>force show of tools</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>-t</emphasis>, <emphasis role='strong' remap='B'>--without-tools</emphasis></term>
  <listitem>
<para>force hide of tools</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>-v</emphasis>, <emphasis role='strong' remap='B'>--version</emphasis></term>
  <listitem>
<para>print version info</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term>+w, <emphasis role='strong' remap='B'>--show-log-window</emphasis></term>
  <listitem>
<para>show log window</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>--debug</emphasis>[=<emphasis remap='I'>level</emphasis>]</term>
  <listitem>
<para>turn on debug output</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>-g</emphasis>:, <emphasis role='strong' remap='B'>--grep</emphasis>:&lt;regexp&gt;</term>
  <listitem>
<para>filter debug output</para>
  </listitem>
  </varlistentry>
</variablelist>

<para>* 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.</para>

<para>XDG_CONFIG_HOME=/tmp/a XDG_CACHE_HOME=/tmp/b geeqie</para>
</refsect2>

<refsect2 id='remote_command_list'><title>Remote command list:</title>
<variablelist remap='TP'>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>--action</emphasis>:&lt;ACTION&gt;</term>
  <listitem>
<para>execute keyboard action (See Help/Reference/Remote Keyboard Actions)</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>--action-list</emphasis></term>
  <listitem>
<para>list available keyboard actions (some are redundant)</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>-b</emphasis> <emphasis role='strong' remap='B'>--back</emphasis></term>
  <listitem>
<para>previous image</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>--close-window</emphasis></term>
  <listitem>
<para>close window</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>--config-load</emphasis>:&lt;FILE&gt;|layout ID</term>
  <listitem>
<para>load configuration from FILE</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>-cm</emphasis> <emphasis role='strong' remap='B'>--cache-metadata</emphasis></term>
  <listitem>
<para>clean the metadata cache</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>-cr</emphasis>: <emphasis role='strong' remap='B'>--cache-render</emphasis>:&lt;folder&gt;</term>
  <listitem>
<para>render thumbnails</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>-crr</emphasis>: <emphasis role='strong' remap='B'>--cache-render-recurse</emphasis>:&lt;folder&gt;</term>
  <listitem>
<para>render thumbnails recursively</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>-crs</emphasis>: <emphasis role='strong' remap='B'>--cache-render-shared</emphasis>:&lt;folder&gt;</term>
  <listitem>
<para>render thumbnails (see Help)</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>-crsr</emphasis>: <emphasis role='strong' remap='B'>--cache-render-shared-recurse</emphasis>:&lt;folder&gt;</term>
  <listitem>
<para>render thumbnails recursively (see Help)</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>-cs</emphasis>: <emphasis role='strong' remap='B'>--cache-shared</emphasis>:clear|clean</term>
  <listitem>
<para>clear or clean shared thumbnail cache</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>-ct</emphasis>: <emphasis role='strong' remap='B'>--cache-thumbs</emphasis>:clear|clean</term>
  <listitem>
<para>clear or clean thumbnail cache</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>-d</emphasis> <emphasis role='strong' remap='B'>--delay=</emphasis>&lt;[H:][M:][N][.M]&gt;</term>
  <listitem>
<para>set slide show delay to Hrs Mins N.M seconds</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>--first</emphasis></term>
  <listitem>
<para>first image</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>-f</emphasis> <emphasis role='strong' remap='B'>--fullscreen</emphasis></term>
  <listitem>
<para>toggle full screen</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>--file</emphasis>:&lt;FILE&gt;|&lt;URL&gt;</term>
  <listitem>
<para>open FILE or URL, bring Geeqie window to the top</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>--File</emphasis>:&lt;FILE&gt;|&lt;URL&gt;</term>
  <listitem>
<para>open FILE or URL, do not bring Geeqie window to the top</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>-fs</emphasis> <emphasis role='strong' remap='B'>--fullscreen-start</emphasis></term>
  <listitem>
<para>start full screen</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>-fS</emphasis> <emphasis role='strong' remap='B'>--fullscreen-stop</emphasis></term>
  <listitem>
<para>stop full screen</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>--geometry=</emphasis>&lt;GEOMETRY&gt;</term>
  <listitem>
<para>set window geometry</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>--get-collection</emphasis>:&lt;COLLECTION&gt;</term>
  <listitem>
<para>get collection content</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>--get-collection-list</emphasis></term>
  <listitem>
<para>get collection list</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>--get-destination</emphasis>:&lt;FILE&gt;</term>
  <listitem>
<para>get destination path of FILE (See Plugins Configuration)</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>--get-file-info</emphasis></term>
  <listitem>
<para>get file info</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>--get-filelist</emphasis>:[&lt;FOLDER&gt;]</term>
  <listitem>
<para>get list of files and class</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>--get-filelist-recurse</emphasis>:[&lt;FOLDER&gt;]</term>
  <listitem>
<para>get list of files and class recursive</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>--get-rectangle</emphasis></term>
  <listitem>
<para>get rectangle co-ordinates</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>--get-render-intent</emphasis></term>
  <listitem>
<para>get render intent</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>--get-selection</emphasis></term>
  <listitem>
<para>get list of selected files</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>--get-sidecars</emphasis>:&lt;FILE&gt;</term>
  <listitem>
<para>get list of sidecars of FILE</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>--get-window-list</emphasis></term>
  <listitem>
<para>get window list</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>--id</emphasis>:&lt;ID&gt;</term>
  <listitem>
<para>window id for following commands</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>--last</emphasis></term>
  <listitem>
<para>last image</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>--list-add</emphasis>:&lt;FILE&gt;</term>
  <listitem>
<para>add FILE to command line collection list</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>--list-clear</emphasis></term>
  <listitem>
<para>clear command line collection list</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>--lua</emphasis>:&lt;FILE&gt;,&lt;lua script&gt;</term>
  <listitem>
<para>run lua script on FILE</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>--new-window</emphasis></term>
  <listitem>
<para>new window</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>-n</emphasis> <emphasis role='strong' remap='B'>--next</emphasis></term>
  <listitem>
<para>next image</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>--pixel-info</emphasis></term>
  <listitem>
<para>print pixel info of mouse pointer on current image</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>--print0</emphasis></term>
  <listitem>
<para>terminate returned data with null character instead of newline</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>--PWD</emphasis>:&lt;PWD&gt;</term>
  <listitem>
<para>use PWD as working directory for following commands</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>-q</emphasis> <emphasis role='strong' remap='B'>--quit</emphasis></term>
  <listitem>
<para>quit</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>--raise</emphasis></term>
  <listitem>
<para>bring the Geeqie window to the top</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>--selection-add</emphasis>:[&lt;FILE&gt;]</term>
  <listitem>
<para>adds the current file (or the specified file) to the current selection</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>--selection-clear</emphasis></term>
  <listitem>
<para>clears the current selection</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>--selection-remove</emphasis>:[&lt;FILE&gt;]</term>
  <listitem>
<para>removes the current file (or the specified file) from the current selection</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>-s</emphasis> <emphasis role='strong' remap='B'>--slideshow</emphasis></term>
  <listitem>
<para>toggle slide show</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>--slideshow-recurse</emphasis>:&lt;FOLDER&gt;</term>
  <listitem>
<para>start recursive slide show in FOLDER</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>-ss</emphasis> <emphasis role='strong' remap='B'>--slideshow-start</emphasis></term>
  <listitem>
<para>start slide show</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>-sS</emphasis> <emphasis role='strong' remap='B'>--slideshow-stop</emphasis></term>
  <listitem>
<para>stop slide show</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>--tell</emphasis></term>
  <listitem>
<para>print filename [and Collection] of current image</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term>+t <emphasis role='strong' remap='B'>--tools-show</emphasis></term>
  <listitem>
<para>show tools</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>-t</emphasis> <emphasis role='strong' remap='B'>--tools-hide</emphasis></term>
  <listitem>
<para>hide tools</para>
  </listitem>
  </varlistentry>
  <varlistentry>
  <term><emphasis role='strong' remap='B'>--view</emphasis>:&lt;FILE&gt;</term>
  <listitem>
<para>open FILE in new window</para>

<para>All other command line parameters are used as plain files if they exist.</para>

<para>The name of a collection, with or without either path or extension (.gqv) may be used.</para>
  </listitem>
  </varlistentry>
</variablelist>
</refsect2>
</refsect1>

<refsect1 id='bugs'><title>BUGS</title>
<para>Please send bug reports and feedback to https://github.com/BestImageViewer/geeqie/issues</para>
</refsect1>

<refsect1 id='copyright'><title>COPYRIGHT</title>
<para>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.</para>
</refsect1>

<refsect1 id='see_also'><title>SEE ALSO</title>
<para>Full documentation: https://www.geeqie.org/help/GuideIndex.html</para>
</refsect1>
</refentry>

