// troubleshooting guide · darktable

darktable Black Image on Export or in Darkroom

Status
Workaround available
platforms:
Windows, macOS, Linux
updated:
November 17, 2026
reports:
3
Method
how we research
Share

RUNBOOK · darktable/black-image-export4 FIXES

// quick answer

A black image in darktable is most often an OpenCL bug. Disable OpenCL or the offending module (haze removal, filmic or sigmoid on some GPUs), update drivers and retry the export.

Most likely fix: Test with OpenCL off

How to fix it

// try these in order, the most common fix is first

  1. FIX 1Test with OpenCL off

    1. 01Start darktable --disable-opencl
    2. 02Open the image and export again
    Did this fix it?
  2. FIX 2Disable the suspect module

    1. 01In darkroom, switch off recently used modules such as haze removal one by one
    2. 02Check the filmic and color balance modules
    Did this fix it?
  3. FIX 3Update darktable and driver

    1. 01Install 5.6.2 which fixes some OpenCL clipping issues
    2. 02Update GPU driver
    Did this fix it?
  4. FIX 4Reset the image history

    1. 01In lighttable use history stack > discard history on a test copy
    Did this fix it?

SANDBOX · darktable RUNS IN YOUR BROWSER

Try it: edit a layered image, paint, generate and export it

A hands-on darktable-style sandbox, including the spots where users get stuck. See where problems like this one start. 1-2 minutes, nothing is saved.

Symptoms

The darkroom center image or exported JPEG/TIFF is completely black or half corrupted.

Why it happens

  • C-01OpenCL driver bug
  • C-02Specific module with GPU
  • C-03Outdated darktable on new GPU
  • C-04Clipping/highlight settings

// this guide also covers

  • darktable black image
  • darktable export black
  • darkroom black image darktable

Still not working?

If darktable keeps failing, you're not alone. See every darktable problem users report or the alternatives people switch to.

Have an app idea? Our small team builds any software: web and mobile apps, games, desktop, AI tools. Price agreed together.

Talk to us

Watch darktable Get an email when its price changes, it has an outage, or we publish a new fix. No spam.

Fixed it? Share this guide

The same problem in other apps

All export, render & quality loss guides →

Other darktable errors

All 12 darktable errors and fixes →