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

NAME

6       darktable - a digital photography workflow application
7

SYNOPSIS

9       "darktable [options] [{IMG_1234.RAW,/path/to/load/}]"
10
11       Options:
12
13           --help
14           --version
15           -d {cache,control,dev,fswatch,perf,all}
16           --library override.db
17           --disable-opencl
18           -t num_threads
19

DESCRIPTION

21       darktable is a digital photography workflow application for Linux and
22       Mac OS X in the lines of Adobe Lightroom and Apple Aperture.
23
24       The application is designed to ease editing and consistent processing
25       of large photo sessions and provides a easy to use digital light-table
26       and a set of sophisticated postprocessing tools.
27
28       Most processing is done in 32-bit floating point per channel mode in
29       device independent CIE L*a*b* color space. darktable is also fully
30       color managed, which gives you full control over the look of the
31       photos.
32
33       The application relies on a modern plug-in architecture thus making it
34       easy for 3rd party developers to extend the existing capabilities of
35       the application.  All light-table and darkroom features are implemented
36       as plug-ins, so you can create your plug-ins reusing existing code.
37

COMMAND LINE ARGUMENTS

39       IMG_1234.CR2 or /path/to/load/
40           Loads the given image in darkroom mode, or imports the given
41           folder.
42
43       -d control
44           Enable job queue debugging. If you redirect darktables output to
45           control.log and call ./tools/create_control_svg.sh control.log, you
46           will get a nice control.svg with a visualization of the threads'
47           work.
48
49       -d cache
50           This will give you a lot of debugging info about the mipmap cache
51           for light table mode. If compiled in debug mode, this will also
52           tell you where in the code a certain buffer has last been locked.
53
54       -d perf
55           Use this for performance tweaking your darkroom modules. It will
56           rdtsc-measure the runtimes of all plugins and print them to stdout.
57
58       -d all
59           Enable all debugging output.
60
61       --library override.db
62           Uses override.db instead of the gconf/darktablerc specified library
63           file. Should be an absolute path.
64
65       --disable-opencl
66           For opencl builds only. Disables GPU computing at runtime. Useful
67           to check for bugs in our opencl code and to avoid buggy drivers on
68           certain machines.
69
70       -t num_threads
71           For openmp builds only. Overrides the default number of threads (=
72           number of cores).
73

OTHER INFO

75       Please visit darktable's website for news, bug tracker and forum:
76       <http://darktable.sourceforge.net>
77

KEYBINDINGS

79       All modes:
80
81       F11 Switch between fullscreen and normal modes of the application's
82           window
83
84       Tab Show/hide sidebars
85
86       e   Switch between light-table and darkroom modes
87
88       F7  Decrease contrast
89
90       F8  Increase contrast
91
92       Lighttable mode:
93
94       alt-1
95           Zoom in on image under cursor
96
97       alt-2, 3
98           Adjust zoom
99
100       alt-4
101           Zoom out completely
102
103       q   Zoom out to fit all images in one row inside viewport, center on
104           image under cursor
105
106       a, s, d, w
107           Move around (arrows also work)
108
109       1, 2, 3, 4, 5
110           Star rating
111
112       ctrl-backspace
113           Strip all stars (reject image)
114
115       F1, F2, F3, F4, F5
116           Color labels: toggle red, yellow, green, blue and magenta
117
118       ctrl-g, ctrl-shift-g
119           Move to top, bottom, respectively
120
121       ctrl-e
122           Export selected images
123
124       Darkroom mode:
125
126       alt-1, 2, 3
127           Zoom to 1:1, fill, and fit, respectively
128
129       ctrl-f
130           show/hide film strip
131
132       while cropping: Enter/Backspace
133           apply/revert currently selected cropping frame
134
136       darktable-faster first copies the library to ram and then starts dt. On
137       close, it is copied back, so even in case of crashes no data loss is
138       anticipated.
139       darktable-viewer screensaver version of dt. Shows the last active
140       collection in full screen as a slideshow.
141

BUGS

143       Please use the mailing list to report all the bugs you run into.
144

AUTHORS

146       The principal developer of darktable is Johannes Hanika. The
147       (hopefully) complete list of contributors to the project is:
148
149       * developers: Henrik Andersson, Johannes Hanika.
150
151       * ubuntu packaging, color management, video tutorials: Pascal de
152       Bruijn.
153
154       * translation: Alexandre Prokoudine, Daniele Giorgis, Ger Siemerink,
155       Henrik Andersson, Josep Puigdemont, Michał Prędotka, Mikko Ruohola,
156       Olivier Tribout, Roberto Quintero, Sebastien Delcoigne, Thomas Costis,
157       Tobias Ellinghaus.
158
159
160       * contributors: Alexandre Prokoudine, Alexander Rabtchevich, Andrea
161       Purracchio, Andrey Kaminsky, Anton Blanchard, Bernhard Schneider, Bruce
162       Guenter, Christian Fuchs, Christian Himpel, Daniele Giorgis, David
163       Bremner, Gregor Quade, Jan Rinze, Jose Carlos Garcia Sogo, Mikko
164       Ruohola, Nao Nakashima, Olivier Tribout, Pascal de Bruijn, Richard
165       Hughes, Robert Park, Stephen van den Berg, Stuart Henderson, Thierry
166       Leconte, Tobias Ellinghaus, Wyatt Olson, Xavier Besse, Zeus Panchenko.
167
168
169       This man page was written by Alexandre Prokoudine
170       <alexandre.prokoudine@gmail.com>.
171

HISTORY

173       The project was started by Johannes Hanika in early 2009 to fill the
174       gap (or, rather, a black hole) of a digital photography workflow tool
175       on Linux.
176
178       Copyright (C) 2009-2010 by Authors.
179
180       darktable is free software; you can redistribute it and/or modify it
181       under the terms of the GPL v3 or (at your option) any later version.
182
183
184
185darktable-0.9.3                     21205d                        DARKTABLE(1)
Impressum