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,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

DESCRIPTION

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

OPTIONS

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
61       --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
67       --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
74       --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
79       -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
85           A few of those debug options are:
86
87           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
93           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
99           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
104           all Enable all debugging output. In general this is not very
105               useful.
106
107       --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
113       --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
118       -h, --help
119           Show the available command line options and exit.
120
121       --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
132       --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
137       --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
142           If lua is not compiled in, this option will be accepted but won't
143           do anything.
144
145       --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
152       --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
160       -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
166       --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
170       --version
171           Show the darktable version along with some important build options
172           and exit.
173

DEFAULT KEYBINDINGS

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

SEE ALSO

385       darktable-cli(1)
386

OTHER INFO

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

REPORTING BUGS

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

AUTHORS

404       The principal developer of darktable is Johannes Hanika.  The
405       (hopefully) complete list of contributors to the project is:
406
407       * developers: Pascal Obry Aldric Renaudin Roman Lebedev parafin Edouard
408       Gomez
409
410       * translators: Victor Forsiuk Pascal Obry Jeronimo Pellegrini Martin
411       Straeten Kang-Wei Hsu Ryo Shinozaki Besmir Godolja Nicolas Auffray
412       Tianhao Chai Matjaž Jeran Báthory Péter EdgarLux bajdero shinoryo
413       shlomi François Delègue Hanno Schwalm Mario Zimmermann Marko Vertainen
414       Tobias Kühne Яна Тунгушпаева
415
416       * contributors (at least 4 commits): Victor Forsiuk Ralf Brown Hanno
417       Schwalm Diederik ter Rahe Miloš Komarčević Dan Torop Jeronimo
418       Pellegrini Martin Straeten Mario Zimmermann Mark-64 Kang-Wei Hsu
419       Nicolas Auffray rawfiner Serkan ÖNDER Bill Ferguson Ryo Shinozaki
420       Simone Gotti lhietal Besmir Godolja Dmitry Stoyanov Manuel Presnitz
421       Petr Stasiak Tianhao Chai shonjir
422
423       * Sub-module rawspeed contributors (at least 1 commit): Roman Lebedev
424       Miloš Komarčević Jordan Neumeyer Philipp Lutz Thomas Baumann Howard
425       Liberty
426
427       * Sub-module integration contributors (at least 1 commit): Pascal Obry
428       ralfbrown Simone Gotti
429
430       And all those of you that made previous releases possible.
431
432       This man page was written by Alexandre Prokoudine
433       <alexandre.prokoudine@gmail.com> and Richard Levitte
434       <richard@levittr.org>.  Additions were made by Tobias Ellinghaus
435       <me@houz.org>.
436

HISTORY

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