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.
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.
- 🌍 View and update photo geolocation on an interactive map
- 🤖 Automate geolocation updates using Google Takeout data
- 💾 Save updated metadata easily
There are two ways to run the app.
-
By downloading the executable and running it directly on your system. Important: Windows could say the app is unverified.
-
By downloading this repository and running it from the source code.
-
Download the executable file from the Releases tab.
-
Extract to your desired folder Important: you need to extract all the content (both EXE and folder).
-
Run the "Photo Location Updater.exe" file
- Python 3.6+
-
Clone the repository:
git clone https://github.com/Rick45/photo-location-updater.git
-
Create a virtual environment:
python -m venv venv source venv/bin/activate # On macOS/Linux venv\Scripts\activate # On Windows
-
Install dependencies:
pip install -r requirements.txt
-
Run the app:
python main.py
-
Use the GUI to select a folder containing photos.
-
Select a photo from the list to view it and its current geolocation.
-
Click on the map to update the geolocation of the selected photo.
-
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.
Google changed the Location History data to be available only on the mobile device, this now needs to be done on the google maps app:
- Google Maps home screen
- Profile picture (top right)
- Settings
- Google location settings
- Location Services
- Timeline
- Export Timeline data
This will give you a big Json file, when firt loading it the app will ask you to split it by month. This is advised as using the full file have all you location history and the apps takes some time to run it to find the closest location. The app will keep te original file untouched but will generate a new folder with a file structure of an folder with the year and one file by each month.
After successfully selecting and loading a takeout file the map will now show a new icon with a question mark (?) with the locationt closest to the date where the photo was taken.
This project would not have been possible without the OpenStreetMap: