Skip to content

Rick45/photo-location-updater

Repository files navigation

Python Version License

Photo Location Updater (EXIF GPS Data Editor)

A simple tool to seamlessly update the geolocation metadata of your photos using an intuitive map-based interface. Whether you need to correct or add location data, this app makes it easy.

Warning

Important: This tool results in data modification. It is highly recommended that a data backup be performed before executing the script. The script's author is not responsible for any data loss or damage that may occur during the execution of this script.

Features

  • 📂 Select a folder containing photos
  • 🌍 View and update photo geolocation on an interactive map
  • 🤖 Automate geolocation updates using Google Takeout data
  • 💾 Save updated metadata easily

app

App Execution

There are two ways to run the app.

  1. By downloading the executable and running it directly on your system. Important: Windows could say the app is unverified.

  2. By downloading this repository and running it from the source code.

Execution with .exe

  1. Download the executable file from the Releases tab.

  2. Extract to your desired folder Important: you need to extract all the content (both EXE and folder).

  3. Run the "Photo Location Updater.exe" file

Execution by source code

Requirements

  • Python 3.6+

Installation (via source)

  1. Clone the repository:

    git clone https://github.com/Rick45/photo-location-updater.git
  2. Create a virtual environment:

    python -m venv venv
    source venv/bin/activate  # On macOS/Linux
    venv\Scripts\activate     # On Windows
  3. Install dependencies:

    pip install -r requirements.txt
  4. Run the app:

    python main.py

App Usage

  1. Use the GUI to select a folder containing photos.

  2. Select a photo from the list to view it and its current geolocation.

  3. Click on the map to update the geolocation of the selected photo.

  4. Save the updated geolocation metadata to the photo.

Optionally you can load the google takeout files using the Enable Google Takeout button. When a file from the list is selected, the app will use it to find the location with the date closest to the photo taken date. Google shares the location history by month, so you will need to know the month when the photo was taken.

How to Request Location Data from Google Takeout

  1. Go to Google Takeout: Visit Google Takeout and sign in with your Google account.

  2. Select Data to Include:

  3. Click on "Deselect all" to clear all selections.

  4. Scroll down and find "Location History".

  5. Check the box next to "Location History".

  6. Choose File Type, Frequency & Destination:

  7. Click on "Next step".

  8. Choose the delivery method, export frequency, file type and size.

  9. Click on "Create export".

Google will prepare your data, which may take some time depending on the amount of data. Once the export is ready, you will receive an email with a download link. Download the .zip file and extract it to a folder on your computer. This folder can be selected and all the files will be listed in the application to be used.

Acknowledgements

This project would not have been possible without the OpenStreetMap:

Keywords

Exif GPS Editor
Geotagging Tool
Photo Metadata Editor
Update Photo Coordinates
EXIF Metadata

Thanks

"Buy Me A Coffee"

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

No packages published