NAME¶

darktable - a digital photography workflow application

SYNOPSIS¶

"darktable [options] [{IMG_1234.RAW,/path/to/load/}]" Options:

    --help        
    --version
    -d {all,cache,camctl,control,dev,fswatch,memory,opencl,perf,pwstorage,sql}
    --library override.db
    --disable-opencl
    -t num_threads

DESCRIPTION¶

darktable is a digital photography workflow application for Linux and Mac OS X in the lines of Adobe Lightroom and Apple Aperture. 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. Most processing is done in 32-bit floating point per channel mode in device independent CIE L*a*b* color space. darktable is also fully color managed, which gives you full control over the look of the photos. 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.

COMMAND LINE ARGUMENTS¶

IMG_1234.CR2 or /path/to/load/

Loads the given image in darkroom mode, or imports the given folder.

-d control

Enable job queue debugging. If you redirect darktables output to control.log and call ./tools/create_control_svg.sh control.log, you will get a nice control.svg with a visualization of the threads' work.

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

-d perf

Use this for performance tweaking your darkroom modules. It will rdtsc-measure the runtimes of all plugins and print them to stdout.

-d all

Enable all debugging output.

--library override.db

Uses override.db instead of the gconf/darktablerc specified library file. Should be an absolute path.

--disable-opencl

For opencl builds only. Disables GPU computing at runtime. Useful to check for bugs in our opencl code and to avoid buggy drivers on certain machines.

-t num_threads

For openmp builds only. Overrides the default number of threads (= number of cores).

OTHER INFO¶

Please visit darktable's website for news, bug tracker and forum: <http://www.darktable.org>

KEYBINDINGS¶

All modes:

F11

Switch between fullscreen and normal modes of the application's window

Tab

Show/hide sidebars

e

Switch between light-table and darkroom modes

F7

Decrease contrast

F8

Increase contrast

Lighttable mode:

alt-1

Zoom in on image under cursor

alt-2, 3

Adjust zoom

alt-4

Zoom out completely

q

Zoom out to fit all images in one row inside viewport, center on image under cursor

a, s, d, w

Move around (arrows also work)

1, 2, 3, 4, 5

Star rating

ctrl-backspace

Strip all stars (reject image)

F1, F2, F3, F4, F5

Color labels: toggle red, yellow, green, blue and magenta

ctrl-g, ctrl-shift-g

Move to top, bottom, respectively

ctrl-e

Export selected images

Darkroom mode:

alt-1, 2, 3

Zoom to 1:1, fill, and fit, respectively

ctrl-f

show/hide film strip

while cropping: Enter/Backspace

apply/revert currently selected cropping frame

RELATED¶

darktable-faster first copies the library to ram and then starts dt. On close, it is copied back, so even in case of crashes no data loss is anticipated.

darktable-viewer screensaver version of dt. Shows the last active collection in full screen as a slideshow.

BUGS¶

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

AUTHORS¶

The principal developer of darktable is Johannes Hanika. The (hopefully) complete list of contributors to the project is: * developers: Henrik Andersson, Johannes Hanika, Tobias Ellinghaus. * ubuntu packaging, color management, video tutorials: Pascal de Bruijn. * opencl pipeline: Ulrich Pegelow. * networking, battle testing, translation expert: Alexandre Prokoudine. * 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 Alexey Dokuchaev Ammon Riley Antony Dovgal Boucman Brian Teague Bruce Guenter Cherrot Luo Denis Cheremisov Edouard Gomez Edward Herr František Šidák Ger Siemerink Gianluigi Calcaterra James C. McPherson Joao Trindade Jose Carlos Garcia Sogo Michał Prędotka Moritz Lipp Olivier Tribout Pascal de Bruijn Petr Styblo Robert Bieber Rostyslav Pidgornyi Sergey Pavlov Simon Spannagel Terry Jeffress Tim Harder Tom Vanderpoel Ulrich Pegelow jan maigl And all those of you that made previous releases possible This man page was written by Alexandre Prokoudine <alexandre.prokoudine@gmail.com>.

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.

COPYRIGHT AND LICENSE¶

Copyright (C) 2009-2010 by Authors. darktable is free software; you can redistribute it and/or modify it under the terms of the GPL v3 or (at your option) any later version.