.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.28)
.\"
.\" 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 turned on, 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
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "DARKTABLE 1"
.TH DARKTABLE 1 "24856d" "darktable-1.4.2" "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
\&    \-d {all,cache,camctl,control,dev,fswatch,
\&        input,lighttable,masks,memory,nan,opencl,
\&        perf,pwstorage,sql}
\&    \-\-disable\-opencl 
\&    \-\-library <library file> 
\&    \-\-datadir <data directory> 
\&    \-\-moduledir <module directory>
\&    \-\-tmpdir <tmp directory> 
\&    \-\-configdir <user config directory>
\&    \-\-cachedir <user cache directory>
\&    \-\-localedir <locale directory>
\&    \-\-conf <key>=<value>
\&    \-\-help        
\&    \-\-version
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fBdarktable\fR is a digital photography workflow application for \fBLinux\fR 
and \fBMac \s-1OS X\s0\fR in the lines of \fBAdobe Lightroom\fR and \fBApple Aperture\fR.
.PP
The application is designed to ease editing and consistent processing of large 
photo sessions and provides a easy to use digital light-table 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 plug-in architecture thus making it easy for 
3rd party developers to extend the existing capabilities of the application. 
All light-table and darkroom features are implemented as plug-ins, so you can 
create your plug-ins reusing existing code.
.SH "COMMAND LINE ARGUMENTS"
.IX Header "COMMAND LINE ARGUMENTS"
.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.
.IP "\fB\-d <debugoption>\fR" 4
.IX Item "-d <debugoption>"
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 debugoptions 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 mipmap cache for
light table 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.
.RE
.RS 4
.RE
.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\-\-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\-\-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\-\-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/lib64/darktable/\*(C'\fR and \f(CW\*(C`/usr/lib64/darktable/\*(C'\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\-\-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\-\-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\-\-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\-\-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.
.SH "DEFAULT KEYBINDINGS"
.IX Header "DEFAULT KEYBINDINGS"
\fIAll modes\fR
.IX Subsection "All modes"
.IP "\fBl\fR" 4
.IX Item "l"
Switch to lightroom 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 "\fBF7\fR" 4
.IX Item "F7"
Decrease contrast
.IP "\fBF8\fR" 4
.IX Item "F8"
Increase contrast
.IP "\fBF9\fR" 4
.IX Item "F9"
Decrease brightness
.IP "\fBF10\fR" 4
.IX Item "F10"
Increase brightness
.IP "\fBEsc\fR" 4
.IX Item "Esc"
Leave fullscreen mode
.IP "\fB<Primary>q\fR" 4
.IX Item "<Primary>q"
Quit
.IP "\fBperiod\fR" 4
.IX Item "period"
Switch between lighttable and darkroom views
.IP "\fBF11\fR" 4
.IX Item "F11"
Switch between fullscreen and normal modes of the application's window
.IP "\fB<Primary>h\fR" 4
.IX Item "<Primary>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 "\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 "\fB<Primary>a\fR" 4
.IX Item "<Primary>a"
Select all images
.IP "\fB<Primary><Shift>a\fR" 4
.IX Item "<Primary><Shift>a"
Select no images
.IP "\fB<Primary>i\fR" 4
.IX Item "<Primary>i"
Invert selection
.IP "\fB<Primary>g, <Primary><Shift>g\fR" 4
.IX Item "<Primary>g, <Primary><Shift>g"
Group/ungroup selected images
.IP "\fBDelete\fR" 4
.IX Item "Delete"
Remove image from collection
.IP "\fB<Primary>c, <Primary><Shift>c\fR" 4
.IX Item "<Primary>c, <Primary><Shift>c"
Copy all, selected history
.IP "\fB<Primary>v, <Primary><Shift>v\fR" 4
.IX Item "<Primary>v, <Primary><Shift>v"
Paste all, selected history
.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 film strip
.IP "\fBSpace, Backspace\fR" 4
.IX Item "Space, Backspace"
Step to next, previous image
.IP "\fB<Primary>e\fR" 4
.IX Item "<Primary>e"
Export current image
.IP "\fBo\fR" 4
.IX Item "o"
Toggle show of over\- and under-exposure
.IP "\fB<Primary>c, <Primary><Shift>c\fR" 4
.IX Item "<Primary>c, <Primary><Shift>c"
Copy all, selected history
.IP "\fB<Primary>v, <Primary><Shift>v\fR" 4
.IX Item "<Primary>v, <Primary><Shift>v"
Paste all, selected history
.IP "\fBg\fR" 4
.IX Item "g"
Toggle gamut check
.IP "\fBs\fR" 4
.IX Item "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
.PP
\fITethered mode\fR
.IX Subsection "Tethered mode"
.IP "\fB<Primary>f\fR" 4
.IX Item "<Primary>f"
Show/hide film strip
.IP "\fBv\fR" 4
.IX Item "v"
Toggle live view
.PP
\fIMap mode\fR
.IX Subsection "Map mode"
.IP "\fB<Primary>f\fR" 4
.IX Item "<Primary>f"
Show/hide film strip
.IP "\fB<Primary>z\fR" 4
.IX Item "<Primary>z"
Undo
.IP "\fB<Primary>r\fR" 4
.IX Item "<Primary>r"
Redo
.PP
\fIFilm strip (when the cursor is on top of the film strip)\fR
.IX Subsection "Film strip (when the cursor is on top of the film strip)"
.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 "\fB<Primary>d\fR" 4
.IX Item "<Primary>d"
Duplicate image
.IP "\fB<Primary>c, <Primary><Shift>c\fR" 4
.IX Item "<Primary>c, <Primary><Shift>c"
Copy all, selected history
.IP "\fB<Primary>v, <Primary><Shift>v\fR" 4
.IX Item "<Primary>v, <Primary><Shift>v"
Paste all, selected history
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fIdarktable\-cli\fR\|(1)
.SH "OTHER INFO"
.IX Header "OTHER INFO"
Please visit \fBdarktable\fR's website for news, bug tracker and forum: <http://www.darktable.org/>
.SH "RELATED"
.IX Header "RELATED"
.IP "\fBdarktable-viewer\fR screensaver version of darktable. Shows the last active collection in full screen as a slideshow." 4
.IX Item "darktable-viewer screensaver version of darktable. Shows the last active collection in full screen as a slideshow."
.SH "REPORTING BUGS"
.IX Header "REPORTING BUGS"
Please use the bug tracker on
<http://www.darktable.org/redmine/projects/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:
Henrik Andersson,
Johannes Hanika,
Tobias Ellinghaus,
Ulrich Pegelow.

* ubuntu packaging, color management, video tutorials:
Pascal de Bruijn.

* opencl pipeline, usermanual:
Ulrich Pegelow.

* networking, battle testing, translation expert:
Alexandre Prokoudine.

* translation:
a3novy,
Alexandre Prokoudine,
Anocha Yimsiriwattana,
Artur de Sousa Rocha,
Daniele Giorgis,
Dimitrios Psychogios,
Ger Siemerink,
Guilherme Brondani Torri,
Henrik Andersson,
José Carlos Casimiro,
Josep Puigdemont,
María Leandro,
Mauro Bartoccelli,
Michał Prędotka,
Mikko Ruohola,
Milan Knížek,
Olivier Tribout,
Pascal Obry,
Richard Levitte,
Roberto Quintero,
Sebastien Delcoigne,
Thomas Costis,
Thomas Pryds,
Tobias Ellinghaus,
Victor Lamoine.

* contributors:
Aldric Renaudin,
Alexandre Prokoudine,
Alexey Dokuchaev,
Ammon Riley,
Anton Keks,
Antony Dovgal,
Ari Makela,
Benjamin Cahill,
Brian Teague,
Bruce Guenter,
Cherrot Luo,
Chris Mason,
Christian Tellefsen,
David Morel,
Denis Cheremisov,
Dennis Gnad,
Diego Segura,
Dimitrios Psychogios,
Eckhart Pedersen,
Edouard Gomez,
Edward Herr,
František Šidák,
Gaspard Jankowiak,
Ger Siemerink,
Gianluigi Calcaterra,
Guilherme Brondani Torri,
Ivan Tarozzi,
James C. McPherson,
Jan Kundrát,
Jean-Sébastien Pédron,
Jérémy Rosen,
Jesper Pedersen,
Joao Trindade,
Jon Leighton,
Jose Carlos Garcia Sogo,
Josef Wells,
Julian J. M,
Mattias Eriksson,
Michal Babej,
Michał Prędotka,
Moritz Lipp,
Olivier Tribout,
Pascal de Bruijn,
Pascal Obry,
parafin,
Petr Styblo,
Pierre Le Magourou,
Richard Levitte,
Richard Tollerton,
Robert Bieber,
Roland Riegel,
Roman Lebedev,
Rostyslav Pidgornyi,
Sergey Pavlov,
Simon Harhues,
Simon Spannagel,
Stuart Henderson,
Terry Jeffress,
Tim Harder,
Togan Muftuoglu,
Tom Vanderpoel,
Ulrich Pegelow,
Wolfgang Goetz,
Wolfgang Kuehnel,
Yari Adan,
hal,
jan,
maigl,
tuxuser.
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>.
.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\-2013 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.