darktable page lede image
darktable page lede image

Importing sidecar files generated by other applications

2.2.8. Importing sidecar files generated by other applications

When importing an image, darktable automatically checks if this is accompanied by a sidecar file. Other than the formats <basename>.<extension>.xmp and <basename>_nn.<extension>.xmp darktable also checks for the presence of a file in the form <basename>.xmp. darktable's own sidecar files are always stored in the first format – the latter one would only be read – not overwritten.

At present, darktable is able to deal with the following metadata of Lightroom generated sidecar files during the import phase:

  • tags and hierarchical tags

  • color labels

  • ratings

  • GPS information

In addition, darktable has been designed to help migrate some image operations from specific other applications. The aim is not to make darktable a drop-in replacement for any other software; it's just meant to help you recover part of the work you have invested into your image in case you migrate to darktable. It is very important to understand that this import process will never give identical results. The underlying development engines are very different from application to application, and additionally depend a lot on the specific image. In some cases, it will probably be close, and in some cases, the development will need manual adjustment in darktable.

The migration happens automatically when entering the darkroom view, provided that a corresponding XMP sidecar is found.

At present, darktable is able to deal with the following development steps from Lightroom-generated XMP files (with the corresponding darktable module in parentheses):

  • crop and rotate (crop and rotate)

  • black level (exposure)

  • exposure (exposure)

  • vignette (vignette)

  • clarity (local contrast)

  • tone curve (tone curve)

  • HSL (color zones)

  • split-toning (split-toning)

  • grain (grain)

  • spot removal (spot removal)