December 6, 2025

Deprecated Modules & Their Modern Alternatives

Darktable is developing rapidly. What was “best practice” three years ago is often considered obsolete today. The reason for this is usually the switch to the so-called Scene-Referred Workflow. This new approach ensures more natural colors, better highlight recovery, and fewer artifacts (such as halos).

So that you don’t accidentally use modules that degrade your image quality, here is an overview of the “legacy” modules and what you should use instead.

Why we advise against these modules

Darktable prides itself on its backward compatibility. This means: Even modules developed 10 years ago are still there today so you can open old edits.

But: Many of these modules (often called “display-referred”) work according to logic that no longer fits the modern, physically correct workflow (“scene-referred”).

If you mix these old modules into a modern editing process, it can lead to problems:

Halos (light fringes) around edges
Unnatural color shifts
Loss of image information in bright areas

Our philosophy on darktable.info:
We want to show you the best possible, future-proof way. That’s why we mark these modules here as “Deprecated” or “Not recommended”. Experienced professionals may use them for special effects – but as a beginner, you make life unnecessarily difficult for yourself if you use them.

1. Sharpen

This is the classic “Unsharp Mask” (USM) known from the past.

Why avoid?
It amplifies image noise extremely and quickly creates ugly bright edges (halos) on contrast edges. The result often looks “digital”, artificial, and over-sharpened.

The modern alternatives:

Today we have three tools that can do this much better:

Capture Sharpening:
- What for: The absolute basis. It retrieves the details lost through the sensor filter.
- Advantage: Extremely simple (usually just on/off) and low noise.
Contrast Equalizer:
- What for: To make structures and textures crisper.
- Advantage: Very intuitive to use and creates no halos.
Diffuse or Sharpen:
- What for: The high-end solution for perfectionists.
- Tip: Use the preset “Lens Deblur” here. It calculates the blur out physically correctly instead of just overdrawing edges.

2. Shadows and Highlights

Formerly the standard tool to brighten dark areas and darken bright ones.

Why avoid? In the modern workflow, it often leads to dull images and local loss of contrast. In addition, halos quickly appear around objects (e.g., trees against a bright sky).
The modern alternative: Tone Equalizer.
- It is more powerful, preserves local contrast better, and avoids halos almost completely. Operation via the “cursor in image” is also very intuitive.

3. Base Curve

For a long time, the module that gave the RAW image the typical “JPEG look”.

Why avoid? The base curve often blows out highlights too early and makes colors in bright areas pale (Hue Shift). It works “display-referred” and clips data that we might need later.
The modern alternative: AgX (or Filmic RGB, Sigmoid).
- These modules gently map the camera’s huge dynamic range to your monitor without destroying colors. Sigmoid is often easier to use and delivers crisper results “out of the box”.
- From DT 5.4, AgX is the best choice.

4. White Balance – Partially

Attention: The module “White Balance” is still needed, but differently!
The change: In the modern workflow, you only set the “White Balance” module to “Camera reference” (often standard).
The modern alternative: You make the actual creative adjustment (warmer/cooler) in the module Color Calibration. It offers much more powerful tools for color adjustment (CAT) and handles difficult light better.

5. Local Contrast

Status: Conditionally recommended.

What is this about?
This is not about light/dark (AgX does that), but about structure and clarity. The module is supposed to make the image “crisper”.

Why be careful?
The old module often works roughly and quickly creates unnatural edges (halos).

The better alternatives for more “Pop”:

Contrast Equalizer:
The king of structures. Here you can decide specifically: Do you want to sharpen the finest details or make rough shapes more plastic? This gives you much more control without side effects.
Diffuse or Sharpen:
The preset “Add local contrast” ensures extremely clean, fine structures and gives the image the finishing touch that AgX alone often does not deliver.

Summary: Your Modern Toolbox

Now you know what you should not use anymore. But what instead?
If you are new to Darktable (or switching), concentrate on these “Big 5+1”. With these, you cover 95% of your edits – faster and with better quality:

Exposure: Control brightness (midtones).
Color Calibration: The modern white balance.
AgX (or Sigmoid): Tame contrast & dynamic range.
Tone Equalizer: Brighten shadows, recover highlights (without halos!).
Color Balance RGB: Saturation, color grading & brilliance.

+1. Sharpness & Details (Optional):
At the very end, when the look is set.

Capture Sharpening (in RAW)
Contrast Equalizer or Diffuse/Sharpen (for the “Pop”)
Denoise

What’s next?
How to use these modules in the correct order and how they work together, you will learn step by step in the next chapter: Standard Workflow