.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "DARKTABLE 1"
.TH DARKTABLE 1 "2017-01-20" "darktable 2.3" "darktable"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
darktable \- a digital photography workflow application
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 1
\&    darktable [options] [IMG_1234.{RAW,...}|image_folder/]
.Ve
.PP
Options:
.PP
.Vb 10
\&    \-\-cachedir <user cache directory>
\&    \-\-conf <key>=<value>
\&    \-\-configdir <user config directory>
\&    \-d {all,cache,camctl,camsupport,control,dev,fswatch,imageio,input,
\&        ioporder,lighttable,lua,masks,memory,nan,opencl,params,perf,
\&        pwstorage,print,signal,sql,undo}
\&    \-\-datadir <data directory>
\&    \-\-disable\-opencl
\&    \-h, \-\-help
\&    \-\-library <library file>
\&    \-\-localedir <locale directory>
\&    \-\-luacmd <lua command>
\&    \-\-moduledir <module directory>
\&    \-\-noiseprofiles <noiseprofiles json file>
\&    \-t <num openmp threads>
\&    \-\-tmpdir <tmp directory>
\&    \-\-version
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fBdarktable\fR is a digital photography workflow application for \fBLinux\fR, \fBMac \s-1OS X\s0\fR and several other \fBUnices\fR.
.PP
The application is designed to ease editing and consistent processing of large
photo sessions and provides an easy to use digital lighttable and a set
of sophisticated post-processing tools.
.PP
Most processing is done in 32\-bit floating point per channel mode in device independent
\&\fB\s-1CIE\s0 L*a*b*\fR color space.
\&\fBdarktable\fR is also fully color managed, which gives you full control over the look of the photos.
.PP
The application relies on a modern plugin architecture thus making it easy for
3rd party developers to extend the existing capabilities of the application.
All lighttable and darkroom features are implemented as plugins, so you can
create your plugins reusing existing code.
Most workflow specific things can also be scripted in \fBLua\fR.
.SH "OPTIONS"
.IX Header "OPTIONS"
.IP "\fB\s-1IMG_1234.RAW\s0 or image_folder/\fR" 4
.IX Item "IMG_1234.RAW or image_folder/"
You may optionally supply the filename of an image or the name of a folder containing image files.
If a filename is given darktable starts in darkroom view with that file opened.
If a folder is given darktable starts in lighttable view with the content of that folder as the current collection.
If there is already an instance of darktable running (using the same library) the image or folder will be opened
there, using \fBD\-Bus\fR to communicate between the two processes.
.IP "\fB\-\-cachedir <cache directory>\fR" 4
.IX Item "--cachedir <cache directory>"
darktable keeps a cache of image thumbnails for fast image preview and of precompiled OpenCL binaries for fast startup.
By default the cache is located in \f(CW\*(C`$HOME/.cache/darktable/\*(C'\fR.
There may exist multiple thumbnail caches in parallel \- one for each library file.
.IP "\fB\-\-conf <key>=<value>\fR" 4
.IX Item "--conf <key>=<value>"
darktable supports a rich set of configuration parameters which the
user defines in \f(CW\*(C`darktablerc\*(C'\fR \- darktable's configuration file in the
user config directory.
You may temporarily overwrite individual settings on the command line with this option \- however, these
settings will not be stored in \f(CW\*(C`darktablerc\*(C'\fR.
.IP "\fB\-\-configdir <config directory>\fR" 4
.IX Item "--configdir <config directory>"
This option defines the directory where darktable stores the user specific configuration.
The default place is \f(CW\*(C`$HOME/.config/darktable/\*(C'\fR.
.IP "\fB\-d <debug option>\fR" 4
.IX Item "-d <debug option>"
This option enables debug output to the terminal.
There are several subsystems of darktable and debugging of each of them can be activated separately.
You can use this option multiple times if you want debugging output of more than one subsystem.
.Sp
A few of those debug options are:
.RS 4
.IP "\fBcontrol\fR" 4
.IX Item "control"
Enable job queue debugging.
If you redirect darktable's output to \fBcontrol.log\fR and call \fB./tools/create_control_svg.sh control.log\fR,
you will get a nice \fBcontrol.svg\fR with a visualization of the threads' work.
.IP "\fBcache\fR" 4
.IX Item "cache"
This will give you a lot of debugging info about the thumbnail cache for lighttable mode.
If compiled in debug mode, this will also tell you where in the code a certain buffer has last been locked.
.IP "\fBperf\fR" 4
.IX Item "perf"
Use this for performance tweaking your darkroom modules.
It will rdtsc-measure the runtimes of all plugins and print them to stdout.
.IP "\fBall\fR" 4
.IX Item "all"
Enable all debugging output. In general this is not very useful.
.RE
.RS 4
.RE
.IP "\fB\-\-datadir <data directory>\fR" 4
.IX Item "--datadir <data directory>"
This option defines the directory where darktable finds its runtime data.
The default place depends on your installation.
Typical places are \f(CW\*(C`/opt/darktable/share/darktable/\*(C'\fR and \f(CW\*(C`/usr/share/darktable/\*(C'\fR.
.IP "\fB\-\-disable\-opencl\fR" 4
.IX Item "--disable-opencl"
Prevent darktable from initializing the OpenCL subsystem.
Use this option in case darktable crashes at startup due to a defective OpenCL implementation.
.IP "\fB\-h\fR, \fB\-\-help\fR" 4
.IX Item "-h, --help"
Show the available command line options and exit.
.IP "\fB\-\-library <library file>\fR" 4
.IX Item "--library <library file>"
darktable keeps image information in an sqlite database for fast access.
The default location of that database file is \f(CW\*(C`$HOME/.config/darktable/library.db\*(C'\fR.
You may give an alternative location, e.g. if you want to do some experiments without compromising your original library.db.
If the database file does not exist, darktable creates it for you.
You may also give \f(CW\*(C`:memory:\*(C'\fR as a library file in which case the database is kept in system memory \- all
changes are discarded when darktable terminates.
.IP "\fB\-\-localedir <locale directory>\fR" 4
.IX Item "--localedir <locale directory>"
The place where darktable finds its language specific text strings.
The default place depends on your installation.
Typical places are \f(CW\*(C`/opt/darktable/share/locale/\*(C'\fR and \f(CW\*(C`/usr/share/locale/\*(C'\fR.
.IP "\fB\-\-luacmd <lua command>\fR" 4
.IX Item "--luacmd <lua command>"
A string containing lua commands to execute after lua initialization.
These commands will be run after your \f(CW\*(C`luarc\*(C'\fR file.
.Sp
If lua is not compiled in, this option will be accepted but won't do anything.
.IP "\fB\-\-moduledir <module directory>\fR" 4
.IX Item "--moduledir <module directory>"
darktable has a modular structure and organizes its modules as shared libraries for loading at runtime.
With this option you tell darktable where to look for its shared libraries.
The default place depends on your installation; typical places are
\&\f(CW\*(C`/opt/darktable/lib/darktable/\*(C'\fR and \f(CW\*(C`/usr/lib/darktable/\*(C'\fR.
.IP "\fB\-\-noiseprofiles <noiseprofiles json file>\fR" 4
.IX Item "--noiseprofiles <noiseprofiles json file>"
darktable's profiled denoise module uses camera specific profile data that gets loaded from an external \s-1JSON\s0 file.
With this option the file to be loaded can be changed to allow testing alternative profiles.
The default profile file is \f(CW\*(C`noiseprofiles.json\*(C'\fR and is typically found in
\&\f(CW\*(C`/opt/darktable/share/darktable/\*(C'\fR or \f(CW\*(C`/usr/share/darktable/\*(C'\fR.
.IP "\fB\-t <num openmp threads>\fR" 4
.IX Item "-t <num openmp threads>"
darktable uses OpenMP to parallelize many computation steps and make use of all the available \s-1CPU\s0 cores.
With this option you can specify the number of threads to use. Valid values are between \f(CW1\fR and \f(CW100\fR.
.IP "\fB\-\-tmpdir <tmp directory>\fR" 4
.IX Item "--tmpdir <tmp directory>"
The place where darktable stores its temporary files.
If this option is not supplied darktable uses the system default.
.IP "\fB\-\-version\fR" 4
.IX Item "--version"
Show the darktable version along with some important build options and exit.
.SH "DEFAULT KEYBINDINGS"
.IX Header "DEFAULT KEYBINDINGS"
\fIAll modes\fR
.IX Subsection "All modes"
.IP "\fBl\fR" 4
.IX Item "l"
Switch to lighttable view
.IP "\fBd\fR" 4
.IX Item "d"
Switch to darkroom view
.IP "\fBt\fR" 4
.IX Item "t"
Switch to tethered capture view
.IP "\fBm\fR" 4
.IX Item "m"
Switch to map view
.IP "\fBs\fR" 4
.IX Item "s"
Switch to slideshow view
.IP "\fBp\fR" 4
.IX Item "p"
Switch to print view
.IP "\fB.\fR" 4
.IX Item "."
Switch between lighttable and darkroom views
.IP "\fBCtrl-q\fR" 4
.IX Item "Ctrl-q"
Quit
.IP "\fBF11\fR" 4
.IX Item "F11"
Switch between fullscreen and normal modes of the application's window
.IP "\fBEsc\fR" 4
.IX Item "Esc"
Leave fullscreen mode
.IP "\fBCtrl-h\fR" 4
.IX Item "Ctrl-h"
Show/hide header
.IP "\fBTab\fR" 4
.IX Item "Tab"
Show/hide sidebars
.PP
\fILighttable mode\fR
.IX Subsection "Lighttable mode"
.IP "\fBg, Shift-g\fR" 4
.IX Item "g, Shift-g"
Navigate to top, bottom row
.IP "\fBPageUp, PageDown\fR" 4
.IX Item "PageUp, PageDown"
Navigate one page up, down
.IP "\fB'\fR" 4
.IX Item "'"
Scroll center
.IP "\fBDown, Left, Right, Up\fR" 4
.IX Item "Down, Left, Right, Up"
Scroll down, left, right, up
.IP "\fBz\fR" 4
.IX Item "z"
Preview image
.IP "\fBCtrl-z\fR" 4
.IX Item "Ctrl-z"
Preview image with focus detection
.IP "\fBF1, F2, F3, F4, F5\fR" 4
.IX Item "F1, F2, F3, F4, F5"
Color labels: toggle red, yellow, green, blue and purple
.IP "\fB1, 2, 3, 4, 5\fR" 4
.IX Item "1, 2, 3, 4, 5"
Star rating
.IP "\fB0\fR" 4
.IX Item "0"
Strip all stars
.IP "\fBr\fR" 4
.IX Item "r"
Mark as rejected
.IP "\fBl\fR" 4
.IX Item "l"
Realign images to the grid
.IP "\fBAlt\-1\fR" 4
.IX Item "Alt-1"
Zoom in on first visible image
.IP "\fBAlt\-2, 3\fR" 4
.IX Item "Alt-2, 3"
Adjust zoom
.IP "\fBAlt\-4\fR" 4
.IX Item "Alt-4"
Zoom out completely
.IP "\fBCtrl-a\fR" 4
.IX Item "Ctrl-a"
Select all images
.IP "\fBCtrl-Shift-a\fR" 4
.IX Item "Ctrl-Shift-a"
Select no images
.IP "\fBCtrl-i\fR" 4
.IX Item "Ctrl-i"
Invert selection
.IP "\fBCtrl-d\fR" 4
.IX Item "Ctrl-d"
Duplicate image
.IP "\fBCtrl-g, Ctrl-Shift-g\fR" 4
.IX Item "Ctrl-g, Ctrl-Shift-g"
Group/ungroup selected images
.IP "\fBDelete\fR" 4
.IX Item "Delete"
Remove image from collection
.IP "\fBCtrl-c, Ctrl-Shift-c\fR" 4
.IX Item "Ctrl-c, Ctrl-Shift-c"
Copy all, selected history
.IP "\fBCtrl-v, Ctrl-Shift-v\fR" 4
.IX Item "Ctrl-v, Ctrl-Shift-v"
Paste all, selected history
.IP "\fBSpace\fR" 4
.IX Item "Space"
Toggle selection of an image
.IP "\fBReturn\fR" 4
.IX Item "Return"
Select an image
.IP "\fBCtrl-e\fR" 4
.IX Item "Ctrl-e"
Export currently selected images
.IP "\fBCtrl-k\fR" 4
.IX Item "Ctrl-k"
Jump back to the previous collection
.IP "\fBCtrl-t\fR" 4
.IX Item "Ctrl-t"
Open a popup to quickly tag an image
.IP "\fBCtrl-Shift-i\fR" 4
.IX Item "Ctrl-Shift-i"
Import a folder
.IP "\fBCtrl-j\fR" 4
.IX Item "Ctrl-j"
Jump to the filmroll of an image
.PP
\fIDarkroom mode\fR
.IX Subsection "Darkroom mode"
.IP "\fBAlt\-1, 2, 3\fR" 4
.IX Item "Alt-1, 2, 3"
Zoom to 1:1, fill, and fit, respectively
.IP "\fBCtrl-f\fR" 4
.IX Item "Ctrl-f"
Show/hide filmstrip
.IP "\fBSpace, Backspace\fR" 4
.IX Item "Space, Backspace"
Step to next, previous image
.IP "\fBCtrl-e\fR" 4
.IX Item "Ctrl-e"
Export current image
.IP "\fBCtrl-c, Ctrl-Shift-c\fR" 4
.IX Item "Ctrl-c, Ctrl-Shift-c"
Copy all, selected history
.IP "\fBCtrl-v, Ctrl-Shift-v\fR" 4
.IX Item "Ctrl-v, Ctrl-Shift-v"
Paste all, selected history
.IP "\fBo\fR" 4
.IX Item "o"
Toggle show of over\- and under-exposure
.IP "\fBCtrl-g\fR" 4
.IX Item "Ctrl-g"
Toggle gamut check
.IP "\fBCtrl-s\fR" 4
.IX Item "Ctrl-s"
Toggle softproofing
.IP "\fBEnter\fR" 4
.IX Item "Enter"
In Crop & Rotate module, commit the crop
.IP "\fB[, ]\fR" 4
.IX Item "[, ]"
In Flip module, rotate 90 degrees ccw, cw
.IP "\fB<, >\fR" 4
.IX Item "<, >"
When drawing masks, decrease, increase brush opacity, respectively
.IP "\fB{, }\fR" 4
.IX Item "{, }"
When drawing masks, decrease, increase brush hardness, respectively
.IP "\fB[, ]\fR" 4
.IX Item "[, ]"
When drawing masks, decrease, increase brush size, respectively
.PP
\fITethered mode\fR
.IX Subsection "Tethered mode"
.IP "\fBCtrl-f\fR" 4
.IX Item "Ctrl-f"
Show/hide filmstrip
.IP "\fBv\fR" 4
.IX Item "v"
Toggle live view
.PP
\fIMap mode\fR
.IX Subsection "Map mode"
.IP "\fBCtrl-f\fR" 4
.IX Item "Ctrl-f"
Show/hide filmstrip
.IP "\fBCtrl-z\fR" 4
.IX Item "Ctrl-z"
Undo
.IP "\fBCtrl-r\fR" 4
.IX Item "Ctrl-r"
Redo
.PP
\fIFilmstrip (when the cursor is on top of the filmstrip)\fR
.IX Subsection "Filmstrip (when the cursor is on top of the filmstrip)"
.IP "\fBF1, F2, F3, F4, F5\fR" 4
.IX Item "F1, F2, F3, F4, F5"
Color labels: toggle red, yellow, green, blue and purple
.IP "\fB1, 2, 3, 4, 5\fR" 4
.IX Item "1, 2, 3, 4, 5"
Star rating
.IP "\fB0\fR" 4
.IX Item "0"
Strip all stars
.IP "\fBr\fR" 4
.IX Item "r"
Mark as rejected
.IP "\fBCtrl-d\fR" 4
.IX Item "Ctrl-d"
Duplicate image
.IP "\fBCtrl-a\fR" 4
.IX Item "Ctrl-a"
Select all images
.IP "\fBCtrl-Shift-a\fR" 4
.IX Item "Ctrl-Shift-a"
Select no images
.IP "\fBCtrl-i\fR" 4
.IX Item "Ctrl-i"
Invert selection
.IP "\fBCtrl-c, Ctrl-Shift-c\fR" 4
.IX Item "Ctrl-c, Ctrl-Shift-c"
Copy all, selected history
.IP "\fBCtrl-v, Ctrl-Shift-v\fR" 4
.IX Item "Ctrl-v, Ctrl-Shift-v"
Paste all, selected history
.PP
\fISlideshow mode\fR
.IX Subsection "Slideshow mode"
.IP "\fBSpace\fR" 4
.IX Item "Space"
Start/stop playback
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBdarktable\-cli\fR\|(1)
.SH "OTHER INFO"
.IX Header "OTHER INFO"
Please visit \fBdarktable\fR's website for news, blog and bug tracker: <https://www.darktable.org/>
.PP
<https://www.darktable.org/usermanual/> The complete darktable usermanual.
.PP
\&\fBdarktablerc.html\fR An overview over all default config settings.
The default place depends on your installation.
Typical places are \f(CW\*(C`/opt/darktable/share/doc/darktable/\*(C'\fR and \f(CW\*(C`/usr/share/doc/darktable/\*(C'\fR.
.SH "REPORTING BUGS"
.IX Header "REPORTING BUGS"
Please use the bug tracker on
<https://github.com/darktable\-org/darktable/issues> to report
bugs, feature requests and so on.
.SH "AUTHORS"
.IX Header "AUTHORS"
The principal developer of darktable is Johannes Hanika.
The (hopefully) complete list of contributors to the project is:
.PP
* developers:
Pascal Obry
Aldric Renaudin
Roman Lebedev
parafin
Edouard Gomez

* translators:
Pascal Obry
Victor Forsiuk
Jeronimo Pellegrini
Martin Straeten
Kang-Wei Hsu
EdgarLux
Besmir Godolja
Ryo Shinozaki
Serkan ÖNDER
mmardegan
Luca Cignoni
Marko Vertainen
Maurizio Paglia
Marcus Gama
Nicolas Auffray
Báthory Péter
Matjaž Jeran
Matt Maguire
Petr Stasiak
Stephan Hoek
bajdero
Matteo Mardegan
alex
alexbora
Яна Тунгушпаева

* contributors (at least 4 commits):
Hanno Schwalm
Victor Forsiuk
Diederik ter Rahe
Miloš Komarčević
jandren
Jeronimo Pellegrini
Nicolas Auffray
Martin Straeten
Kang-Wei Hsu
Simone Gotti
Sakari Kapanen
EdgarLux
rawfiner
Besmir Godolja
cyruscook
quovadit
Ryo Shinozaki
Philippe Weyland
Ralf Brown
Chris Elston
Serkan ÖNDER
mmardegan
Luca Cignoni
Apfelkraut
Marcus Gama
Marko Vertainen
Maurizio Paglia
Simon Raffeiner

* Sub-module rawspeed contributors (at least 1 commit):
Roman Lebedev
Miloš Komarčević
Daniel Vogelbacher
maruncz
Alex Tutubalin
Artemis Tosini
Georg Lukas
Georg Niedrist
LibRaw LLC
Marko Toplak
Milos Komarcevic
Pascal Obry
PeterWem
Simon Raffeiner
Sprite
luz paz
squid-f
ubergeek801

* Sub-module integration contributors (at least 1 commit):
Pascal Obry

And all those of you that made previous releases possible
.PP
This man page was written by Alexandre Prokoudine
<alexandre.prokoudine@gmail.com> and Richard Levitte
<richard@levittr.org>.
Additions were made by Tobias Ellinghaus <me@houz.org>.
.SH "HISTORY"
.IX Header "HISTORY"
The project was started by Johannes Hanika in early 2009 to fill the gap
(or, rather, a black hole) of a digital photography workflow tool on Linux.
.SH "COPYRIGHT AND LICENSE"
.IX Header "COPYRIGHT AND LICENSE"
\&\fBCopyright (C)\fR 2009\-2017 by Authors.
.PP
\&\fBdarktable\fR is free software; you can redistribute it and/or modify it
under the terms of the \s-1GPL\s0 v3 or (at your option) any later version.