ExifSense translates raw image EXIF metadata, camera settings, and geolocation tags into clear, human-readable insights, processing your photos and metadata locally on your device with no image uploads required.
Requires Node.js 20 or newer.
- Clone this repository and install dependencies:
git clone https://github.com/dimsedra/ExifSense.git cd ExifSense npm install - Start the Vite dev server and open the local URL shown in your terminal:
npm run dev
- Drag & Drop your images to view detailed metadata, maps, and privacy sanitization locally.
If you only want terminal analysis without cloning the web application:
npm install -g exifsense-cli
# or run without installing globally:
npx --package=exifsense-cli exifsense --helpTo equip AI coding agents with ExifSense CLI analysis instructions:
npx skills add dimsedra/ExifSenseRaw EXIF data often consists of obscure technical parameters such as aperture, exposure bias, and focal length. ExifSense automatically analyzes these attributes and presents them in plain, accessible language, explaining lighting conditions, lens choices, and capture history without requiring deep technical knowledge.
Your photo files, camera details, hashes, narratives, and metadata removal are processed directly on your device without uploading images to an ExifSense server. When you are online and inspecting GPS-tagged photos, only coordinates are sent to third-party services (OpenStreetMap and Nominatim for map tiles and street addresses, and OSRM for road-route estimates), falling back cleanly to numeric coordinates and straight-line distances when offline.
Visualize photo capture locations on interactive maps. For collections taken across multiple locations, ExifSense reconstructs plausible road-following movement paths to help you trace travel journeys.
Remove sensitive GPS coordinates, device identifiers, and metadata tags prior to sharing photos online, protecting personal privacy while maintaining original asset quality.
Identify post-processing signatures from common image editing software, timestamp discrepancies, and file extension mismatches to evaluate asset integrity.
| Feature | Description |
|---|---|
| Single Image Analysis | Detailed breakdown of camera hardware, optical settings, date history, and exact location. |
| Batch Comparison | Inspect multiple files simultaneously with side-by-side technical correlation and combined map views. |
| Command-Line Interface | Terminal-native execution harness for headless single-image, batch, hash, and EXIF extraction workflows. |
| Forensic Hash Inspection | Instant SHA-256 and SHA-1 calculation across single files, batches, or directories for non-destructive verification. |
| Metadata Sanitization | Selective or full removal of EXIF metadata categories with instant cleaned file downloads. |
| Interactive Mapping | High-fidelity map rendering with reverse geocoding to display physical addresses. |
| Export Capability | Export comprehensive reports as PDF, Markdown, CSV, or structured JSON data manifests. |
| Multi-Language Support | Full localization in English and Bahasa Indonesia. |
ExifSense includes a standalone, terminal-native CLI executable (exifsense) that runs single-asset and batch forensic analyses directly from your shell with 1:1 output parity to the Web dashboard, completely bypassing the browser interface. When online, single and batch runs automatically enrich GPS coordinates with physical addresses via Nominatim reverse geocoding (sequentially paced for batches) and estimate driving distances via OSRM, falling back cleanly to numeric coordinates when offline.
Install the standalone CLI package globally without the web application:
npm install -g exifsense-cliOr run it directly without installing globally:
npx --package=exifsense-cli exifsense --helpOr add the agent skill so AI coding agents know how to use exifsense-cli:
npx skills add dimsedra/ExifSenseOr build and link from source:
npm install
npm run build:cli
npm link# Analyze a single photo or JSON metadata file (hashes, alerts, 7 narratives, 8 EXIF categories)
exifsense single photo.jpg
# Inspect cryptographic hashes (SHA-256 & SHA-1) across files or directories
exifsense hash photo1.jpg photo2.jpg
exifsense hash path/to/folder/ --format markdown --out manifest.md
# Analyze multiple photos (Alerts, Chronological Story, and 4 Combined Analysis evidence views)
exifsense batch photo1.jpg photo2.jpg photo3.jpg
# Include full per-asset single-file breakdowns at the end of a batch report
exifsense batch photo1.jpg photo2.jpg --detailed
# Extract raw EXIF metadata into a clean JSON file
exifsense extract photo.jpg metadata.json
# Format output as Markdown in Indonesian and write directly to a file
exifsense batch photo1.jpg photo2.jpg --locale id --format markdown --detailed --out report.md| Flag | Description | Default |
|---|---|---|
--locale <en|id> |
Narrative and table language (en or id) |
en |
--format <plain|markdown> |
Output rendering format (plain text or markdown) |
plain |
--detailed |
Append individual single-asset breakdowns (exifsense single output) to batch reports |
false |
--out <path> |
Write output directly to a file instead of standard output | stdout |
- Single Analysis (
single): Displays file metadata with SHA-256 and SHA-1 hashes, Integrity Alerts, all 7 Forensic Narrative sections, and all 8 Categorized EXIF Metadata groups. - Batch Analysis (
batch): Follows the Web dashboard order withTotal Assets,Asset Integrity Alerts(when anomalies exist),Chronological Story, andCombined Analysis(Integrity Matrix, 7-column Hardware Comparison table, Timeline bounds and gaps, and Geospatial metrics with adaptivem/kmdistances and road-route estimates). - Detailed Batch Mode (
--detailed): Preserves the full batch summary above and appendsIndividual Asset Analysis(ASSET 1throughASSET N) in input order using single-asset formatting.
ExifSense is built with React 19, TypeScript, and Vite for the browser dashboard, sharing its core forensic, narrative, and geospatial modules with a standalone Node.js CLI bundled via Rolldown.
- Web Stack: React 19, TypeScript, Vite, and Zustand for client-side state.
- CLI Bundle: Rolldown-bundled Node.js 20+ executable (
exifsense-cli) sharing the core analysis engine with zero external runtime dependencies. - EXIF Engine & Sanitization: Exifr for multi-format metadata parsing (JPEG, TIFF, HEIC, DNG, RAW), plus
piexifjsand Canvas re-encoding for client-side metadata removal. - Geospatial Mapping: Leaflet.js with OSRM road-routing and Nominatim reverse geocoding.
- Document Generation: jsPDF with
jspdf-autotablefor structured PDF reporting. - Storage & Persistence: Browser-native
localStoragefor session history and language preferences, plusIndexedDBfor local image preview caching. - Testing: Vitest with
happy-dom.
Distributed under the MIT License. See LICENSE for more information.