Online Help
|
Home
|
 © 2022 KLS |
GeoTagger HelpGeoTagger allows you to display and modifiy the GPS location information that is stored in image files. For a quick introduction see the "GeoTagger User Guide" (available from theStarting the programIf started without command line parameters, the program will come up with an empty file list, and you can useYou can also start GeoTagger from the command line, in which case you can specify the names of files and/or directories to open. If a directory is given, all files in that directory with extensions *.jpg or *.jpeg (case insensitive) will be loaded. Subdirectories of the given directories are followed recursively. See geotagger --help for a list of command line options. Loading filesThe
The A preview of the current image is displayed below the list of images, and the status bar shows the full path name of the current image.
You can use The rightmost column in the list shows a '*' for images that have been modified since the last time they have been loaded or saved. Navigating the mapClick&drag to move the map, and use the mouse wheel to zoom in and out.
Zoom in on the location of the current image with
Zoom out to see all image locations and tracks with
Zoom out to see the entire world map with The map displays markers at the locations stored in the images. The location of the current image is shown with a red marker, while all others are blue. The red marker has a hole at its center, so that you can see if there are blue markers beneath it. Green markers are used for Points Of Interest ("POIs"), which can be read from GPS track files. Clicking on a blue marker makes the corresponding image current. The map also displays a red line that leads from the very first image location to the last one. This "path" indicates the sequence in which the photos were taken. Map providers and typesYou can select your preferred map provider under
Some map providers may require the use of api keys or other parameters.
These can be defined as name=value pairs in
If a map provides different types (like "Street" or "Satellite"), you can
switch between these through Modifying timesTo modify the time data of an image, you can double click on a Time field, pressIn the dialog that appears, you can change the date and time when the image was taken, and the offset from UTC ("Universal Time Coordinated", also known as "Greenwich Mean Time" or GMT) at that location. The date and time are usually "local time", as shown on a calendar or wall clock. The offset from UTC indicates the time zone of the location, including a possible offset due to DST (Daylight Saving Time). If, for instance, a photo was taken in Denver, Colorado, the offset from UTC would be -0700 in winter, and -0600 in summer. Of course you can also have all times in UTC, in which case the offset would be +0000. Making sure the times are correct is important for getting locations from GPS track logs. If more than one image are selected, the dialog is filled with the data from the current image. Changing the date or time results in the delta between the old and new value to be applied to all selected images. A change to the offset from UTC is directly applied to all selected images. Modifying locationsTo modify the location data of an image, simply click at a point on the map. This will set the Latitude and Longitude of the selected image(s) to the given values, and adjust the markers accordingly. The Altitude is not changed, because the map doesn't provide that information.
You can also double click on a Latitude, Longitude or Altitude
field, press
Note that the values for latitude and longitude must be given in the format selected
under
If you want to make sure you don't inadvertently change an image's location
by clicking on the map, you can check
Clicking on a marker makes the corresponding image the current image. If you want to select a location that is inside the area of a marker, hold down the Shift key when clicking the left mouse button. Selecting images on the map by clicking and dragging a rectangle over their markers always requires Shift to be pressed, because a simple click&drag moves the map around. The list items with markers inside such a rectangle will be selected (any previous selection is cleared). The selection rectangle is limited to the currently visible map area (zoom out if you need more). Interpolating locationsIf you have images that lack GPS coordinates, you can interpolate these from surrounding images that have coordinates. To do so, select a sequence of images where the first and last one have valid coordinates, and all images in between have no coordinates. Then execute the commandGPS track logsGeoTagger can handle GPS track logs in GPX and CSV format. CSV formats are configured in the file csv.conf and can be either detected automatically (provided there is a suitable entry in the configuration file) or selected manually in
Several track logs can be loaded simultaneously, and will be displayed on the map
with the color and width defined in Moving the mouse along a GPS track displays the date and time (in UTC) that point was recorded.
The command If the location for the exact time an image was taken can't be found in the track log, the value between the two positions recorded closest to the given time is interpolated. Locations for images with times before the first or after the last entry in a track will not be changed. If a GPS track log contains Points Of Interest (POIs), these will be displayed with green markers on the map.
The command AltitudeThe map doesn't provide the altitude of the selected coordinates, and sometimes even the GPS data from cameras, smart phones or GPS trackers doesn't contain proper altitude values. There are sources on the Web that provide the altitude (some call it elevation) for any given coordinate. The commandCurrently GeoTagger has builtin support for ELEVATION API. Aligning timesSo you have correctly set the time zones (i.e. offsets from UTC) of all your photos, but your favorite image viewer still doesn't show them in the proper order. That's because the timestamp that is stored in the EXIF data is considered to be "local time", and even though some cameras do set the correct time zone, image viewers widely ignore it. For instance, imagine you take a summer trip from Munich (UTC+0200) to Denver (UTC-0600). Your smart phone is set to the local time and time zone at the departure Airport, and, lacking contact to a mobile phone network during the flight, stays that way until you reach your destination. So all the photos you take during the flight will be in local time of Munich. Once arrived at Denver, your phone connects to the local network and sets itself to the new local time and time zone. Since there is an eight hour difference between local times in Munich and Denver, any photos you take for the next eight hours will be intertwined with the ones you took up to eight hours before. GeoTagger presents the images in the proper order, because it takes the time zones into account. To have any image viewer also do so, you can use the
To do so, sort the image list by ascending time, and select all images from the last
one that shall keep the departure time zone up to the first one that shall keep the
destination time zone (you need to select at least three images). The Aligning times this way works for any westward journeys, even crossing the dateline. It also works eastwards, however crossing the dateline poses a problem there, because in that case the generated image times would have to run "backwards".
The UTC times of the images will be roughly the same as before the alignment (if the offset
from UTC is taken into account). They may be up to plus/minus one minute off from the
original time, because the offset from UTC is given in full minutes. Also, times that were
close together but different before, may become the same after the alignment.
In case you use the Rotating imagesThe commandWARNING: Unlike the commands that modify times or coordinates, this command actually modifies the image data itself when you save your work in "store" mode! Straightening imagesWhile adjusting times and coordinates of your photos, you may come across images that are a bit slanted. A typical example for this are photos hat show the horizon. Geotagger offers a quick and easy way of straightening such images by means of the
Straightening an image rotates the image by the given angle, which results in a larger image
with white triangles at its corners. GeoTagger automatically crops the result to the maximum
possible rectangular area within the original image, so that none of the white areas is
visible. You can use the WARNING: Unlike the commands that modify times or coordinates, this command actually modifies the image data itself when you save your work in "store" mode! Cropping imagesTheWARNING: Unlike the commands that modify times or coordinates, this command actually modifies the image data itself when you save your work in "store" mode! Excluding imagesThe
If you have excluded some images, you can use the Hiding imagesImagine you have loaded many images from various events in different locations, and you want to view or edit only a particular set of them, for instance all images taken over the years at a certain place. TheYou can tell if there are hidden images by looking at the "Images:" entry at the right end of the status bar. If it shows two numbers, separated by a '/', the first one is the number of shown images, and the second one is the total number of loaded images. When you save your work, it will always save all image data, no matter if there are hidden images or not. When you export images and there are hidden ones, you will be asked whether or not you want to export the hidden ones, too. Undo/redo always treats all images as visible. Maximizing the image previewThe commandThumbnailsThe image preview can be switched to thumbnail view with theThumbnails for excluded images are shown in reduced black&white mode, with a red triangle in the upper left corner. If an image file doesn't contain a thumbnail in its EXIF data, one will be generated automatically. Also, every time an operation modifies the image (like rotating, straightening or cropping), the thumbnail will be regenerated.
Sometimes the thumbnails generated by the camera may not be optimal. For instance, photos taken in
16:9 mode may have black bars on top and bottom, or the resolution of the thumbnail image is very
poor. In such cases,
When a file with a generated thumbnail is written, GeoTagger adds a "user comment" to the EXIF data
that indicates that this is a thumbnail that has been generated by GeoTagger. That way, next time
the file is loaded with GeoTagger and BackupBefore saving modifications to an image file, GeoTagger creates a backup copy of that file. By default, a directory named BAK is created in the same directory as the image file. The image file is then copied into that directory. So for instance the file/Home/MyPhotos/img_1234.jpg would be copied to /Home/MyPhotos/BAK/img_1234.jpg If a file with that name already exists there, a numerical suffix is added to the file name, as in /Home/MyPhotos/BAK/img_1234-1.jpg
The name of the backup directory can be defined in If you delete the backup directory name, no backup will be done. WARNING: ONLY DISABLE AUTOMATIC BACKUP IF YOU ARE SURE THAT YOU ARE WORKING WITH COPIES OF YOUR IMAGE FILES AND HAVE A BACKUP OF YOUR OWN! If you select an absolute path name for your backup directory, you can choose whether to store the backup under the full path name of the image, as in /Path/To/Backup/Home/MyPhotos/img_1234.jpg or just the file name: /Path/To/Backup/img_1234.jpg You can also choose whether to back up only the original image file, or every time a modified file is saved. Cut/Copy/PasteThe cut, copy and paste operations apply only to locations.Undo/RedoYou can undo/redo any changes you made withSaving modifcationsYou can use
There are two different ways in which GeoTagger saves modified times and locations. By default
it writes the data back into the image files, making a backup copy of the original files according
to the settings in
The second method leaves the image files untouched and writes the modified data into a text
file (.geotagger by default) within the directory of the image files. When files from such
a directory are loaded in a later session of GeoTagger, the .geotagger file (if present)
is read and the times and locations of the images are set to those given in that file.
Besides leaving the original files completely untouched, this method has the advantage of
saving data much faster than creating backup copies and overwriting the original image files.
Go to
Once you have finished editing the times and locations of your images with the second method,
you can set Exporting image filesImage viewers normally have options to display images sorted by their file name or by time. If present, some take the time from the EXIF data stored in the image file, others may just use the file timestamp. If you have image files (maybe from various sources, like different cameras or from people joining you on your trip) that you want to be sure are presented in the exact sequence they were taken, the
See "Excluding images" if you want to exclude some images from exporting. Batch modeThe Export command can also be executed in batch mode by using the --export option. This can be useful if you have interactively processed images in several directories and then realize that, for instance, you hadgeotagger --export=target source... which takes all the files/directories given as source and exports them into the target directory. If, while doing so, any user input would be required, a message will be printed to the console and the command is terminated. You can use the --quiet option to suppress any info and warning messages and progress displays.
Batch mode uses all the relevant settings given in the PreferencesTheMap
Zoom radius: when zooming in on the location of the current image with Width of path: the width (in pixel) with which the path between image locations is displayed. Width of tracks: the width (in pixel) with which GPS tracks are displayed. Color of path: the color with which the path between image locations is displayed. Color of tracks: the color with which GPS tracks are displayed. Color of track times: the color with which GPS tracktimes are displayed. Color of selection: the color with which the selection rectangle is displayed. Map provider parameters: parameters like "app ids" or "tokens" required by some map providers. One parameter per line, given as name=value pairs. The name consists of the provider's plugin name followed by a dot ('.') and the actual parameter name. AltitudeProvider: the provider to retrieve altitude data from. Overwrite existing values: if checked, existing altitude values will be overwritten with values from the provider. Altitude provider parameters: parameters like "keys" or "resolutions" required by some altitude providers. One parameter per line, given as name=value pairs. The name consists of the provider's name followed by a dot ('.') and the actual parameter name. FormatUnits: the units used to display measurements ("metric" or "imperial"). Precision of altitude: like longitude and latitude, altitudes are often stored with several decimal digits in the GPS data of photos. However, these values usually are not that precise, and displaying them with many decimals is just irritating. Use this parameter to set the number of decimal digits to display for altitudes. Show file names: by default the list of images displays only the base name of the image's file. If you have loaded files from different directories it may be useful to switch to "full path". Note that the status bar always displays the full path name of the current image file. Coordinates: the format in which to display coordinates. Time: the format in which to display dates and times. BackupMode: the mode in which modified times and locations are saved ("store modifications in original images" or "cache modifications in separate files"). See "Saving modifications" for details. You can tell which mode is currently active by looking at the "Modified:" entry at the right end of the status bar. In "store" mode it shows the number of modifications that will be written with the next save command. In "cache" mode this number is followed by the total number of modifications that are stored in the .geotagger files. Directory: the directory in which to write backups. Name: how to name backups ("full path name" or just "file name"). Frequency: how often to do backups (every time a file is saved, or only when the original file is saved). File: the name of the file in which modified times and locations are stored in "cache modifications in separate files" mode (default is .geotagger). MiscMax. preloads: when moving the cursor in the image list, the given number of images are loaded in addition to the current image. This makes browsing the image list faster. Max. image memory: the maximum amount of memory to use for caching images. Note that no matter how small you set this value, there may always be the present, previous and following image loaded, which may well exceed the given value. Also, the memory taken into account is that of the actual image in memory, which is typically more than that of the file on disk. CSV file format: the file format to use when reading GPS track logs in CSV format. Load track files: automatically load GPS track files when opening a directory. Use custom list style: GeoTagger uses a custom style for displaying the image list. Uncheck this option to use the standard system style. Require Shift to set location: if checked, a click on the map requires the Shift key to be pressed in order to set the location of the selected image(s). Export resets orientation: by default, GeoTagger leaves image data untouched if possible when writing files. When you export your images, you may want to reset the orientation parameter in the EXIF data, even if this wouldn't be necessary because you didn't rotate, straighten or crop the image. You can check this option to make this happen. Export sets file time: if checked, exported images will have their file time set to the time stored in the EXIF data. Note that this may prevent files from being synchronized with commands like 'rsync', therefore this option is off by default. Always generate thumbnails: if checked, thumbnails will always be (re-)generated. Exclude directories: the names of directories you don't want to be scanned when recursively opening directories. You can enter more than one name, separated by colons (':'). If the name of the backup directory is local, it will be automatically excluded. Max. directory scan level: when opening a directory, by default all subdirectories within it will be scanned recursively for image and GPS track files. Use this parameter if you only want to scan up to a certain level.
Export xref file name: the name of the file in which the Bug reportsPlease send bug reports to <geotagger@tvdr.de>. |
| GeoTagger icon made by Nikita Golubev from www.flaticon.com |