darktable 4.0: 3763 Days Later

Translations of this article: German.

A little over 10 years since darktable 1.0 was first released, the darktable team is proud to present darktable 4.0!

For a complete changelog, please see the release notes. The latest version of the user manual is here. Ukrainian and Polish translations are currently available and we expect to add more over the coming months.

Color and Exposure Mapping

A new “spot mapping” mode has been added to both the exposure and color calibration modules. This mode can be used, for example, to perform white balance (chromatic adaptation) against non-grey objects of known color, or to ensure color and exposure consistency of an object across a series of images. A “sampling” mode allows you to pick a reference color in a source image, recording the output exposure/color after the current exposure and color calibration modules respectively. The “correction” mode then mode computes the relevant exposure and color calibration settings so as to match the color selected from a matching sample picked from the target image. The target can also be manually defined by direct input of the appropriate CIE Lab 1976 color coordinates.

This feature was developed because copying and pasting a history stack over a series of images, even when shot in the same conditions, does not necessarily ensure uniform color rendition, and often still requires additional manual adjustment, since lighting may still vary slightly from image to image. From a single reference edit, the mapping feature ensures that the parameters scale properly to the rest of the series. Note that this color matching will still not be enough to ensure completely identical color/exposure perception across images, since perception is also dependent on the distribution of lightness in the image: a landscape that is 1/3 bright sky and 2/3 dark ground will not yield a color perception similar to a landscape with inverted sky/ground proportions, even though the color grading is the same and a colorimeter records the same values.

Color Glossary in the Global Color Picker

The global color picker has now been amended to display the name of the picked color in the tooltip when hovering over the displayed color values. This feature was requested by several color-impaired photographers to assert the perceptual validity of their editing regarding colors they don’t see in the same way as an average observer.

The color vocabulary contains 76 entries: 15 hues × 5 lightnesses + neutral (grey). It does not separate across the chroma axis, so all colors are registered the same no matter their colorfulness. The vocabulary also includes average skin colors for 3 body parts (forearm, forehead and cheek) of 6 ethnicities (Chinese, Thai, Kurdish, Mexican, Caucasian, African-American). These values were taken from academic databases of cosmetology and dermatology available at the time of development. They are only valid for a D65 illuminant, and for an exposure setting anchoring diffuse white at 92% relative luminance. Note that the skin type is returned at 95% confidence, and there is a significant overlap in skin color between ethnicities, so this tool is meant to ensure that a source color matches an average human skin ± 2 standard deviations, but does not infer the most probable ethnicity of your subject.

Filmic Version 6

The filmic rgb module is on its sixth iteration, now with new color science. As part of this work the mandatory desaturation (close to medium white and black) has been removed and replaced with a true gamut mapping against the output (or export) color space. This gamut mapping is performed using the ICC “relative colorimetric” intent, where we clip chroma to the maximum allowed in the output space at constant lightness and hue. This allows for more saturated colors, and is particularly noticeable in blue skies.

For users who still prefer the “desaturated highlights” look, the variant without chrominance preservation (processing RGB channels independently) does still allow it, but version 6 adds a hue handcuff to prevent the traditional hue shift that comes with this method (where saturated blue skies degrade to cyan and saturated red to yellow).

Out-of-gamut colors typically result from a saturation that is too high for a color’s luminance level, and therefore cannot be digitally encoded in bounded integer RGB spaces nor physically displayed on output media. This piece of gamut sanitization is the third and last to be added to darktable, which now has a fully sanitized color pipeline, from input (color calibration) to output (filmic v6), via artistic changes (color balance RGB). Users can now color-grade images safe in the knowledge that invalid input colors can be recovered in the least destructive fashion possible, early on in the pipeline, and valid colors can’t be pushed out of gamut.

Note that legacy (display-referred) modules are applied after filmic in the pipeline. These modules will not benefit from filmic’s gamut mapping and will rely on LittleCMS2 (if enabled) at the final export stage, which does not gamut map as it should. Also, since filmic v6 desaturates much less than v5 (only when colors would fall out of gamut) and preserves chromaticity by default, it will preserve invalid colors as well (clipped magenta highlights, chromatic aberrations) and will hide them less than before. Such colorful artifacts will need to be properly corrected with the relevant modules beforehand.

Introducing the darktable Uniform Color Space 2022

The color balance RGB module uses a saturation algorithm that was designed to simulate color shading as done traditionally by painters, meaning rich colorful colors degrade to light pastels, and pastels degrade to pure primary colors. This implies that some darkening needs to happen along with the saturation boost, and some brightening needs to happen along with any desaturation. This is unlike most “saturation” operators that act over chroma at constant lightness and may degrade saturated colors to a seemingly-fluorescent version of themselves, looking particularly bad on reflective objects.

