Skip to content

Latest commit

 

History

3 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 

Repository files navigation

🕵️ MetaSpy – Advanced Metadata Extractor Tool

MetaSpy is a powerful, multi-format metadata extractor built in Python. It supports various file types including images, audio, video, PDFs, DOCX, and binary files, making it ideal for digital forensics, file auditing, and ethical hacking investigations.

Developed by Soham


🔍 Features

  • ✅ MIME type auto-detection using python-magic
  • 🖼️ EXIF extraction from images (JPEG, PNG)
  • 🎵 ID3 tag reading for MP3/FLAC/etc.
  • 🎥 Video metadata from MP4, MKV, AVI using pymediainfo
  • 📄 PDF and DOCX metadata
  • 🛠️ Binary file parsing via Hachoir
  • 📤 Optional JSON export
  • 💻 Clean CLI interface

📦 Installation & Usage Guide

🧰 Requirements

  • Python 3.8+

🛠️ Required Python Libraries

Install all dependencies via pip:

pip install python-magic Pillow mutagen pymediainfo PyPDF2 python-docx hachoir

📦 Installation & Usage Guide

🧱 System Dependencies

Linux (Debian/Ubuntu)

  • Install the following packages to support MIME detection and media metadata extraction:
sudo apt update
sudo apt install -y libmagic1 mediainfo

Windows

    1. MediaInfo CLI:
  • Download from MediaInfo official site and add it to your system PATH environment variable.

    1. libmagic binaries:
  • Download Windows binaries for libmagic from here and ensure they are accessible.

    1. Alternatively, use the Python package bundling libmagic for Windows:

🚀 Running MetaSpy

  • Run from the command line:
python metaspy.py <file_path> [--json]
  • Examples:
python metaspy.py sample.jpg
python metaspy.py document.pdf
python metaspy.py video.mp4 --json

About

MetaSpy is a powerful Python-based metadata extractor by Soham that supports multiple file formats including images, audio, video, PDF, DOCX, and generic binaries. It’s designed to be useful in forensic investigations, file auditing, and digital footprint analysis. Output is structured and human-readable, with optional JSON export support.

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages