Add film grain and halation in darktable
Grain and halation are two of the traits people add to make a digital photo look like film. darktable 5.6 has a grain module. It has no halation module, but its blur and mask tools can build one. This guide covers both, step by step, from the darktable 5.6 user manual; where the manual says nothing, we read the darktable 5.6.0 source code.
Short answer. Add grain with the grain module, once color and tone are set: coarseness sets the size of the grain on a scale that imitates film speed, strength sets how visible it is, and mid-tones bias keeps it out of the deepest shadows and brightest highlights [1]. Check it at 1:1 and on the exported file. For halation, the glow around bright lights, darktable 5.6 has no dedicated module [6] [7]: blur the image in a new module instance, restrict it to the highlights with a parametric mask, and let it change the red channel only.
How darktable’s grain module works
The grain module simulates the grain of film on the lightness channel only, the L channel of Lab, so it adds no colored specks [1]. It has three controls [1] [2]:
| Control | What it does | Range and default |
|---|---|---|
| coarseness | The size of the grain, “scaled to simulate an ISO number” | 20 to 6400 ISO; default 1600 |
| strength | How visible the grain is | 0 to 100 %; default 25 % |
| mid-tones bias | The higher it is, the less grain shows in the shadows and highlights | 0 to 100 %; default 100 % |
- Where it sits. The scene-referred workflow uses the v5.0 module order [4]. In it, grain comes after the tone mapper (sigmoid, filmic rgb or AgX) and before soften, split-toning and vignetting [3]: it works on the tones you see.
- Its size follows the frame. darktable computes the grain relative to the shorter side of the image, not in pixels [2]. It still shows less on a small export than on a large one [18].
- One pattern per file. The pattern is seeded from the file name: each photo gets its own grain, and a photo gets the same grain each time it is processed [2].
How to set grain that looks like film
- Finish color and tone first. Grain comes late in the module order [3]: set the look, then add grain on top.
- Choose the coarseness from the film you imitate. The scale imitates film speed [1]: a low value for a slow, fine-grained film, a high one for a fast film. Each film page gives the grain figure of the film’s datasheet, as RMS granularity or Print Grain Index.
- Set the strength at the size the photo will be seen. Middle-click the image to switch to 1:1 [5] and look at the grain itself, then at the whole frame, then at the exported file.
- Keep the mid-tones bias high for clean blacks and whites. Lower it to put grain in the shadows and highlights too [1].
- Add grain on top of blurred areas. If you blur part of an image, the manual suggests a little grain on top, so the area does not look “suspiciously clean” [10].
Not sure the photo needs grain at all? See film grain vs digital noise.
Is there a halation module in darktable?
Not in darktable 5.6, the current version (5.6.2, released October 4, 2026). The manual’s list of processing modules has no halation module, and the release notes of versions 5.0 to 5.6 do not mention one [6] [7]. The development branch has a film simulation module, Spektrafilm; the draft release notes of the next version say it “includes film grain, halation, and diffusion”, without a release date [8].
Halation is a glow around bright lights and edges, caused by light reflected back into the film. Many films, and almost all motion picture films, have a layer that prevents it [9]. Films with little or no such protection show red halos, such as CineStill 800T and Harman Phoenix 200.
How to build halation from darktable’s modules
The idea: blur the image in a new module instance, keep the blur on the brightest areas with a parametric mask, and let it change the red channel only, so the glow is red. Community methods build it this way [15] [16].
With the blurs module
- Add a new instance of blurs and name it “halation”. Choose the gaussian blur type, which the manual describes as meant for creative effects with blend modes [10]. The blur radius sets how far the glow spreads; darktable 5.6 allows up to 256 px [7].
- Set the blend mode to RGB red channel. The red channel then comes from the blurred image, and the green and blue channels stay as they were [11].
- Add a parametric mask on the highlights. Raise the lower bound of a luminance channel so only the brightest tones are selected. In scene-referred editing, the boost factor helps target highlights above 100 % [12].
- Soften the mask. Its blurring radius and feathering let the glow fade out around the lights; display the mask to check what it covers [13].
- Dose the effect with the mask opacity [13], then check it at 1:1 [5].
With diffuse or sharpen
Start from its artistic effects | bloom preset, which the manual suggests for a bloom or Orton effect, then use the same blend mode and mask [14]. A 2024 walkthrough does it this way, with the details threshold of the mask to keep the glow on contrasty edges [15]. The module is heavy to compute, OpenCL is strongly recommended, and its output is exact only at 1:1 and in a full-size or high quality export [14].
Good to know
- The bloom module blurs in Lab color space, and the manual no longer recommends it [17].
- Screen and lighten blend modes are not available in the RGB (scene) blending color space [11].
- To reuse your halation, save it as a style: parametric masks are kept in a style, drawn shapes are not. See how to create your own style.
Get the look ready-made
The Grain Archive styles set darktable’s grain module from each film’s datasheet figures [18]. Four of them also contain a blurs instance named “halation”: Harman Phoenix 200, Harman Phoenix II 200, ORWO Wolfen NC200 and ORWO Wolfen NC400. The free pack holds four styles to try first, without halation.
Grain Archive Lab is the standalone way on Mac: it gives each film its grain from the datasheet, and halation with its own controls. See Grain Archive Lab.
Sources
- 1M darktable 5.6 user manual: grain Accessed November 6, 2026.
- 2M darktable 5.6.0 source code: src/iop/grain.c (ranges, defaults, grain pattern) Accessed November 6, 2026.
- 3M darktable 5.6.0 source code: src/common/iop_order.c (default module order v5.0) Accessed November 6, 2026.
- 4M darktable 5.6 user manual: the pixelpipe and module order Accessed November 6, 2026.
- 5M darktable 5.6 user manual: darkroom overview (zoom) Accessed November 6, 2026.
- 6M darktable 5.6 user manual: processing modules (list, deprecated modules) Accessed November 6, 2026.
- 7M darktable releases on GitHub: 5.0.0 to 5.6.2 release notes Accessed November 6, 2026.
- 8M darktable development branch: draft release notes of the next version (unreleased) Accessed November 6, 2026.
- 9C Wikipedia: Anti-halation backing Accessed November 6, 2026.
- 10M darktable 5.6 user manual: blurs Accessed November 6, 2026.
- 11M darktable 5.6 user manual: blend modes Accessed November 6, 2026.
- 12M darktable 5.6 user manual: parametric masks Accessed November 6, 2026.
- 13M darktable 5.6 user manual: mask refinement and additional controls Accessed November 6, 2026.
- 14M darktable 5.6 user manual: diffuse or sharpen Accessed November 6, 2026.
- 15C Nishchal B.: Darktable, emulate film halation (January 30, 2024, darktable 4.6) Accessed November 6, 2026.
- 16C discuss.pixls.us: Guess the method, film halation (revealed), method post of February 18, 2026 Accessed November 6, 2026.
- 17M darktable 5.6 user manual: bloom Accessed November 6, 2026.
- 18B The Grain Archive: how the styles are built
M: manufacturer · C: review or community · B: Grain Archive measurement