darktable page lede image
darktable page lede image


Frequently Asked Questions

Some commonly asked questions can be found in our FAQ. Please read it before reporting bugs or feature requests.

User manual


The new manual can be read here:

In the following sections, you can find the old manual which will be discontinued after 3.4.

You can read the manual online (v3.4):

or download it in PDF format (v3.4):

Lua API documentation

darktable’s Lua API is documented in its own manual with a detailed description of all data structures and functions. You can either read the documentation online or download the API manual from here.

darktable Styles


There is an online repository with darktable styles available for download at https://dtstyle.net/. It features live preview of the styles with four different sample images.

To create a new darktable style just alter your image the way you want. Then click the button located in the history module in darkroom mode to create a style from the current history stack. In advanced options you can include or exclude single modules. To export or import a new style use the styles module in lighttable mode.

The book


Stefano Fornari, Mario Latronico and Nicholas Manea wrote a book about photo development with darktable:

Digital photo development with darktable Manage and develop your digital images with darktable.

It introduces you to the process of developing your images with darktable explaining the basic features. It starts over with a simple tutorial on importing and developing your first photo(s). After describing the darktable user interface it provides some workflow suggestions and background informations on (perception of light, sensors, patterns, colors).

You can download the pdf or packaged version of the current release (v1.1.1). Your comments and feedback are always welcome on the darktable user mailing list.

Screencast tutorials


Screencasts recorded using the latest development versions of darktable

There are many brilliant screencasts on darktable, its various modules and general image development workflow made by Robert Hutton. You can get the full playlist of these very educational screencasts here:

Pascal de Bruijn provides several useful screencasts on his website explaining the different functions of dartkable. Find the 0.7 screencast library, the 0.9 screencast library addition and the 1.0 screencast library addition or just pick the one you want:

Screencasts recorded using darktable 1.0

Screencasts recorded using darktable 0.9

Screencasts recorded using darktable 0.7 (but still valid)

Tutorial videos in Spanish (with subtitles in French and English)

(courtesy of  Juan Luis Fernández Gallo and translated by Paulo C. Santos Garcia and Marie-Noëlle Augendre)

Tutorial videos in French

There is also a set of French videos available that cover a good part of darktable. Starting by a nice overview and deep into the settings of the darkrooms’ modules.

Tutorials and videos in German

Some nice screencasts for darktable in German. Check them out:


Related but not only suitable for darktable is his screencast on how to create helpful backtraces with gdb:

Supported Cameras


See our support matrix for the status of camera support: