2.3.9. Geotagging

Use this panel to import and apply GPX track data on a selection of images. Alternatively, you can manually geotag images within the Map view (see Chapter 5, Map).

2.3.9.1. Usage

A GPS receiver calculates its current position based on the information it receives from satellites and records them in a GPX file – together with the current date and time. The Exif data of the images also contains a time stamp defined by the camera settings. darktable takes the time stamp of the image, looks-up the position in the GPX file at that time, and stores the coordinates (latitude/longitude/elevation) in its database and the image's XMP sidecar file.

There may occur two problems. In contrast to GPS devices, most cameras don't record the accurate time. Secondly, the time stored in the Exif data doesn't contain a time zone. Most people set their camera to local time, while the GPS devices store the time in UTC (Universal Time, Coordinated), i.e. Greenwich (London) time zone. If the time zones of camera and GPX file differs, than the related location will be wrong.

If your image already carries the UTC time stamp you can directly apply the GPX track without further adjustments.

Otherwise we take two steps to correlate the time of camera and GPS tracker, first the offset, then the time zone.

To fix the drift of the camera time setting you can either enter it manually into the offset input field or let darktable calculate it. All you need is a picture taken of a reliable time source.

This can be any precise clock or even better the time displayed on your GPS device (normally it shows the local time, although it stores universal time).

When you have this image selected you can click on the (looking glass) button and darktable will present you an entry box. Just enter the time that is shown on the image. As a result you will get the difference between the time you entered and the one associated with the image in its Exif data.

Now you can select all the images you want to geotag and click the apply button (currently represented by a check mark). This will alter the time in darktable's internal database for these pictures – so you will also see the change in the image information module on the left.

Now you can apply a GPX track. Click the corresponding button and navigate to the GPX file. Before confirming that dialog you should select the corresponding time zone for your camera in the drop-down-menu.

Should you ever make a mistake with the time zone selection you can just come back and reapply the GPX file with a different time zone.