doc/docbook/GuideReferenceCommandLine.xml

   1 <?xml version="1.0" encoding="utf-8"?>\r
   2 <section id="GuideReferenceCommandLine">\r
   3   <title>Command Line Options</title>\r
   4   <para>\r
   5     Geeqie is called by the command:\r
   6     <programlisting>\r
   7       geeqie [options] [path_to_file_or_collection]\r
   8       <footnote id='ref1'>The name of a collection, with or without either path or extension (.gqv) may be used. If a path is not used and there is a name conflict with a file or folder, that will take precedence.</footnote>\r
   9     </programlisting>\r
  10   </para>\r
  11   <para>You may also use a URL as a filename. The file will be downloaded to a temporary file and displayed.</para>\r
  12   <para>These are the command line options available to Geeqie:</para>\r
  13   <table frame="all">\r
  14     <tgroup cols="3" rowsep="1" colsep="1">\r
  15       <thead rowsep="1" colsep="1">\r
  16         <row>\r
  17           <entry>Short Option</entry>\r
  18           <entry>Long Option</entry>\r
  19           <entry>Description</entry>\r
  20         </row>\r
  21       </thead>\r
  22       <tbody rowsep="1" colsep="1">\r
  23         <row>\r
  24           <entry>+t</entry>\r
  25           <entry>--with-tools</entry>\r
  26           <entry>Show file list, menu, and statusbar.</entry>\r
  27         </row>\r
  28         <row>\r
  29           <entry>-t</entry>\r
  30           <entry>--without-tools</entry>\r
  31           <entry>Hide file list, menu, and statusbar. Window contains image only.</entry>\r
  32         </row>\r
  33         <row>\r
  34           <entry>-f</entry>\r
  35           <entry>--fullscreen</entry>\r
  36           <entry>Start up in fullscreen.</entry>\r
  37         </row>\r
  38         <row>\r
  39           <entry>-s</entry>\r
  40           <entry>--slideshow</entry>\r
  41           <entry>Start up in slideshow mode.</entry>\r
  42         </row>\r
  43         <row>\r
  44           <entry>-l [filelist] [collectionlist]</entry>\r
  45           <entry>--list [filelist] [collectionlist]</entry>\r
  46           <entry>Open collection window containing images specified on the command line. Any collections on the command line will also be appended to this collection.</entry>\r
  47         </row>\r
  48         <row>\r
  49           <entry />\r
  50           <entry>--blank</entry>\r
  51           <entry>Start with file list blank.</entry>\r
  52         </row>\r
  53         <row>\r
  54           <entry />\r
  55           <entry>--geometry=&lt;w&gt;x&lt;h&gt;+&lt;x&gt;+&lt;y&gt;</entry>\r
  56           <entry>Set the &lt;width&gt; &lt;height&gt; &lt;xoffset&gt; &lt;yoffset&gt; of the window. The parameters are in pixels.</entry>\r
  57         </row>\r
  58         <row>\r
  59           <entry>-n</entry>\r
  60           <entry>--new-instance</entry>\r
  61           <entry>Open a new instance of Geeqie.</entry>\r
  62         </row>\r
  63         <row>\r
  64           <entry>-r</entry>\r
  65           <entry>--remote</entry>\r
  66           <entry>Send command line options to existing Geeqie process.</entry>\r
  67         </row>\r
  68         <row>\r
  69           <entry>-rh</entry>\r
  70           <entry>--remote-help</entry>\r
  71           <entry>List command line options available to --remote.</entry>\r
  72         </row>\r
  73         <row>\r
  74           <entry>-h</entry>\r
  75           <entry>--help</entry>\r
  76           <entry>Display brief command line option list.</entry>\r
  77         </row>\r
  78         <row>\r
  79           <entry>-v</entry>\r
  80           <entry>--version</entry>\r
  81           <entry>Display version of Geeqie.</entry>\r
  82         </row>\r
  83         <row>\r
  84           <entry />\r
  85           <entry>--debug[=&lt;level&gt;]</entry>\r
  86           <entry>Turn on debugging output (when compiled with Debug enabled). &lt;level&gt; is 0 to 4.</entry>\r
  87         </row>\r
  88         <row>\r
  89           <entry>-g:&lt;regexp&gt;</entry>\r
  90           <entry>--grep:&lt;regexp&gt;</entry>\r
  91           <entry>Filter debug output with regular expression</entry>\r
  92         </row>\r
  93         <row>\r
  94           <entry>+w</entry>\r
  95           <entry>--show-log-window</entry>\r
  96           <entry>Display log window</entry>\r
  97         </row>\r
  98         <row>\r
  99           <entry>-o:&lt;file&gt;</entry>\r
 100           <entry>--log-file:&lt;file&gt;</entry>\r
 101           <entry>Save log data to file</entry>\r
 102         </row>\r
 103         <row>\r
 104           <entry />\r
 105           <entry>--alternate</entry>\r
 106           <entry>Use alternate similarity algorithm - experimental - requires re-compile.</entry>\r
 107         </row>\r
 108         <row>\r
 109           <entry />\r
 110           <entry>--disable-clutter</entry>\r
 111           <entry>Disable use of Clutter library (i.e. GPU accel.). If the Clutter library is compiled into Geeqie but Clutter fails to initialize, it is necessary to start Geeqie with this option.</entry>\r
 112         </row>\r
 113         <row>\r
 114           <entry />\r
 115           <entry>--cache-maintenance &lt;path&gt;</entry>\r
 116           <entry>\r
 117             Run cache maintenance\r
 118             <footnote id='cachemaintenance'>\r
 119               <para><link linkend="CacheMaintenance">Cache Maintenance</link>.</para>\r
 120             </footnote>\r
 121             in non-GUI mode.\r
 122           </entry>\r
 123         </row>\r
 124       </tbody>\r
 125     </tgroup>\r
 126   </table>\r
 127   <para />\r
 128   <section id="Remotecommands">\r
 129     <title>Remote commands</title>\r
 130     <para>The --remote command line option will send all entered commands to an existing Geeqie process, a new process will be started if one does not exist. These are the additional commands that can be used with the remote command:</para>\r
 131     <table frame="all">\r
 132       <tgroup cols="3" rowsep="1" colsep="1">\r
 133         <thead rowsep="1" colsep="1">\r
 134           <row>\r
 135             <entry>Short Option</entry>\r
 136             <entry>Long Option</entry>\r
 137             <entry>Description</entry>\r
 138           </row>\r
 139         </thead>\r
 140         <tbody>\r
 141           <row>\r
 142             <entry>-n</entry>\r
 143             <entry>--next</entry>\r
 144             <entry>Change main window to display next image.</entry>\r
 145           </row>\r
 146           <row>\r
 147             <entry>-b</entry>\r
 148             <entry>--back</entry>\r
 149             <entry>Change main window to display previous image.</entry>\r
 150           </row>\r
 151           <row>\r
 152             <entry />\r
 153             <entry>--first</entry>\r
 154             <entry>Change main window to display first image.</entry>\r
 155           </row>\r
 156           <row>\r
 157             <entry />\r
 158             <entry>--last</entry>\r
 159             <entry>Change main window to display last image.</entry>\r
 160           </row>\r
 161           <row>\r
 162             <entry>-f</entry>\r
 163             <entry>--fullscreen</entry>\r
 164             <entry>Toggle full screen mode of the main window.</entry>\r
 165           </row>\r
 166           <row>\r
 167             <entry>-fs</entry>\r
 168             <entry>--fullscreen-start</entry>\r
 169             <entry>Start full screen mode for main window.</entry>\r
 170           </row>\r
 171           <row>\r
 172             <entry>-fS</entry>\r
 173             <entry>--fullscreen-stop</entry>\r
 174             <entry>Stop full screen mode for main window.</entry>\r
 175           </row>\r
 176           <row>\r
 177             <entry>-s</entry>\r
 178             <entry>--slideshow</entry>\r
 179             <entry>Toggle slide show for main window.</entry>\r
 180           </row>\r
 181           <row>\r
 182             <entry>-ss</entry>\r
 183             <entry>--slideshow-start</entry>\r
 184             <entry>Start slide show for main window.</entry>\r
 185           </row>\r
 186           <row>\r
 187             <entry>-sS</entry>\r
 188             <entry>--slideshow-stop</entry>\r
 189             <entry>Stop slide show for main window.</entry>\r
 190           </row>\r
 191           <row>\r
 192             <entry />\r
 193             <entry>--slideshow-recurse:&lt;folder&gt;</entry>\r
 194             <entry>Start recursive slide show for &lt;folder&gt; in main window.</entry>\r
 195           </row>\r
 196           <row>\r
 197             <entry>-d&lt;[h:][m:][n][.m]&gt;</entry>\r
 198             <entry>--delay=&lt;[h:][m:][n][.m]&gt;</entry>\r
 199             <entry>Set slide show delay to &lt;[hrs:][mins:][n][.m]&gt; seconds, range is 0.1 secs to 24 hours</entry>\r
 200           </row>\r
 201           <row>\r
 202             <entry>+t</entry>\r
 203             <entry>--tools-show</entry>\r
 204             <entry>Show tools for main window.</entry>\r
 205           </row>\r
 206           <row>\r
 207             <entry>-t</entry>\r
 208             <entry>--tools-hide</entry>\r
 209             <entry>Hide tools for main window.</entry>\r
 210           </row>\r
 211           <row>\r
 212             <entry>-q</entry>\r
 213             <entry>--quit</entry>\r
 214             <entry>Quit Geeqie.</entry>\r
 215           </row>\r
 216           <row>\r
 217             <entry />\r
 218             <entry>--config-load:&lt;file&gt;|layout ID</entry>\r
 219             <entry>Load configuration from &lt;file&gt;. Use either a full path, or a saved window layout ID.</entry>\r
 220           </row>\r
 221           <row>\r
 222             <entry />\r
 223             <entry>--get-sidecars:&lt;file&gt;</entry>\r
 224             <entry>Get list of sidecars of &lt;file&gt;.</entry>\r
 225           </row>\r
 226           <row>\r
 227             <entry />\r
 228             <entry>--get-destination:&lt;file&gt;</entry>\r
 229             <entry>Get destination path of &lt;file&gt;. This is used by the symlink desktop file to implement the symbolic link operation. There is no useful function for the user.</entry>\r
 230           </row>\r
 231           <row>\r
 232             <entry />\r
 233             <entry>file:&lt;file&gt;|&lt;URL&gt;</entry>\r
 234             <entry>Open  &lt;file&gt; or &lt;URL&gt; and bring Geeqie window to the top</entry>\r
 235           </row>\r
 236           <row>\r
 237             <entry />\r
 238             <entry>--file:&lt;file&gt;|&lt;URL&gt;</entry>\r
 239             <entry>Open  &lt;file&gt; or &lt;URL&gt; and bring Geeqie window to the top</entry>\r
 240           </row>\r
 241           <row>\r
 242             <entry />\r
 243             <entry>File:&lt;file&gt;|&lt;URL&gt;</entry>\r
 244             <entry>Open  &lt;file&gt; or &lt;URL&gt; and do not bring Geeqie window to the top</entry>\r
 245           </row>\r
 246           <row>\r
 247             <entry />\r
 248             <entry>--File:&lt;file&gt;|&lt;URL&gt;</entry>\r
 249             <entry>Open  &lt;file&gt; or &lt;URL&gt; and do not bring Geeqie window to the top</entry>\r
 250           </row>\r
 251           <row>\r
 252             <entry />\r
 253             <entry>--tell</entry>\r
 254             <entry>Print filename [and Collection] of current image</entry>\r
 255           </row>\r
 256           <row>\r
 257             <entry />\r
 258             <entry>--pixel-info</entry>\r
 259             <entry>Print X, Y and RGB of mouse pointer on current image</entry>\r
 260           </row>\r
 261           <row>\r
 262             <entry />\r
 263             <entry>--get-rectangle</entry>\r
 264             <entry>Get rectangle coordinates</entry>\r
 265           </row>\r
 266           <row>\r
 267             <entry />\r
 268             <entry>--get-render-intent</entry>\r
 269             <entry>Get render intent</entry>\r
 270           </row>\r
 271           <row>\r
 272             <entry />\r
 273             <entry>--get-filelist:[&lt;FOLDER&gt;]</entry>\r
 274             <entry>Get list of files and class</entry>\r
 275           </row>\r
 276           <row>\r
 277             <entry />\r
 278             <entry>--get-filelist-recurse:[&lt;FOLDER&gt;]</entry>\r
 279             <entry>Get list of files and class recursive</entry>\r
 280           </row>\r
 281           <row>\r
 282             <entry />\r
 283             <entry>--get-collection:&lt;COLLECTION&gt;</entry>\r
 284             <entry>Get collection content</entry>\r
 285           </row>\r
 286           <row>\r
 287             <entry />\r
 288             <entry>--get-collection-list</entry>\r
 289             <entry>Get collection list</entry>\r
 290           </row>\r
 291           <row>\r
 292             <entry />\r
 293             <entry>--get-file-info</entry>\r
 294             <entry>\r
 295               Get file info\r
 296               <footnote id='fileinfo'>\r
 297                 <para>File info consists of: class, no. of pages (if multi-page image), (and if exif exists) country name, country code, timezone, local time.</para>\r
 298               </footnote>\r
 299             </entry>\r
 300           </row>\r
 301           <row>\r
 302             <entry />\r
 303             <entry>view:&lt;file&gt;</entry>\r
 304             <entry>Open new window containing &lt;file&gt;</entry>\r
 305           </row>\r
 306           <row>\r
 307             <entry />\r
 308             <entry>--view:&lt;file&gt;</entry>\r
 309             <entry>Open new window containing &lt;file&gt;</entry>\r
 310           </row>\r
 311           <row>\r
 312             <entry />\r
 313             <entry>--list-clear</entry>\r
 314             <entry>Clear command line collection list</entry>\r
 315           </row>\r
 316           <row>\r
 317             <entry />\r
 318             <entry>--list-add:&lt;file&gt;</entry>\r
 319             <entry>Add &lt;file&gt; to command line collection list</entry>\r
 320           </row>\r
 321           <row>\r
 322             <entry />\r
 323             <entry>raise</entry>\r
 324             <entry>Bring the geeqie window to the top</entry>\r
 325           </row>\r
 326           <row>\r
 327             <entry />\r
 328             <entry>--raise</entry>\r
 329             <entry>Bring the geeqie window to the top</entry>\r
 330           </row>\r
 331           <row>\r
 332             <entry />\r
 333             <entry>--id:&lt;ID&gt;</entry>\r
 334             <entry>\r
 335               Window ID for following commands\r
 336               <footnote id='ref3'>\r
 337                 <para>The ID is shown in the titlebar of the window. If multiple windows are open, it can be used to direct commands to a particular window e.g. --remote --id:main --tell</para>\r
 338               </footnote>\r
 339             </entry>\r
 340           </row>\r
 341           <row>\r
 342             <entry />\r
 343             <entry>--new-window</entry>\r
 344             <entry>Open new window</entry>\r
 345           </row>\r
 346           <row>\r
 347             <entry />\r
 348             <entry>--close-window</entry>\r
 349             <entry>Close window</entry>\r
 350           </row>\r
 351           <row>\r
 352             <entry />\r
 353             <entry>--geometry=[&lt;w&gt;x&lt;h&gt;][+&lt;x&gt;+&lt;y&gt;]</entry>\r
 354             <entry>Set the &lt;width&gt; &lt;height&gt; &lt;xoffset&gt; &lt;yoffset&gt; of the window. The parameters are in pixels.</entry>\r
 355           </row>\r
 356           <row>\r
 357             <entry>-ct:clear|clean</entry>\r
 358             <entry>--cache-thumbs:clear|clean</entry>\r
 359             <entry>clear or clean thumbnail cache</entry>\r
 360           </row>\r
 361           <row>\r
 362             <entry>-cs:clear|clean</entry>\r
 363             <entry>--cache-shared:clear|clean</entry>\r
 364             <entry>clear or clean shared thumbnail cache</entry>\r
 365           </row>\r
 366           <row>\r
 367             <entry>-cm</entry>\r
 368             <entry>--cache-metadata</entry>\r
 369             <entry>clean the metadata cache</entry>\r
 370           </row>\r
 371           <row>\r
 372             <entry>-cr:&lt;folder&gt;</entry>\r
 373             <entry>--cache-render:&lt;folder&gt;</entry>\r
 374             <entry>render thumbnails</entry>\r
 375           </row>\r
 376           <row>\r
 377             <entry>-crr:&lt;folder&gt;</entry>\r
 378             <entry>--cache-render-recurse:&lt;folder&gt;</entry>\r
 379             <entry>render thumbnails recursively</entry>\r
 380           </row>\r
 381           <row>\r
 382             <entry>-crs:&lt;folder&gt;</entry>\r
 383             <entry>--cache-render-shared:&lt;folder&gt;</entry>\r
 384             <entry>\r
 385               render thumbnails\r
 386               <footnote id='ref2'>\r
 387                 <para>If standard thumbnail cache is not enabled, this command will be ignored.</para>\r
 388               </footnote>\r
 389             </entry>\r
 390           </row>\r
 391           <row>\r
 392             <entry>-crsr:&lt;folder&gt;</entry>\r
 393             <entry>--cache-render-shared-recurse:&lt;folder&gt;</entry>\r
 394             <entry>render thumbnails recursively</entry>\r
 395           </row>\r
 396           <row>\r
 397             <entry />\r
 398             <entry>--lua:&lt;file&gt;,&lt;lua script&gt;</entry>\r
 399             <entry>run lua script on file</entry>\r
 400           </row>\r
 401           <row>\r
 402             <entry />\r
 403             <entry>--PWD:&lt;PWD&gt;</entry>\r
 404             <entry>Use PWD as working directory for following commands</entry>\r
 405           </row>\r
 406           <row>\r
 407             <entry />\r
 408             <entry>--print0</entry>\r
 409             <entry>Terminate returned data with null character instead of newline</entry>\r
 410           </row>\r
 411         </tbody>\r
 412       </tgroup>\r
 413     </table>\r
 414     <para />\r
 415   </section>\r
 416 </section>\r