Skip to content

Latest commit

 

History

History
51 lines (27 loc) · 2.41 KB

README.md

File metadata and controls

51 lines (27 loc) · 2.41 KB

photoGeoExtractor

The photoGeoExtractor package extracts geolocation metadata from JPEG photos and exports it to a .csv file, building on this code.

To use, start by uploading your photos to Google Photos, creating an album, and then downloading it via Google Takeout. This is a quick process with a handy tutorial. photoGeoExtractor takes as input either the resulting .zip file or an entire directory of images if unzipped.

Installation

Until this package is on PyPI, users can install it manually:

  1. Create a virtual environment (here called yourenvname)

     python -m venv yourenvname

  2. Activate your virtual environment

     source yourenvname/bin/activate # Mac

 .\yourenvname\Scripts\activate # Windows

  3. Navigate to where you'd like to download this repository, and then get it from GitHub

     git clone https://github.com/scarioscia/photoGeoExtractor.git

  4. Navigate into the newly created directory

     cd ./photoGeoExtractor/

  5. Install the program

     pip install .

Usage

The photoGeoExtractor program uses the extract-metadata command to take GPS information and other metadata from photos downloaded via Google Takeout and export it to a table. It takes as input either a directory or a compressed (.zip) file containing the photos. The user defines a filename and location for metadata output.

Replace /path/to/album with your input (directory or .zip file) and /path/to/outfile.csv with your desired output filename and location:

python3 -m photoGeoExtractor extract-metadata --input=/path/to/album --output=/path/to/outfile.csv

Flags

By default, the resulting .csv will contain filename, datetime, and GPS columns.

Users can use the optional --all flag to output all available columns.

Users can also specify which columns to output using the optional --custom flag followed by comma-separated column names (e.g., --custom offset_time,offset_time_original,offset_time_digitized,shutter_speed_value).

An example of commands using these flags is included in the tutorial directory.

Contact

If you have any suggestions or requests please post an issue or PR, or reach out to Sara Carioscia (scarioscia).