IMGtoKMZ

IMGtoKMZ is a command-line tool that processes a batch of geotagged photographs and generates a KMZ file for use in mapping applications like Google Earth. It automatically extracts GPS coordinates and timestamps from image metadata, organizes files, and creates a detailed CSV report for quality assurance. This tool is particularly useful for fieldwork, archaeology, surveying, and any scenario where visual location data needs to be mapped and reviewed.

Key Features

• Batch Geotagged Image Conversion — Scans directories recursively for JPEG, PNG, and HEIC files, extracts GPS EXIF data, and outputs a single KMZ with one placemark per photo.
• HEIC to JPEG Conversion — Automatically converts HEIC images to JPEG using macOS sips (or alternatives on other platforms) while preserving original EXIF metadata.
• Automatic File Organization — Copies images into categorized folders (files_geo/, files_nongeo/, files_nonimg/) based on whether they contain GPS data.
• CSV Report Generation — Produces a detailed CSV report with sequence numbers, filenames, datetime, coordinates, and status for easy quality control.
• Chronological Sorting — Orders photos from oldest to newest based on DateTimeOriginal or file modification time for logical mapping.

Philosophy

The tool is designed to be simple, reliable, and focused on a single task: turning a collection of geotagged photos into a usable, organized map layer without modifying original files.