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,imageio,input,
17 ioporder,lighttable,lua,masks,memory,nan,opencl,params,perf,
18 pwstorage,print,signal,sql,undo}
19 --datadir <data directory>
20 --disable-opencl
21 -h, --help
22 --library <library file>
23 --localedir <locale directory>
24 --luacmd <lua command>
25 --moduledir <module directory>
26 --noiseprofiles <noiseprofiles json file>
27 -t <num openmp threads>
28 --tmpdir <tmp directory>
29 --version
30
32 darktable is a digital photography workflow application for Linux, Mac
33 OS X and several other Unices.
34 The application is designed to ease editing and consistent processing
36 of large photo sessions and provides an easy to use digital lighttable
37 and a set of sophisticated post-processing tools.
38 Most processing is done in 32-bit floating point per channel mode in
40 device independent CIE L*a*b* color space. darktable is also fully
41 color managed, which gives you full control over the look of the
42 photos.
43 The application relies on a modern plugin architecture thus making it
45 easy for 3rd party developers to extend the existing capabilities of
46 the application. All lighttable and darkroom features are implemented
47 as plugins, so you can create your plugins reusing existing code. Most
48 workflow specific things can also be scripted in Lua.
49
51 IMG_1234.RAW or image_folder/
52 You may optionally supply the filename of an image or the name of a
53 folder containing image files. If a filename is given darktable
54 starts in darkroom view with that file opened. If a folder is
55 given darktable starts in lighttable view with the content of that
56 folder as the current collection. If there is already an instance
57 of darktable running (using the same library) the image or folder
58 will be opened there, using D-Bus to communicate between the two
59 processes.
60 --cachedir <cache directory>
62 darktable keeps a cache of image thumbnails for fast image preview
63 and of precompiled OpenCL binaries for fast startup. By default
64 the cache is located in "$HOME/.cache/darktable/". There may exist
65 multiple thumbnail caches in parallel - one for each library file.
66 --conf <key>=<value>
68 darktable supports a rich set of configuration parameters which the
69 user defines in "darktablerc" - darktable's configuration file in
70 the user config directory. You may temporarily overwrite
71 individual settings on the command line with this option - however,
72 these settings will not be stored in "darktablerc".
73 --configdir <config directory>
75 This option defines the directory where darktable stores the user
76 specific configuration. The default place is
77 "$HOME/.config/darktable/".
78 -d <debug option>
80 This option enables debug output to the terminal. There are
81 several subsystems of darktable and debugging of each of them can
82 be activated separately. You can use this option multiple times if
83 you want debugging output of more than one subsystem.
84 A few of those debug options are:
86 control
88 Enable job queue debugging. If you redirect darktable's output
89 to control.log and call ./tools/create_control_svg.sh
90 control.log, you will get a nice control.svg with a
91 visualization of the threads' work.
92 cache
94 This will give you a lot of debugging info about the thumbnail
95 cache for lighttable mode. If compiled in debug mode, this
96 will also tell you where in the code a certain buffer has last
97 been locked.
98 perf
100 Use this for performance tweaking your darkroom modules. It
101 will rdtsc-measure the runtimes of all plugins and print them
102 to stdout.
103 all Enable all debugging output. In general this is not very
105 useful.
106 --datadir <data directory>
108 This option defines the directory where darktable finds its runtime
109 data. The default place depends on your installation. Typical
110 places are "/opt/darktable/share/darktable/" and
111 "/usr/share/darktable/".
112 --disable-opencl
114 Prevent darktable from initializing the OpenCL subsystem. Use this
115 option in case darktable crashes at startup due to a defective
116 OpenCL implementation.
117 -h, --help
119 Show the available command line options and exit.
120 --library <library file>
122 darktable keeps image information in an sqlite database for fast
123 access. The default location of that database file is
124 "$HOME/.config/darktable/library.db". You may give an alternative
125 location, e.g. if you want to do some experiments without
126 compromising your original library.db. If the database file does
127 not exist, darktable creates it for you. You may also give
128 ":memory:" as a library file in which case the database is kept in
129 system memory - all changes are discarded when darktable
130 terminates.
131 --localedir <locale directory>
133 The place where darktable finds its language specific text strings.
134 The default place depends on your installation. Typical places are
135 "/opt/darktable/share/locale/" and "/usr/share/locale/".
136 --luacmd <lua command>
138 A string containing lua commands to execute after lua
139 initialization. These commands will be run after your "luarc"
140 file.
141 If lua is not compiled in, this option will be accepted but won't
143 do anything.
144 --moduledir <module directory>
146 darktable has a modular structure and organizes its modules as
147 shared libraries for loading at runtime. With this option you tell
148 darktable where to look for its shared libraries. The default
149 place depends on your installation; typical places are
150 "/opt/darktable/lib/darktable/" and "/usr/lib/darktable/".
151 --noiseprofiles <noiseprofiles json file>
153 darktable's profiled denoise module uses camera specific profile
154 data that gets loaded from an external JSON file. With this option
155 the file to be loaded can be changed to allow testing alternative
156 profiles. The default profile file is "noiseprofiles.json" and is
157 typically found in "/opt/darktable/share/darktable/" or
158 "/usr/share/darktable/".
159 -t <num openmp threads>
161 darktable uses OpenMP to parallelize many computation steps and
162 make use of all the available CPU cores. With this option you can
163 specify the number of threads to use. Valid values are between 1
164 and 100.
165 --tmpdir <tmp directory>
167 The place where darktable stores its temporary files. If this
168 option is not supplied darktable uses the system default.
169 --version
171 Show the darktable version along with some important build options
172 and exit.
173
175 All modes
176 l Switch to lighttable view
178 d Switch to darkroom view
180 t Switch to tethered capture view
182 m Switch to map view
184 s Switch to slideshow view
186 p Switch to print view
188 . Switch between lighttable and darkroom views
190 Ctrl-q
192 Quit
193 F11 Switch between fullscreen and normal modes of the application's
195 window
196 Esc Leave fullscreen mode
198 Ctrl-h
200 Show/hide header
201 Tab Show/hide sidebars
203 Lighttable mode
205 g, Shift-g
207 Navigate to top, bottom row
208 PageUp, PageDown
210 Navigate one page up, down
211 ' Scroll center
213 Down, Left, Right, Up
215 Scroll down, left, right, up
216 z Preview image
218 Ctrl-z
220 Preview image with focus detection
221 F1, F2, F3, F4, F5
223 Color labels: toggle red, yellow, green, blue and purple
224 1, 2, 3, 4, 5
226 Star rating
227 0 Strip all stars
229 r Mark as rejected
231 l Realign images to the grid
233 Alt-1
235 Zoom in on first visible image
236 Alt-2, 3
238 Adjust zoom
239 Alt-4
241 Zoom out completely
242 Ctrl-a
244 Select all images
245 Ctrl-Shift-a
247 Select no images
248 Ctrl-i
250 Invert selection
251 Ctrl-d
253 Duplicate image
254 Ctrl-g, Ctrl-Shift-g
256 Group/ungroup selected images
257 Delete
259 Remove image from collection
260 Ctrl-c, Ctrl-Shift-c
262 Copy all, selected history
263 Ctrl-v, Ctrl-Shift-v
265 Paste all, selected history
266 Space
268 Toggle selection of an image
269 Return
271 Select an image
272 Ctrl-e
274 Export currently selected images
275 Ctrl-k
277 Jump back to the previous collection
278 Ctrl-t
280 Open a popup to quickly tag an image
281 Ctrl-Shift-i
283 Import a folder
284 Ctrl-j
286 Jump to the filmroll of an image
287 Darkroom mode
289 Alt-1, 2, 3
291 Zoom to 1:1, fill, and fit, respectively
292 Ctrl-f
294 Show/hide filmstrip
295 Space, Backspace
297 Step to next, previous image
298 Ctrl-e
300 Export current image
301 Ctrl-c, Ctrl-Shift-c
303 Copy all, selected history
304 Ctrl-v, Ctrl-Shift-v
306 Paste all, selected history
307 o Toggle show of over- and under-exposure
309 Ctrl-g
311 Toggle gamut check
312 Ctrl-s
314 Toggle softproofing
315 Enter
317 In Crop & Rotate module, commit the crop
318 [, ]
320 In Flip module, rotate 90 degrees ccw, cw
321 <, >
323 When drawing masks, decrease, increase brush opacity, respectively
324 {, }
326 When drawing masks, decrease, increase brush hardness, respectively
327 [, ]
329 When drawing masks, decrease, increase brush size, respectively
330 Tethered mode
332 Ctrl-f
334 Show/hide filmstrip
335 v Toggle live view
337 Map mode
339 Ctrl-f
341 Show/hide filmstrip
342 Ctrl-z
344 Undo
345 Ctrl-r
347 Redo
348 Filmstrip (when the cursor is on top of the filmstrip)
350 F1, F2, F3, F4, F5
352 Color labels: toggle red, yellow, green, blue and purple
353 1, 2, 3, 4, 5
355 Star rating
356 0 Strip all stars
358 r Mark as rejected
360 Ctrl-d
362 Duplicate image
363 Ctrl-a
365 Select all images
366 Ctrl-Shift-a
368 Select no images
369 Ctrl-i
371 Invert selection
372 Ctrl-c, Ctrl-Shift-c
374 Copy all, selected history
375 Ctrl-v, Ctrl-Shift-v
377 Paste all, selected history
378 Slideshow mode
380 Space
382 Start/stop playback
383
385 darktable-cli(1)
386
388 Please visit darktable's website for news, blog and bug tracker:
389 <https://www.darktable.org/>
390 <https://www.darktable.org/usermanual/> The complete darktable
392 usermanual.
393 darktablerc.html An overview over all default config settings. The
395 default place depends on your installation. Typical places are
396 "/opt/darktable/share/doc/darktable/" and "/usr/share/doc/darktable/".
397
399 Please use the bug tracker on
400 <https://github.com/darktable-org/darktable/issues> to report bugs,
401 feature requests and so on.
402
404 The principal developer of darktable is Johannes Hanika. The
405 (hopefully) complete list of contributors to the project is:
406 * developers: Pascal Obry Aurélien PIERRE Aldric Renaudin parafin Roman
408 Lebedev Tobias Ellinghaus
409 * translators: Jeronimo Pellegrini Pascal Obry EdgarLux Heiko Bauke
411 Martin Straeten Timur Davletshin Matjaž Jeran thisnamewasnottaken
412 vertama Arch Ont Bernhard Báthory Péter Matteo Mardegan Michel Leblond
413 Nicolas Auffray jpellegrini Alejandro Criado-Pérez Cyril Richard Danilo
414 Bargen Denny Biasiolli Diederik ter Rahe Jakub Filipowicz Marko
415 Vertainen Miroslav Fikar criadoperez mrleemon shlomi braitbart Łukasz
416 Karcz
417 * contributors (at least 4 commits): ralfbrown Hubert Kowalski Diederik
419 ter Rahe Jeronimo Pellegrini Dan Torop Philippe Weyland Chris.Elston
420 hanno@schwalm-bremen.de Heiko Bauke EdgarLux Mark-64 Nicolas Auffray
421 Harold le Clément de Saint-Marcq rawfiner Bill Ferguson David-Tillmann
422 Schaefer Miloš Komarčević Ralf Brown darkelectron Matt Maguire Martin
423 Straeten Alexis Mousset dterrahe Andreas Schneider Hanno Schwalm Timur
424 Davletshin Chris Elston Philipp Lutz matt-maguire
425 * Sub-module rawspeed contributors (at least 1 commit): Roman Lebedev
427 Bill Ferguson Josef Raschen Matt Maguire Philipp Normann Zanhard
428 frantic1048 parafin ponkotuy
429 * Sub-module OpenCL contributors (at least 1 commit):
431 * Sub-module libxcf contributors (at least 1 commit):
433 * Sub-module whereami contributors (at least 1 commit):
435 And all those of you that made previous releases possible
437 This man page was written by Alexandre Prokoudine
439 <alexandre.prokoudine@gmail.com> and Richard Levitte
440 <richard@levittr.org>. Additions were made by Tobias Ellinghaus
441 <me@houz.org>.
442
444 The project was started by Johannes Hanika in early 2009 to fill the
445 gap (or, rather, a black hole) of a digital photography workflow tool
446 on Linux.
447
449 Copyright (C) 2009-2017 by Authors.
450 darktable is free software; you can redistribute it and/or modify it
452 under the terms of the GPL v3 or (at your option) any later version.
453darktable 2.3 2017-01-20 DARKTABLE(1)