Prior to darktable 4.0, the color balance RGB module used a custom saturation method involving the JzAzBz (2017) perceptually-uniform color space, which has proven to lack smoothness and darkened too much for the amount it resaturated. Also, the JzAzBz color space doesn’t account for the Helmholtz-Kohlrausch effect, which makes colors of high chroma appear brighter than their low-chroma equivalent, even when their lightness (or luminance) is constant.

A 3 month research project has resulted in the creation of a new perceptually-uniform color space designed specifically for the needs of the color balance RGB module’s saturation algorithm. This color space is the second “practically usable” published space that accounts for the contribution of colorfulness to the perception of brightness (Helmholtz-Kohlrausch effect), and was fitted on top of the Munsell renotation experimental dataset from 1943 (40 observers, 3 millions observations). To quantify the Helmholtz-Kohlrausch effect, four different brightness/chroma experimental datasets from 1963 to 2013 were used, with a total of 29 observers for 154 color samples. It took 26 hours for a computer to find the best fit by optimizing 23 parameters.

Although this changes nothing from a UI perspective, the saturation should be smoother to control, more perceptually-even across hues and yield a better saturating/darkening ratio. As with the previous method, it will prevent the degradation of colors toward fluorescent or neon. The previous JzAzBz variant is still available in the module as an option and will also be retained for old edits.

This perceptual space finally allows for a more accurate and computationally-efficient way to express the gamut of the working RGB space, which allows for gamut-mapping colors smoothly at constant brightness and hue, and will allow users to push saturation by large amounts without having to fear the consequences of gamut clipping (non-smooth hue shifts).

This research has been made possible solely by crowdfunding of the developer. The source code (Python, C, OpenCL) of the space has been released under a very permissive MIT license.

Guided Laplacian Highlight Reconstruction

Highlight reconstruction has long been a major pain-point in darktable, with issues made even more obvious by the scene-referred workflow and its chroma preservation.

The new guided laplacian reconstruction method in the highlight reconstruction module is a spin-off from the diffuse or sharpen module introduced in darktable 3.8. It uses the same iterative and multi-scale wavelet scheme to extract valid details from any non-clipped RGB channel(s) and uses these valid details to guide the reconstruction of clipped channels. The module then propagates color gradients from neighbouring valid regions, using edge-aware color diffusion that limits color bleeding through edges (preventing green leaves from bleeding color into the reconstruction of clipped blue sky, for example). It benefits from not depending on any perceptual definition of color and being immune to white balance, and yields smooth reconstructions, though it is efficient only for spotlights or simple shapes over small areas. For larger clipped areas, it may fail to entirely remove the magenta color and, for complex shapes, may create strange patterns and color bleeding. In these situations, the filmic module’s highlight reconstruction is to be preferred or used as a complement, since it has a more basic and robust way of in-painting color.

An additional noise setting allows you to add Poisson noise (the natural type of noise that affects the collection of photons) into reconstructed highlights, to help blend them into noisy high-ISO images where smooth color gradients would immediately be de-toned.

As with any reconstruction method attempting to infer damaged content from analysis of the neighborhood, this method comes with a number of assumptions and trade-offs. The first caveat is its computational price, which will require a GPU to run in reasonable timescales – the computational time increases with the radius of reconstruction. For this reason, the default settings assume fairly small radii, meaning that large blown-out areas will not be reconstructed properly until you adjust settings manually. The second caveat is that this method does not use a perceptual framework, since it works before any color profiling or calibration (and even prior to demosaicing in the pipe) so it cannot rely on a definition of white that would allow it to simply desaturate highlights to avoid magenta. For this reason, other methods may work better for very large blown-out areas, and the filmic module’s highlight reconstruction may be needed in order to force desaturation to white. In addition, since it in-paints the damaged parts of the image, this method will make the sun disc blend into the rest of the sky for sunset scenes, because it enforces a smooth reconstruction. Masking may be needed to exclude the sun (or the moon) to prevent it from merging into the sky.

Finally, this method is only available for Bayer sensors – is cannot be adapted directly to X-Trans sensors due to their non-uniform pattern.

Speed-ups and Optimizations

The stress-test inflicted on the pixel pipe by resource-intensive modules such as “diffuse or sharpen” have revealed bugs and shortcomings in the way that OpenCL drivers handle GPU memory. The code planning and memory allocation for GPUs has therefore been corrected and almost entirely rewritten, and tiling strategies for X-Trans demosaicing and retouch modules have been fixed.

