GitHub - Shenming-Ji/GeoExif: Visualize your photo journeys from local EXIF metadata on an interactive 3D globe. · GitHub
Skip to content

Shenming-Ji/GeoExif

Repository files navigation

GeoExif

GeoExif is a local-based React + TypeScript web app that reads photo EXIF metadata and turns it into a 3D travel route on a globe.

What Is EXIF?

EXIF (Exchangeable image file format) is a metadata standard used in image files. It can store information such as capture time, camera or device details, and sometimes GPS coordinates.1

For everyday use, photos taken directly on Apple devices such as iPhones often include enough EXIF metadata for this app to extract time and location information. However, if photos are downloaded from social media or messaging platforms, some metadata may be stripped during upload or recompression, so GPS coordinates and other fields may be missing.

Features

  • Select a local photo folder without uploading images
  • Parse JPG / JPEG / HEIC EXIF metadata directly in the browser
  • Extract capture time, GPS coordinates, and device information
  • Group nearby photos into location nodes using a distance threshold
  • Render location anchors and chronological travel arcs on a 3D globe
  • Generate place labels from a built-in city dataset
  • Export the processed result as JSON

Tech Stack

  • React
  • TypeScript
  • Vite
  • exifr
  • globe.gl
  • three

Run Locally

npm install
npm run dev

Build

npm run build

Live Demo

Open GeoExif

Privacy

By default, photo parsing, location grouping, label generation, and JSON export all happen locally in the browser, with no backend service required.

Footnotes

  1. Wikipedia, "Exif"

About

Visualize your photo journeys from local EXIF metadata on an interactive 3D globe.

Topics

Resources

Stars

Watchers

Forks

Contributors