1DARKTABLE(1) darktable DARKTABLE(1)
2
6 darktable - a digital photography workflow application
7
9 darktable [options] [IMG_1234.{RAW,...}|image_folder/]
10 Options:
12 --cachedir <user cache directory>
14 --conf <key>=<value>
15 --configdir <user config directory>
16 -d {all,cache,camctl,camsupport,control,dev,fswatch, input,lighttable,
17 lua,masks,memory,nan,opencl, perf,pwstorage,print,sql}
18 --datadir <data directory>
19 --disable-opencl
20 -h, --help
21 --library <library file>
22 --localedir <locale directory>
23 --luacmd <lua command>
24 --moduledir <module directory>
25 --noiseprofiles <noiseprofiles json file>
26 -t <num openmp threads>
27 --tmpdir <tmp directory>
28 --version
29
31 darktable is a digital photography workflow application for Linux, Mac
32 OS X and several other Unices.
33 The application is designed to ease editing and consistent processing
35 of large photo sessions and provides an easy to use digital lighttable
36 and a set of sophisticated post-processing tools.
37 Most processing is done in 32-bit floating point per channel mode in
39 device independent CIE L*a*b* color space. darktable is also fully
40 color managed, which gives you full control over the look of the
41 photos.
42 The application relies on a modern plugin architecture thus making it
44 easy for 3rd party developers to extend the existing capabilities of
45 the application. All lighttable and darkroom features are implemented
46 as plugins, so you can create your plugins reusing existing code. Most
47 workflow specific things can also be scripted in Lua.
48
50 IMG_1234.RAW or image_folder/
51 You may optionally supply the filename of an image or the name of a
52 folder containing image files. If a filename is given darktable
53 starts in darkroom view with that file opened. If a folder is
54 given darktable starts in lighttable view with the content of that
55 folder as the current collection. If there is already an instance
56 of darktable running (using the same library) the image or folder
57 will be opened there, using D-Bus to communicate between the two
58 processes.
59 --cachedir <cache directory>
61 darktable keeps a cache of image thumbnails for fast image preview
62 and of precompiled OpenCL binaries for fast startup. By default
63 the cache is located in "$HOME/.cache/darktable/". There may exist
64 multiple thumbnail caches in parallel - one for each library file.
65 --conf <key>=<value>
67 darktable supports a rich set of configuration parameters which the
68 user defines in "darktablerc" - darktable's configuration file in
69 the user config directory. You may temporarily overwrite
70 individual settings on the command line with this option - however,
71 these settings will not be stored in "darktablerc".
72 --configdir <config directory>
74 This option defines the directory where darktable stores the user
75 specific configuration. The default place is
76 "$HOME/.config/darktable/".
77 -d <debug option>
79 This option enables debug output to the terminal. There are
80 several subsystems of darktable and debugging of each of them can
81 be activated separately. You can use this option multiple times if
82 you want debugging output of more than one subsystem.
83 A few of those debug options are:
85 control
87 Enable job queue debugging. If you redirect darktable's output
88 to control.log and call ./tools/create_control_svg.sh
89 control.log, you will get a nice control.svg with a
90 visualization of the threads' work.
91 cache
93 This will give you a lot of debugging info about the thumbnail
94 cache for lighttable mode. If compiled in debug mode, this
95 will also tell you where in the code a certain buffer has last
96 been locked.
97 perf
99 Use this for performance tweaking your darkroom modules. It
100 will rdtsc-measure the runtimes of all plugins and print them
101 to stdout.
102 all Enable all debugging output. In general this is not very
104 useful.
105 --datadir <data directory>
107 This option defines the directory where darktable finds its runtime
108 data. The default place depends on your installation. Typical
109 places are "/opt/darktable/share/darktable/" and
110 "/usr/share/darktable/".
111 --disable-opencl
113 Prevent darktable from initializing the OpenCL subsystem. Use this
114 option in case darktable crashes at startup due to a defective
115 OpenCL implementation.
116 -h, --help
118 Show the available command line options and exit.
119 --library <library file>
121 darktable keeps image information in an sqlite database for fast
122 access. The default location of that database file is
123 "$HOME/.config/darktable/library.db". You may give an alternative
124 location, e.g. if you want to do some experiments without
125 compromising your original library.db. If the database file does
126 not exist, darktable creates it for you. You may also give
127 ":memory:" as a library file in which case the database is kept in
128 system memory - all changes are discarded when darktable
129 terminates.
130 --localedir <locale directory>
132 The place where darktable finds its language specific text strings.
133 The default place depends on your installation. Typical places are
134 "/opt/darktable/share/locale/" and "/usr/share/locale/".
135 --luacmd <lua command>
137 A string containing lua commands to execute after lua
138 initialization. These commands will be run after your "luarc"
139 file.
140 If lua is not compiled in, this option will be accepted but won't
142 do anything.
143 --moduledir <module directory>
145 darktable has a modular structure and organizes its modules as
146 shared libraries for loading at runtime. With this option you tell
147 darktable where to look for its shared libraries. The default
148 place depends on your installation; typical places are
149 "/opt/darktable/lib/darktable/" and "/usr/lib/darktable/".
150 --noiseprofiles <noiseprofiles json file>
152 darktable's profiled denoise module uses camera specific profile
153 data that gets loaded from an external JSON file. With this option
154 the file to be loaded can be changed to allow testing alternative
155 profiles. The default profile file is "noiseprofiles.json" and is
156 typically found in "/opt/darktable/share/darktable/" or
157 "/usr/share/darktable/".
158 -t <num openmp threads>
160 darktable uses OpenMP to parallelize many computation steps and
161 make use of all the available CPU cores. With this option you can
162 specify the number of threads to use. Valid values are between 1
163 and 100.
164 --tmpdir <tmp directory>
166 The place where darktable stores its temporary files. If this
167 option is not supplied darktable uses the system default.
168 --version
170 Show the darktable version along with some important build options
171 and exit.
172
174 All modes
175 l Switch to lighttable view
177 d Switch to darkroom view
179 t Switch to tethered capture view
181 m Switch to map view
183 s Switch to slideshow view
185 p Switch to print view
187 . Switch between lighttable and darkroom views
189 Ctrl-q
191 Quit
192 F11 Switch between fullscreen and normal modes of the application's
194 window
195 Esc Leave fullscreen mode
197 Ctrl-h
199 Show/hide header
200 Tab Show/hide sidebars
202 Lighttable mode
204 g, Shift-g
206 Navigate to top, bottom row
207 PageUp, PageDown
209 Navigate one page up, down
210 ' Scroll center
212 Down, Left, Right, Up
214 Scroll down, left, right, up
215 z Preview image
217 Ctrl-z
219 Preview image with focus detection
220 F1, F2, F3, F4, F5
222 Color labels: toggle red, yellow, green, blue and purple
223 1, 2, 3, 4, 5
225 Star rating
226 0 Strip all stars
228 r Mark as rejected
230 l Realign images to the grid
232 Alt-1
234 Zoom in on first visible image
235 Alt-2, 3
237 Adjust zoom
238 Alt-4
240 Zoom out completely
241 Ctrl-a
243 Select all images
244 Ctrl-Shift-a
246 Select no images
247 Ctrl-i
249 Invert selection
250 Ctrl-d
252 Duplicate image
253 Ctrl-g, Ctrl-Shift-g
255 Group/ungroup selected images
256 Delete
258 Remove image from collection
259 Ctrl-c, Ctrl-Shift-c
261 Copy all, selected history
262 Ctrl-v, Ctrl-Shift-v
264 Paste all, selected history
265 Space
267 Toggle selection of an image
268 Return
270 Select an image
271 Ctrl-e
273 Export currently selected images
274 Ctrl-k
276 Jump back to the previous collection
277 Ctrl-t
279 Open a popup to quickly tag an image
280 Ctrl-Shift-i
282 Import a folder
283 Ctrl-j
285 Jump to the filmroll of an image
286 Darkroom mode
288 Alt-1, 2, 3
290 Zoom to 1:1, fill, and fit, respectively
291 Ctrl-f
293 Show/hide filmstrip
294 Space, Backspace
296 Step to next, previous image
297 Ctrl-e
299 Export current image
300 Ctrl-c, Ctrl-Shift-c
302 Copy all, selected history
303 Ctrl-v, Ctrl-Shift-v
305 Paste all, selected history
306 o Toggle show of over- and under-exposure
308 Ctrl-g
310 Toggle gamut check
311 Ctrl-s
313 Toggle softproofing
314 Enter
316 In Crop & Rotate module, commit the crop
317 [, ]
319 In Flip module, rotate 90 degrees ccw, cw
320 <, >
322 When drawing masks, decrease, increase brush opacity, respectively
323 {, }
325 When drawing masks, decrease, increase brush hardness, respectively
326 [, ]
328 When drawing masks, decrease, increase brush size, respectively
329 Tethered mode
331 Ctrl-f
333 Show/hide filmstrip
334 v Toggle live view
336 Map mode
338 Ctrl-f
340 Show/hide filmstrip
341 Ctrl-z
343 Undo
344 Ctrl-r
346 Redo
347 Filmstrip (when the cursor is on top of the filmstrip)
349 F1, F2, F3, F4, F5
351 Color labels: toggle red, yellow, green, blue and purple
352 1, 2, 3, 4, 5
354 Star rating
355 0 Strip all stars
357 r Mark as rejected
359 Ctrl-d
361 Duplicate image
362 Ctrl-a
364 Select all images
365 Ctrl-Shift-a
367 Select no images
368 Ctrl-i
370 Invert selection
371 Ctrl-c, Ctrl-Shift-c
373 Copy all, selected history
374 Ctrl-v, Ctrl-Shift-v
376 Paste all, selected history
377 Slideshow mode
379 Space
381 Start/stop playback
382
384 darktable-cli(1)
385
387 Please visit darktable's website for news, blog and bug tracker:
388 <https://www.darktable.org/>
389 <https://www.darktable.org/usermanual/> The complete darktable
391 usermanual.
392 darktablerc.html An overview over all default config settings. The
394 default place depends on your installation. Typical places are
395 "/opt/darktable/share/doc/darktable/" and "/usr/share/doc/darktable/".
396
398 Please use the bug tracker on
399 <https://github.com/darktable-org/darktable/issues> to report bugs,
400 feature requests and so on.
401
403 The principal developer of darktable is Johannes Hanika. The
404 (hopefully) complete list of contributors to the project is:
405 * developers: Pascal Obry Aldric Renaudin Ulrich Pegelow parafin Roman
407 Lebedev Tobias Ellinghaus
408 * translators: Pascal Obry EdgarLux Ulrich Pegelow igmerti
410 * contributors (at least 4 commits): Philippe Weyland Dan Torop
412 rawfiner Hubert Kowalski Aurélien PIERRE Heiko Bauke hanno@schwalm-
413 bremen.de Diederik ter Rahe U-DESKTOP-HQME86Jmarco Bill Ferguson
414 Nicolas Auffray Chris.Elston Mark-64 Sam Smith
415 * Sub-module rawspeed contributors (at least 1 commit): Roman Lebedev
417 David-Tillmann Schaefer Martin Straeten hanno@schwalm-bremen.de
418 And all those of you that made previous releases possible
420 This man page was written by Alexandre Prokoudine
422 <alexandre.prokoudine@gmail.com> and Richard Levitte
423 <richard@levittr.org>. Additions were made by Tobias Ellinghaus
424 <me@houz.org>.
425
427 The project was started by Johannes Hanika in early 2009 to fill the
428 gap (or, rather, a black hole) of a digital photography workflow tool
429 on Linux.
430
432 Copyright (C) 2009-2017 by Authors.
433 darktable is free software; you can redistribute it and/or modify it
435 under the terms of the GPL v3 or (at your option) any later version.
436darktable 2.3 2017-01-20 DARKTABLE(1)