# Overview

## What is it?

KGeoTag is a Free/Libre Open Source photo geotagging program. It's written in C++/Qt and uses the KDE Frameworks. It's published under the terms of the GNU General Public License (GPL).

## What is "Geotagging"?

Photos (⪚ JPEG images) contain metadata like the creation date, camera information &etc; Those are either stored in the so-called Exif header, in an XMP sidecar file or in both. This data can also represent geographic coordinates so that it's replicable where the images were taken.

Most cameras don't have GPS receivers, so, most can't save coordinates when taking images. A common approach is to ⪚ carry a small GPS logging device along (or nowadays also using a smartphone ;-)), which records a track all the time. Later on, the images' dates can be compared to the GPS log's points' dates to figure out where an image was taken.

If one knows for sure where the respective photo was taken, it's also possible to assign coordinates to the images manually.

## Geotagging with KGeoTag

### Supported file formats

KGeoTag currently supports The following image formats: JPEG, PNG, WebP, TIFF, OpenRaster and Krita Document, as well as some TIFF-based RAW image formats: Canon Raw v2 (.cr2), Nikon Electronic Format (.nef) and Adobe Digital Negative (.dng).

Geodata can be loaded from (uncompressed) GPX files.

### Assigning images

KGeoTag offers multiple ways to assign coordinates to images:

#### Automatic tagging

The most convenient approach is automatic matching using geodata provided by GPX files. Those can be loaded and displayed on a map. Using this data, images can be assigned with matching geographic coordinates by finding (more or less) exact chronological matches, or by interpolating a likely position if no exact match can be found.

Normally, the images only provide a time and date, but no timezone. Thus we need to set one to make an assignment possible. The presumably correct timezone is detected from the geographic location of the GPX file, but it can also be set manually.

If altitude values aren't set in the dataset or they are not accurate enough, they can be looked up using opentopodata.org (see below).

The clocks of cameras mostly aren't radio-controlled and often have a slight offset. If the images' dates have a time drift due to the camera's clock being not exactly in sync with the GPS data (which is assumed to be correct), a deviation can be defined. It then will be considered when searching for matches, and can also be used to fix the images' dates.

#### Drag and drop interface

Another option is tagging images via drag and drop. One or more images can be selected and dropped onto the map, to their respective location (possibly also guided by some GPX track). Elevations can't be ascertained this way, so either, they are left to be "0 m" (sea level), entered manually or looked up via opentopodata.org (either automatically or manually, see below).

#### Assigning images to bookmarks

For places frequently assigned to images (like one's home, where one doesn't carry a GPS logger), bookmarks can be defined. Images can then be assigned to the respective coordinates easily.

#### Manual assignment

It's also possible to enter coordinates for one or more images by hand. The altitudes can be either looked up automatically using opentopodata.org (see below), or also be entered manually.

### Setting or looking up elevation information

Altitudes can always be set manually. Alternatively, the altitudes can also be looked up querying different elevation datasets using opentopodata.org's API.

The preset is to use the ASTER dataset. This one covers the whole globe. Others can be used as well, cf. opentopodata.org's homepage.

By default, such a server lookup has to be triggered manually. It's also possible to enable automated altitude lookups for all images dropped on the map (which yields geographic coordinates but no elevation) and coordinates entered manually.

### Making the data persistent

Finally, the assigned coordinates can be saved. KGeoTag can either write them to the images' Exif header (which will obviously alter the respective files), to XMP sidecar files (leaving the original files untouched) or to both. By default, a backup of each original file is created if it will be changed during the write process.

This way, the geodata assignment is made persistent and also accessible for other geodata-aware applications (like ⪚ KPhotoAlbum).

If a time drift has been identified and a deviation has been given, the images' dates and times also can be fixed whilst saving.