New “user friendly” planning strategies for GPU memory use have been added to the global preferences dialog, allowing users to minimize memory use and/or memory read-write cycles, and can now be changed at runtime without requiring a restart. The power-user OpenCL optimizations (compilation flags and memory sizes) can now be tuned for each OpenCL device independently. See the memory & performance tuning section of the user manual for more details.

The wavelet decomposition used in filmic’s highlight reconstruction, diffuse or sharpen, and the guided laplacian highlights reconstruction have been rewritten for better performance (15 to 25% faster).

Darktable 4.2

As usual, the next feature release is already in development. Here are a couple of features you can expect to find under the Christmas tree this year…

A CYM channel-mixer will allow users to digitally restore scans of damaged prints and films. Since dyes and pigments don’t age at the same rate, their colors shift – usually towards red. However, the current toolset of darktable, centered around an additive RGB framework, doesn’t play well with subtractive CYM(K) media and this needs a proper display-referred CYM tool.

A new color equalizer module will be able to replace the existing color zones module. It will be compatible with HDR signals and use the new darktable Uniform Color Space 2022, with a simplified UI, built-in gamut mapping against pipeline RGB space and a protection against chroma noise. It will complement the color balance RGB module for minor and fine-grained color tweaks such as color replacement.

Share this on: Twitter | Facebook

This is a companion discussion topic for the original entry at https://www.darktable.org/2022/07/darktable-4.0/

Congratulations and thank you to the entire darktable team for all of your hard work. Your efforts are greatly appreciated!


It’s impressive to see how dt evolve.
As a simple user I can simply say “thank you very much to all involved in making this happen!”

1 Like

Even in July, it always feels like Christmas when a new darktable version is released! Thanks to all the devs, translators and other darktable team members who are delivering such a wonderful photographic tool.

The translators are some real unsung heroes. Being an English speaker I am spoiled and not forced to deal with this aspect of learning and using DT. Those that spend the time to open up the UI and documentation should be applauded in abundance


Thank you everyone involved! I’m new to this forum, but just want to say how much I appreciate all the work that goes into DT. It’s great.


Congratulations to all involved, really appreciated. Best version yet!
Filmic v6 + Colour balance RGB presets = instantly nice looking, natural vibrant results with no unwanted surprises. Wonder how many complaints we will get that it is difficult to get good results with darktable now?


I love how the “no” preservation mode in Filmic v6 works!


Once again my deepest respect to everybody working on this.
Thank you very much!

I love all the new stuff in DT4, including the collection filters which to me make sense (I like the “pin/unpin button” to show/hide them above the pictures grid). Brilliant work ! Greatest respect to the devs who spent their free time giving to the community for free. Special thanks to the maintainer, the doc writters, the bug fixers, the packagers, and all those who are involved in this incredible and amazing project !!
And long live respectful debates, collaboration, mind openness. And this from a software engineer having more than 40 years of experience, so I think there is a possibility that I may have some ideas about what is good design or not, although I recognise that software design is NOT a science.


Yes! I’m noticing that too. Much better!

THANK YOU, to everyone who made this 4.0 version happen. Can’t wait to starting playing with it!

Thank you Darktable team for your dedication and knowledge. This has produced a great product for many of us to enjoy.

Thank you to all of the dev team for all of the hard work on this new release!

I built the 4.0 yesterday and while I haven’t had that much time to play with it yet, my initial impression is that filmic v6 is an improvement over the previous iterations and Guided laplacians mode for the highlight recovery is a nice addition for highlight recovery arsenal in DT, which has sometimes felt like a bit of a weak spot for it.

Thanks to the developers for another great step forward in developing images. Tonight I am off to teach my photography students about Darktable. Filmic has become so easy to use. For most images I just use the auto tune levels and then move on to tools like tone equalizer. The preset “add basic colorfulness: skin tone” is a nice addition for color balance RGB module. The denoise (profiled) defaults are very good for most images. All these small improvements add up to a great program.

1 Like

Yes I find the No option gives more natural looking images especially with skin tones. Perhaps it might not be technically correct but I prefer the look of slightly desaturated highlights.

But those desaturated highights should be scene highlights, not necessarily the brightest parts of your image. One of the issues I had with filmic is what happens to e.g. close-ups of flowers (esp, yellow) : you could either accept them going partially white, or keep the brightness below maximum.

And “screen white” != “scene white”, if only because a screen (let alone paper) has a very limited dynamic range compared to most scenes, as soon as there’s a bit of direct light (and shadow).

I believe this very issue should be now addressed fairly well with filmic v6. Just choose a norm that you like (requires a bit of experimenting). I find myself liking the Euclidean norm for rose pics.


Just want to add my thanks to everyone involved with darktable. I enjoy and appreciate the advances in each new revision.