2.2.9. Local copies

Many users have huge image collections which they store on extra hard drives in their desktop computer, or on an external storage medium like a RAID NAS, etc. So it is a common use case to develop some images while travelling using a notebook and then later synchronize them to the original storage medium. But copying images manually from the main storage to the notebook and back is cumbersome and prone to errors.

The local copies feature of darktable has been designed to directly support those use cases. You can create local copies of selected pictures on your computer's local drive. This local copy is always used when present, giving access to the picture if the external storage is no longer connected, and having the advantage of being faster than a slow external drive. At a later point, when connected again with your main storage medium, you can synchronize the XMP sidecar files, deleting the local copy of your input image. These operations can be found in the selected images panel (see Section 2.3.6, “Selected image(s)”).

For safety reasons, if local copies exist and the external storage is available, the local XMP sidecars are automatically synchronized at start up.

The local copies are stored into the $HOME/.cache/darktable directory and named img-<SIGNATURE>.<EXT>, where:

SIGNATURE is a hash signature (MD5) of the full pathname
EXT is the original filename extension

A local copy is identified in the lighttable view with a white marker on the right of the thumbnail. In addition all local copies carry the darktable|local-copy tag for selecting them easily.