A tool that uses exifdata to organise geolocated image files (e.g. drones images) into a geopackage file with associated metadata. Additional features, such as can also create a webpage with a leaflet map.
Project description
Image Location Scan
Image Location Scan is a powerful tool designed to extract Exif metadata from images, monitor a specified directory for changes, and maintain a synchronized geopackage file. This script is ideal for users who need to keep track of photo metadata and visualize it on a map, especially in dynamic environments where files are frequently added, removed, or modified. Requires exiftool to be installed and callable by subprocess. Optionally scans and matches Metashape psx and psz files.
Features
- Directory Monitoring: Utilizes
watchdog
to monitor a specified directory for changes and keeps a GeoPackage map updated in real-time. - Exif Metadata Extraction: Extracts Exif metadata from images using
ExifTool
, including GPS coordinates, camera make and model, and more. - GeoPackage Synchronization: Maintains a GeoPackage file that is updated with the latest metadata from the monitored directory.
- HTML Map Generation: Generates an HTML map and table to visualize the metadata, with options to include additional map layers.
- Configurable Logging: Supports dual logging to both console and file, with customizable log levels.
- Persistent Observer: Optionally persists the observer state to resume monitoring after interruptions.
- Integration with Kart: Supports integration with Kart for version control and remote repository synchronization.
- Additonal Metadata: Manually add metadata by saving
metadata.xlsx
files in the directory structure.
Installation
To install the package, use the following command:
pip install image-location-scan
Usage
The script can be run from the command line with various options to customize its behavior. Below is an example of how to use it:
py -m exifScan '\\file\Shared\SEESPhotoDatabase' --config .\config.json --watchDirectory
Command Line Arguments
path
: The path to scan for Exif data (required).--WorkDirectory
: The working directory (defaults to current working directory).--MetashapeDirectory
: Directory to search for Metashape project files.--KartRemote
: Kart remote repository URL for pushing updates.--KartDirectory
: Directory for the Kart repository.--GeopackageDirectory
: Directory to save the GeoPackage file (defaults to WorkDirectory).--LogDirectory
: Directory to save log files (defaults to current directory).--OutputGeopackage
: Name of the output GeoPackage file (defaults toPhotos.gpkg
).--htmlFolder
: Directory to save the HTML map and table.--mapFileName
: Name of the HTML map file (defaults tomap.html
).--otherMapLayers
: List of paths to additional map layers.--otherMapLayerNames
: List of names for additional map layers.--ExifOutputFile
: Name of the Exif output file (defaults tooutdb
).--readExifFromOutputFile
: Read Exif data from the output file instead of scanning.--recursive
: Scan directories recursively.--ignoreDirs
: List of directories to ignore during scanning.--ignoreMetashape
: Ignore directories containing.files
andauto-project
.--persistObserver
: Persist the observer state to resume monitoring after interruptions.--dualLogging
: Enable logging to both console and file.--groupByTags
: List of tags to group by. Always groups by folder, but can also split into the groups specified by this flag (defaults to["Make", "Model"]
).--xyTagNames
: List of tag names for x and y coordinates (defaults to['GPSLongitude', 'GPSLatitude']
).--zTagName
: Tag name for z coordinate (defaults toGPSAltitude
).--imageFileExtensions
: List of image file extensions to scan (defaults to['JPG']
).--metashapeCacheTime
: Time to keep Metashape data cached (in minutes, defaults to 120).--pollingInterval
: Time (in seconds) between polling intervals.--config
: Path to a JSON config file.--watchDirectory
: Watch directory for changes after initial scan.--logLevel
: Set the logging level (choices:DEBUG
,INFO
,WARNING
,ERROR
,CRITICAL
). Only if dualLogging is disabled.
Dependencies
argparse
sys
json
logging
os
time
datetime
copy
threading
subprocess
folium
pandas
geopandas
ExifTool
watchdog
Acknowledgments
Thanks to Phil Harvey and his excellent exiftool software.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for image_location_scan-0.2.3.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | dd91ffc4956d898eb85d2af9a5d8a4c34e51838c34b182b28d4033cd90d4fd7f |
|
MD5 | 20a261776b9387445fd5ac9baa77fb9b |
|
BLAKE2b-256 | 99112be96a9e1c7b749184bdc73804ee72c984fe7aaa0faa896274873c6ccfe7 |
Hashes for image_location_scan-0.2.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2c8a0dffce35bf224aa7cf1bcba53bb6f3746d335c401fe6e19499a127292c4c |
|
MD5 | 83ac0b4a6c337a9a05427fc1b41227ef |
|
BLAKE2b-256 | 2b12468119942a033c69710b3bd9f374a6d973fb3e1634df41c94fb5c626399d |