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
6 <programlisting>geeqie [options] [path_to_file]</programlisting>
\r
8 <para>These are the command line options available to Geeqie:</para>
\r
10 <tgroup cols="3" rowsep="1" colsep="1">
\r
11 <thead rowsep="1" colsep="1">
\r
13 <entry>Short Option</entry>
\r
14 <entry>Long Option</entry>
\r
15 <entry>Description</entry>
\r
18 <tbody rowsep="1" colsep="1">
\r
21 <entry>--with-tools</entry>
\r
22 <entry>Show file list, menu, and statusbar.</entry>
\r
26 <entry>--without-tools</entry>
\r
27 <entry>Hide file list, menu, and statusbar. Window contains image only.</entry>
\r
31 <entry>--fullscreen</entry>
\r
32 <entry>Start up in fullscreen.</entry>
\r
36 <entry>--slideshow</entry>
\r
37 <entry>Start up in slideshow mode.</entry>
\r
40 <entry>-l [filelist] [collectionlist]</entry>
\r
41 <entry>--list [filelist] [collectionlist]</entry>
\r
42 <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
46 <entry>--blank</entry>
\r
47 <entry>Start with file list blank.</entry>
\r
51 <entry>--geometry=<w>x<h>+<x>+<y></entry>
\r
52 <entry>Set the <width> <height> <xoffset> <yoffset> of the window. The parameters are in pixels.</entry>
\r
56 <entry>--remote</entry>
\r
57 <entry>Send command line options to existing Geeqie process.</entry>
\r
61 <entry>--remote-help</entry>
\r
62 <entry>List command line options available to --remote.</entry>
\r
66 <entry>--help</entry>
\r
67 <entry>Display brief command line option list.</entry>
\r
71 <entry>--version</entry>
\r
72 <entry>Display version of Geeqie.</entry>
\r
76 <entry>--debug[=<level>]</entry>
\r
77 <entry>Turn on debugging output (when compiled with Debug enabled). <level> is 0 to 4.</entry>
\r
81 <entry>--alternate</entry>
\r
82 <entry>Use alternate similarity algorithm - experimental - requires re-compile.</entry>
\r
88 <section id="Remotecommands">
\r
89 <title>Remote commands</title>
\r
90 <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
92 <tgroup cols="3" rowsep="1" colsep="1">
93 <thead rowsep="1" colsep="1">
\r
96 <entry>Short Option</entry>
\r
97 <entry>Long Option</entry>
\r
98 <entry>Description</entry>
\r
102 <entry>--next</entry>
\r
103 <entry>Change main window to display next image.</entry>
\r
107 <entry>--back</entry>
\r
108 <entry>Change main window to display previous image.</entry>
\r
112 <entry>--first</entry>
\r
113 <entry>Change main window to display first image.</entry>
\r
117 <entry>--last</entry>
\r
118 <entry>Change main window to display last image.</entry>
\r
122 <entry>--fullscreen</entry>
\r
123 <entry>Toggle full screen mode of the main window.</entry>
\r
127 <entry>--fullscreen-start</entry>
\r
128 <entry>Start full screen mode for main window.</entry>
\r
132 <entry>--fullscreen-stop</entry>
\r
133 <entry>Stop full screen mode for main window.</entry>
\r
137 <entry>--slideshow</entry>
\r
138 <entry>Toggle slide show for main window.</entry>
\r
142 <entry>--slideshow-start</entry>
\r
143 <entry>Start slide show for main window.</entry>
\r
147 <entry>--slideshow-stop</entry>
\r
148 <entry>Stop slide show for main window.</entry>
\r
152 <entry>--slideshow-recurse:<folder></entry>
\r
153 <entry>Start recursive slide show for <folder> in main window.</entry>
\r
156 <entry>-d<[n][.m]></entry>
\r
157 <entry>--delay=<[n][.m]></entry>
\r
158 <entry>Set slide show delay to <[n][.m]> seconds, range is 0.1 to 3600</entry>
\r
162 <entry>--tools-show</entry>
\r
163 <entry>Show tools for main window.</entry>
\r
167 <entry>--tools-hide</entry>
\r
168 <entry>Hide tools for main window.</entry>
\r
172 <entry>--quit</entry>
\r
173 <entry>Quit Geeqie.</entry>
\r
177 <entry>--config-load:<file></entry>
\r
178 <entry>Load configuration from <file>.</entry>
\r
182 <entry>--get-sidecars:<file></entry>
\r
183 <entry>Get list of sidecars of <file>.</entry>
\r
187 <entry>--get-destination:<file></entry>
\r
188 <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
192 <entry>file:<file></entry>
\r
193 <entry>Change main window to display <file></entry>
\r
197 <entry>view:<file></entry>
\r
198 <entry>Open new window containing <file></entry>
\r
202 <entry>--list-clear</entry>
\r
203 <entry>Clear command line collection list</entry>
\r
207 <entry>--list-add:<file></entry>
\r
208 <entry>Add <file> to command line collection list</entry>
\r
212 <entry>raise</entry>
\r
213 <entry>Bring the geeqie window to the top</entry>
\r