Skip to content

Latest commit

 

History

History
90 lines (75 loc) · 3.92 KB

README.md

File metadata and controls

90 lines (75 loc) · 3.92 KB

ExifMapper

GitHub stars GitHub forks GitHub watchers
License

Easy GPS Map Viewer (Exif Mapper)

Easy GPS Map Viewer is a simple, user-friendly desktop application built with Python and PyQt5 that lets you extract GPS coordinates from images and display them on an interactive map. Whether your photos are stored locally or hosted online, this tool makes it easy to visualize their locations. Developed by SirCryptic

Features

  • Load GPS Data: Extract coordinates from local images (e.g., .jpg, .png) or web URLs with EXIF GPS metadata.
  • Interactive Map: View locations on a map with customizable styles (OpenStreetMap, Stamen Terrain, CartoDB Positron).
  • Add Custom Locations: Manually input latitude and longitude for places without GPS data.
  • Edit & Manage: Rename or remove locations from your list.
  • Save & Load: Save your locations to a JSON file and load them later.
  • Beginner-Friendly: Clear tooltips, examples, and a help section guide new users.

Screenshots

Main Interface

interface

Map View

Interactive map displayed in the browser. distance heat i-main

Installation

Prerequisites

  • Python 3.8+
  • Windows: Just use the compiled .exe unless you want to run from source (note: other OS support possible with source).

Option 1: Run from Source

Clone the Repository:

git clone https://github.com/SirCryptic/exifmapper.git 
cd Easy-GPS-Map-Viewer
  1. Set Up a Virtual Environment:
python -m venv venv
venv\Scripts\activate  # Windows
  1. Install Dependencies:
pip install -r requirements.txt

3.Run the App:

python gpsviewer.py

Option 2: Use the Compiled Executable

  1. Download the Latest Release:
  • Go to Releases.
  • Download gpsviewer.exe.
  • Run the exe (no Python installation needed)

Usage

1.Load an Image:

  1. View the Map:
  • Select a map style from the dropdown.
  • Click "View Map" to open an interactive map in your browser.
  1. Manage Locations:
  • Double-click a location in the app istelf to rename it it will reflect on the map in the browser once reloaded.
  • Click "Add Custom Location" to enter coordinates manually.
  • Select a location and click "Remove Selected" to delete it.
  1. Save or Load:
  • Click "Save Locations" to save to a .json file.
  • Click "Load Saved Locations" to restore from a file.
  1. Need Help?:
  • Click "Help" for a quick guide.