1DARKTABLE(1)                       darktable                      DARKTABLE(1)
2
3
4

NAME

6       darktable - a digital photography workflow application
7

SYNOPSIS

9           darktable [options] [IMG_1234.{RAW,...}|image_folder/]
10
11       Options:
12
13           --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

DESCRIPTION

31       darktable is a digital photography workflow application for Linux, Mac
32       OS X and several other Unices.
33
34       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
38       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
43       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

OPTIONS

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
60       --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
66       --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
73       --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
78       -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
84           A few of those debug options are:
85
86           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
92           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
98           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
103           all Enable all debugging output. In general this is not very
104               useful.
105
106       --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
112       --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
117       -h, --help
118           Show the available command line options and exit.
119
120       --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
131       --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
136       --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
141           If lua is not compiled in, this option will be accepted but won't
142           do anything.
143
144       --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
151       --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
159       -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
165       --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
169       --version
170           Show the darktable version along with some important build options
171           and exit.
172

DEFAULT KEYBINDINGS

174       All modes
175
176       l   Switch to lighttable view
177
178       d   Switch to darkroom view
179
180       t   Switch to tethered capture view
181
182       m   Switch to map view
183
184       s   Switch to slideshow view
185
186       p   Switch to print view
187
188       .   Switch between lighttable and darkroom views
189
190       Ctrl-q
191           Quit
192
193       F11 Switch between fullscreen and normal modes of the application's
194           window
195
196       Esc Leave fullscreen mode
197
198       Ctrl-h
199           Show/hide header
200
201       Tab Show/hide sidebars
202
203       Lighttable mode
204
205       g, Shift-g
206           Navigate to top, bottom row
207
208       PageUp, PageDown
209           Navigate one page up, down
210
211       '   Scroll center
212
213       Down, Left, Right, Up
214           Scroll down, left, right, up
215
216       z   Preview image
217
218       Ctrl-z
219           Preview image with focus detection
220
221       F1, F2, F3, F4, F5
222           Color labels: toggle red, yellow, green, blue and purple
223
224       1, 2, 3, 4, 5
225           Star rating
226
227       0   Strip all stars
228
229       r   Mark as rejected
230
231       l   Realign images to the grid
232
233       Alt-1
234           Zoom in on first visible image
235
236       Alt-2, 3
237           Adjust zoom
238
239       Alt-4
240           Zoom out completely
241
242       Ctrl-a
243           Select all images
244
245       Ctrl-Shift-a
246           Select no images
247
248       Ctrl-i
249           Invert selection
250
251       Ctrl-d
252           Duplicate image
253
254       Ctrl-g, Ctrl-Shift-g
255           Group/ungroup selected images
256
257       Delete
258           Remove image from collection
259
260       Ctrl-c, Ctrl-Shift-c
261           Copy all, selected history
262
263       Ctrl-v, Ctrl-Shift-v
264           Paste all, selected history
265
266       Space
267           Toggle selection of an image
268
269       Return
270           Select an image
271
272       Ctrl-e
273           Export currently selected images
274
275       Ctrl-k
276           Jump back to the previous collection
277
278       Ctrl-t
279           Open a popup to quickly tag an image
280
281       Ctrl-Shift-i
282           Import a folder
283
284       Ctrl-j
285           Jump to the filmroll of an image
286
287       Darkroom mode
288
289       Alt-1, 2, 3
290           Zoom to 1:1, fill, and fit, respectively
291
292       Ctrl-f
293           Show/hide filmstrip
294
295       Space, Backspace
296           Step to next, previous image
297
298       Ctrl-e
299           Export current image
300
301       Ctrl-c, Ctrl-Shift-c
302           Copy all, selected history
303
304       Ctrl-v, Ctrl-Shift-v
305           Paste all, selected history
306
307       o   Toggle show of over- and under-exposure
308
309       Ctrl-g
310           Toggle gamut check
311
312       Ctrl-s
313           Toggle softproofing
314
315       Enter
316           In Crop & Rotate module, commit the crop
317
318       [, ]
319           In Flip module, rotate 90 degrees ccw, cw
320
321       <, >
322           When drawing masks, decrease, increase brush opacity, respectively
323
324       {, }
325           When drawing masks, decrease, increase brush hardness, respectively
326
327       [, ]
328           When drawing masks, decrease, increase brush size, respectively
329
330       Tethered mode
331
332       Ctrl-f
333           Show/hide filmstrip
334
335       v   Toggle live view
336
337       Map mode
338
339       Ctrl-f
340           Show/hide filmstrip
341
342       Ctrl-z
343           Undo
344
345       Ctrl-r
346           Redo
347
348       Filmstrip (when the cursor is on top of the filmstrip)
349
350       F1, F2, F3, F4, F5
351           Color labels: toggle red, yellow, green, blue and purple
352
353       1, 2, 3, 4, 5
354           Star rating
355
356       0   Strip all stars
357
358       r   Mark as rejected
359
360       Ctrl-d
361           Duplicate image
362
363       Ctrl-a
364           Select all images
365
366       Ctrl-Shift-a
367           Select no images
368
369       Ctrl-i
370           Invert selection
371
372       Ctrl-c, Ctrl-Shift-c
373           Copy all, selected history
374
375       Ctrl-v, Ctrl-Shift-v
376           Paste all, selected history
377
378       Slideshow mode
379
380       Space
381           Start/stop playback
382

SEE ALSO

384       darktable-cli(1)
385

OTHER INFO

387       Please visit darktable's website for news, blog and bug tracker:
388       <https://www.darktable.org/>
389
390       <https://www.darktable.org/usermanual/> The complete darktable
391       usermanual.
392
393       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

REPORTING BUGS

398       Please use the bug tracker on
399       <https://www.darktable.org/redmine/projects/darktable/issues/> to
400       report bugs, feature requests and so on.
401

AUTHORS

403       The principal developer of darktable is Johannes Hanika.  The
404       (hopefully) complete list of contributors to the project is:
405
406       * developers: Pascal Obry, Tobias Ellinghaus, Roman Lebedev, Stefan
407       Schöfegger, Ulrich Pegelow, Peter Budai, parafin, johannes hanika,
408       Alexandre Prokoudine, Aldric Renaudin, Pascal de Bruijn, Edouard Gomez.
409
410       * translators: Pascal Obry, Ger Siemerink, Michel Leblond, Nilvus,
411       Timur I. Davletshin, Tobias Ellinghaus, mepi0011, Maurizio Paglia,
412       Alexandre Prokoudine, Báthory Péter, Heiko Bauke, Jeronimo Pellegrini,
413       Matjaž Jeran, Ulrich Pegelow, Aurélien PIERRE, EdgarLux, Josep V.
414       Moragues, Marko Vertainen, Milan Knížek, Novy Sawai, Ragnar Wisløff,
415       Tomasz Golinski.
416
417       * contributors (at least 4 commits): Aurélien PIERRE, rawfiner,
418       edgardoh, Dan Torop, Matthieu Moy, Ger Siemerink, Michel Leblond, Heiko
419       Bauke, Maurizio Paglia, Andreas Schneider, Nilvus, Rikard Öxler, Timur
420       I. Davletshin, mepi0011, Benoit Brummer, Philippe Weyland, grand-piano,
421       luzpaz, Mario Lueder, Robert Bridge.
422
423       * RawSpeed contributors (at least 1 commit): Roman Lebedev Robert
424       Bridge bobobo1618 luz.paz Bastian Bechtold Pascal de Bruijn dllu
425       hanno@schwalm-bremen.de junkyardsparkle
426
427       And all those of you that made previous releases possible
428
429       This man page was written by Alexandre Prokoudine
430       <alexandre.prokoudine@gmail.com> and Richard Levitte
431       <richard@levittr.org>.  Additions were made by Tobias Ellinghaus
432       <me@houz.org>.
433

HISTORY

435       The project was started by Johannes Hanika in early 2009 to fill the
436       gap (or, rather, a black hole) of a digital photography workflow tool
437       on Linux.
438
440       Copyright (C) 2009-2017 by Authors.
441
442       darktable is free software; you can redistribute it and/or modify it
443       under the terms of the GPL v3 or (at your option) any later version.
444
445
446
447darktable 2.3                     2017-01-20                      DARKTABLE(1)
Impressum