Skip to content

Repository files navigation

Metadata Analyzer

CI Python License

Forensic metadata extraction tool for images and documents. Built for DFIR investigations.

Landing Page · Report Bug · View Demo


What it does

Drop any image, PDF, or Word document into it and it extracts the hidden metadata layer — who created it, when, with what device, and where on Earth.

Format Key Fields Extracted
JPG / JPEG / PNG / TIFF Camera make & model, GPS coordinates, exposure, ISO, focal length, EXIF strip detection, MD5/SHA256, entropy
PDF Author, creator tool, producer, dates, page count, encryption status, MD5/SHA256, entropy
DOCX Author, last modified by, revision number, application, dates, word count, MD5/SHA256, entropy

Output formats: JSON · CSV · HTML (with clickable GPS map links)


Installation

git clone https://github.com/michspenz/MetaData-Analyzer.git
cd MetaData-Analyzer
pip install -r requirements.txt

Usage

# Single file
python analyzer.py photo.jpg
python analyzer.py document.pdf

# Entire folder
python analyzer.py evidence/

# With reports
python analyzer.py evidence/ --html --json --csv

# Recursive scan
python analyzer.py evidence/ --recursive


Roadmap

  • Timeline generation from timestamps
  • Steganography detection (LSB analysis)
  • Chain of custody audit log
  • GUI version

Disclaimer

For defensive and forensic use only. Only analyze files you own or have explicit authorization to examine.


Michael Oscar · GitHub · Twitter


About

Forensic metadata extraction tool for images (JPG, PNG, TIFF) and documents (PDF, DOCX) — generates structured JSON and CSV investigation reports.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages