gpx-to-geotags/README.md

25 lines
776 B
Markdown
Raw Permalink Normal View History

2024-03-15 18:39:12 -06:00
# gpx-to-geotags
2024-03-15 16:12:30 -06:00
_Geotag your photos from a GPX track._
2024-03-15 14:30:40 -06:00
2024-03-15 16:12:30 -06:00
This is a simple script used to add geotags (geographic metadata locating where the photo was taken) to images taken by
2024-03-15 18:41:50 -06:00
a non-GPS camera by correlating the time a photo was taken to a point on a GPX track.
2024-03-15 16:12:30 -06:00
## Install
1. `pip install -r requirements.txt`
## Use
```
python3 main.py <path to the folder containing your photos> <path to GPX file>
```
You might need the `--timezone` argument. Double check the EXIF times are correct via `identify -verbose`.
<br>
Optional Arguments:
- `--max-diff`: Maximum allowed difference in seconds between image timestamp and track point. Default: 300 (5 minutes).
2024-03-15 18:39:12 -06:00
- `--timezone`: Three letter timezone the photos are in (e.g. EST). Default: auto-detect your local timezone.