.\" Automatically generated by Pod::Man 2.22 (Pod::Simple 3.07)
.\"
.\" 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" ''
'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.
.ie \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.el \{\
.    de IX
..
.\}
.\"
.\" 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 "17219d" "darktable-a2ea27c" "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"
\&\f(CW\*(C`darktable [options] [IMG_1234.RAW]\*(C'\fR
.PP
Options:
.PP
.Vb 3
\&    \-\-help        
\&    \-\-version
\&    \-d {cache,control,dev,fswatch,perf}
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fBdarktable\fR is a digital photography workflow application for \fBLinux\fR 
and \fBMac \s-1OS\s0 X\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 postprocessing 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\-d control\fR" 4
.IX Item "-d control"
Enable job queue debugging. If you redirect darktables 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 "\fB\-d cache\fR" 4
.IX Item "-d 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 "\fB\-d perf\fR" 4
.IX Item "-d perf"
Use this for performance tweaking your darkroom modules. It will rdtsc-measure the
runtimes of all plugins and print them to stdout.
.SH "OTHER INFO"
.IX Header "OTHER INFO"
Please visit \fBdarktable\fR's website for news, bug tracker and forum: <http://darktable.sourceforge.net>
.SH "KEYBINDINGS"
.IX Header "KEYBINDINGS"
All modes:
.IP "\fBF11\fR" 4
.IX Item "F11"
Switch between fullscreen and normal modes of the application's window
.IP "\fBTab\fR" 4
.IX Item "Tab"
Show/hide sidebars
.IP "\fBe\fR" 4
.IX Item "e"
Switch between light-table and darkroom modes
.IP "\fBF7\fR" 4
.IX Item "F7"
Decrease contrast
.IP "\fBF8\fR" 4
.IX Item "F8"
Increase contrast
.PP
Lighttable mode:
.IP "\fBalt\-1\fR" 4
.IX Item "alt-1"
Zoom in on image under cursor
.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 "\fBq\fR" 4
.IX Item "q"
Zoom out to fit all images in one row inside viewport, center on image under cursor
.IP "\fBa, s, d, w\fR" 4
.IX Item "a, s, d, w"
Move around (arrows also work)
.IP "\fB1, 2, 3, 4\fR" 4
.IX Item "1, 2, 3, 4"
Star rating
.IP "\fBctrl-backspace\fR" 4
.IX Item "ctrl-backspace"
Strip all stars (reject image)
.IP "\fBF1, F2, F3\fR" 4
.IX Item "F1, F2, F3"
Color labels: toggle red, yellow, green
.IP "\fBctrl-g, ctrl-shift-g\fR" 4
.IX Item "ctrl-g, ctrl-shift-g"
Move to top, bottom, respectively
.IP "\fBctrl-e\fR" 4
.IX Item "ctrl-e"
Export selected images
.PP
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 "while cropping: \fBEnter/Backspace\fR" 4
.IX Item "while cropping: Enter/Backspace"
apply/revert currently selected cropping frame
.SH "BUGS"
.IX Header "BUGS"
Please use the mailing list to report all the bugs you run into.
.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.

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

* translation:
Alexandre Prokoudine,
Daniele Giorgis,
Ger Siemerink,
Henrik Andersson,
Josep Puigdemont,
Michał Prędotka,
Mikko Ruohola,
Olivier Tribout,
Roberto Quintero,
Sebastien Delcoigne,
Thomas Costis,
Tobias Ellinghaus.


* contributors:
Alexandre Prokoudine,
Alexander Rabtchevich,
Andrea Purracchio,
Andrey Kaminsky,
Anton Blanchard,
Bernhard Schneider,
Christian Fuchs,
Christian Himpel,
David Bremner,
Gregor Quade,
Jan Rinze,
Jose Carlos Garcia Sogo,
Mikko Ruohola,
Nao Nakashima,
Olivier Tribout,
Pascal de Bruijn,
Robert Park,
Richard Hughes,
Stephen van den Berg,
Stuart Henderson,
Thierry Leconte,
Tobias Ellinghaus,
Wyatt Olson,
Xavier Besse,
Zeus Panchenko.

.PP
This man page was written by Alexandre Prokoudine 
<alexandre.prokoudine@gmail.com>.
.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\-2010 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.