Skip to content

Bash script that uses exiftool to generate reports from media geolocation data inside a chosen directory.

Notifications You must be signed in to change notification settings

designengineered/geo_data-extractor

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 

Repository files navigation

πŸ“Έ Geo-Data Extractor

Media Metadata Extraction Tool

Extract metadata from your photos and videos with ease! 🎯

This repository contains a bash script for extracting metadata from media files:

  • πŸ–ΌοΈ Images: JPG, JPEG, PNG
  • πŸŽ₯ Videos: MOV, MP4

✨ Features

  • πŸ“… Extracts creation date/time
  • 🌍 Extracts GPS coordinates (when available)
  • πŸ“Š Generates detailed reports in a reports directory
  • ⚑ Shows processing time and statistics
  • 🎯 Identifies files with valid GPS data
  • πŸ“ Handles both images and videos in a single pass

πŸ› οΈ Dependencies

The script requires exiftool to be installed on your system.

πŸ“¦ Installing Dependencies

Ubuntu/Debian
sudo apt-get update
sudo apt-get install exiftool
MacOS (Homebrew)
brew install exiftool
Other Unix Systems

Visit the ExifTool website for installation instructions.

πŸš€ Usage

./extract_metadata.sh [input_directory]

If no input directory is specified, the current directory will be used.

πŸ“‹ Output

The script will:

  1. πŸ“ Create a reports directory if it doesn't exist
  2. πŸ“ Generate a report file with timestamp (e.g., media_metadata_20240101_120000.txt)
  3. 🌍 Include a summary of files with GPS data
  4. πŸ“Š List detailed metadata for each processed file
  5. πŸ“ˆ Show processing statistics

πŸ“‘ Report Format

Each report includes:

  • πŸ—ΊοΈ Files with GPS coordinates (summary)
  • πŸ“ Detailed metadata for each file
  • πŸ”’ Total number of files processed
  • 🌍 Number of files with GPS data
  • ⏱️ Processing time
  • πŸ•’ Timestamp of report generation

πŸ’‘ Notes

  • βœ… The script handles errors gracefully and will notify if ExifTool is not installed
  • 🌐 GPS coordinates of (0,0) are treated as invalid and marked as "Not available"
  • πŸ”„ All reports are timestamped to prevent overwriting

Happy metadata extracting! πŸŽ‰

⭐ Don't forget to star this repo if you found it useful! ⭐

About

Bash script that uses exiftool to generate reports from media geolocation data inside a chosen directory.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages