1 <?xml version="1.0" encoding="utf-8"?>
\r
2 <section id="GuideReferenceCommandLine">
\r
3 <title>Command Line Options</title>
\r
5 Geeqie is called by the command:
\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
11 <para>These are the command line options available to Geeqie:</para>
\r
13 <tgroup cols="3" rowsep="1" colsep="1">
\r
14 <thead rowsep="1" colsep="1">
\r
16 <entry>Short Option</entry>
\r
17 <entry>Long Option</entry>
\r
18 <entry>Description</entry>
\r
21 <tbody rowsep="1" colsep="1">
\r
24 <entry>--with-tools</entry>
\r
25 <entry>Show file list, menu, and statusbar.</entry>
\r
29 <entry>--without-tools</entry>
\r
30 <entry>Hide file list, menu, and statusbar. Window contains image only.</entry>
\r
34 <entry>--fullscreen</entry>
\r
35 <entry>Start up in fullscreen.</entry>
\r
39 <entry>--slideshow</entry>
\r
40 <entry>Start up in slideshow mode.</entry>
\r
43 <entry>-l [filelist] [collectionlist]</entry>
\r
44 <entry>--list [filelist] [collectionlist]</entry>
\r
45 <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
49 <entry>--blank</entry>
\r
50 <entry>Start with file list blank.</entry>
\r
54 <entry>--geometry=<w>x<h>+<x>+<y></entry>
\r
55 <entry>Set the <width> <height> <xoffset> <yoffset> of the window. The parameters are in pixels.</entry>
\r
59 <entry>--remote</entry>
\r
60 <entry>Send command line options to existing Geeqie process.</entry>
\r
64 <entry>--remote-help</entry>
\r
65 <entry>List command line options available to --remote.</entry>
\r
69 <entry>--help</entry>
\r
70 <entry>Display brief command line option list.</entry>
\r
74 <entry>--version</entry>
\r
75 <entry>Display version of Geeqie.</entry>
\r
79 <entry>--debug[=<level>]</entry>
\r
80 <entry>Turn on debugging output (when compiled with Debug enabled). <level> is 0 to 4.</entry>
\r
83 <entry>-g:<regexp></entry>
\r
84 <entry>--grep:<regexp></entry>
\r
85 <entry>Filter debug output with regular expression</entry>
\r
89 <entry>--show-log-window</entry>
\r
90 <entry>Display log window</entry>
\r
93 <entry>-o:<file></entry>
\r
94 <entry>--log-file:<file></entry>
\r
95 <entry>Save log data to file</entry>
\r
99 <entry>--alternate</entry>
\r
100 <entry>Use alternate similarity algorithm - experimental - requires re-compile.</entry>
\r
106 <section id="Remotecommands">
\r
107 <title>Remote commands</title>
\r
108 <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
109 <table frame="all">
\r
110 <tgroup cols="3" rowsep="1" colsep="1">
\r
111 <thead rowsep="1" colsep="1">
\r
113 <entry>Short Option</entry>
\r
114 <entry>Long Option</entry>
\r
115 <entry>Description</entry>
\r
121 <entry>--next</entry>
\r
122 <entry>Change main window to display next image.</entry>
\r
126 <entry>--back</entry>
\r
127 <entry>Change main window to display previous image.</entry>
\r
131 <entry>--first</entry>
\r
132 <entry>Change main window to display first image.</entry>
\r
136 <entry>--last</entry>
\r
137 <entry>Change main window to display last image.</entry>
\r
141 <entry>--fullscreen</entry>
\r
142 <entry>Toggle full screen mode of the main window.</entry>
\r
146 <entry>--fullscreen-start</entry>
\r
147 <entry>Start full screen mode for main window.</entry>
\r
151 <entry>--fullscreen-stop</entry>
\r
152 <entry>Stop full screen mode for main window.</entry>
\r
156 <entry>--slideshow</entry>
\r
157 <entry>Toggle slide show for main window.</entry>
\r
161 <entry>--slideshow-start</entry>
\r
162 <entry>Start slide show for main window.</entry>
\r
166 <entry>--slideshow-stop</entry>
\r
167 <entry>Stop slide show for main window.</entry>
\r
171 <entry>--slideshow-recurse:<folder></entry>
\r
172 <entry>Start recursive slide show for <folder> in main window.</entry>
\r
175 <entry>-d<[h:][m:][n][.m]></entry>
\r
176 <entry>--delay=<[h:][m:][n][.m]></entry>
\r
177 <entry>Set slide show delay to <[hrs:][mins:][n][.m]> seconds, range is 0.1 secs to 24 hours</entry>
\r
181 <entry>--tools-show</entry>
\r
182 <entry>Show tools for main window.</entry>
\r
186 <entry>--tools-hide</entry>
\r
187 <entry>Hide tools for main window.</entry>
\r
191 <entry>--quit</entry>
\r
192 <entry>Quit Geeqie.</entry>
\r
196 <entry>--config-load:<file></entry>
\r
197 <entry>Load configuration from <file>.</entry>
\r
201 <entry>--get-sidecars:<file></entry>
\r
202 <entry>Get list of sidecars of <file>.</entry>
\r
206 <entry>--get-destination:<file></entry>
\r
207 <entry>Get destination path of <file>. This is used by the symlink desktop file to implement the symbolic link operation. There is no useful function for the user.</entry>
\r
211 <entry>file:<file></entry>
\r
212 <entry>Open <file> and bring Geeqie window to the top</entry>
\r
216 <entry>File:<file></entry>
\r
217 <entry>Open <file> and do not bring Geeqie window to the top</entry>
\r
221 <entry>--tell</entry>
\r
222 <entry>Print filename of current image</entry>
\r
226 <entry>view:<file></entry>
\r
227 <entry>Open new window containing <file></entry>
\r
231 <entry>--list-clear</entry>
\r
232 <entry>Clear command line collection list</entry>
\r
236 <entry>--list-add:<file></entry>
\r
237 <entry>Add <file> to command line collection list</entry>
\r
241 <entry>raise</entry>
\r
242 <entry>Bring the geeqie window to the top</entry>
\r
245 <entry>-ct:clear|clean</entry>
\r
246 <entry>--cache-thumbs:clear|clean</entry>
\r
247 <entry>clear or clean thumbnail cache</entry>
\r
250 <entry>-cs:clear|clean</entry>
\r
251 <entry>--cache-shared:clear|clean</entry>
\r
252 <entry>clear or clean shared thumbnail cache</entry>
\r
256 <entry>--cache-metadata</entry>
\r
257 <entry>clean the metadata cache</entry>
\r
260 <entry>-cr:<folder></entry>
\r
261 <entry>--cache-render:<folder></entry>
\r
262 <entry>render thumbnails</entry>
\r
265 <entry>-crr:<folder></entry>
\r
266 <entry>--cache-render-recurse:<folder></entry>
\r
267 <entry>render thumbnails recursively</entry>
\r
270 <entry>-crs:<folder></entry>
\r
271 <entry>--cache-render-shared:<folder></entry>
\r
274 <footnote id='ref2'>
\r
275 <para>If standard thumbnail cache is not enabled, this command will be ignored.</para>
\r
280 <entry>-crsr:<folder></entry>
\r
281 <entry>--cache-render-shared-recurse:<folder></entry>
\r
282 <entry>render thumbnails recursively</entry>
\r
286 <entry>--lua:<file>,<lua script></entry>
\r
287 <entry>run lua script on file</entry>
\r