👁️ BYAKUGAN (ビャクガン)

The All-Seeing Eye: Professional Forensic Metadata Analyzer

BYAKUGAN is a high-precision digital forensic tool designed to extract, analyze, and report hidden metadata within digital files. Inspired by the "All-Seeing Eye," this tool pierces through the digital layers of a file to expose sensitive information—such as geolocation, device hardware IDs, and sensor data—that often remains invisible to the naked eye.

---

🎯 Purpose & Mission

In the age of information, privacy is often overlooked. Every photograph or file you share contains a digital fingerprint of your device and habits.

The mission of BYAKUGAN is to increase privacy awareness. This tool helps security researchers and users to:

• Audit their own media before sharing it online.
• Understand the extent of data captured by modern smartphone sensors (OPPO, vivo, Apple, etc.).
• Identify potential security leaks like GPS coordinates and hardware serial numbers.

---

⚖️ Ethical Disclosure & Disclaimer

Warning: This tool is strictly for Educational and Security Research purposes only.

• The author DOES NOT support or encourage any illegal or unethical activities (e.g., stalking, unauthorized data gathering).
• Using this tool to invade someone else's privacy is a violation of ethical standards and potentially local laws.
• Use it responsibly to protect yourself and educate others.

---

✨ Features

• 🛡️ Forensic Precision: Extracts EXIF, XMP, IPTC, and MakerNotes.
• 🌈 Colorized Terminal: Intuitive and easy-to-read color-coded output for better analysis.
• 📄 Professional Reporting: Generate detailed TXT reports with forensic headers using the -o flag.
• 📂 Batch Analysis: Scan a single file or an entire directory of images at once.
• 📱 Wide Compatibility: Supports .jpg, .jpeg, .png, .webp, .tiff, .heic, .mp4, .pdf, etc.

---

🛠️ Installation & Setup

1. Prerequisite: Install ExifTool

BYAKUGAN relies on the industry-standard exiftool engine.

Termux (Android)

pkg install exiftool python -y

Linux (Ubuntu/Debian)

sudo apt update && sudo apt install exiftool python3 -y

Windows

1. Download the ExifTool executable from exiftool.org.
2. Rename exiftool(-k).exe to exiftool.exe.
3. Add the folder containing exiftool.exe to your System PATH.

---

🚀 Usage Guide

BYAKUGAN provides a simple yet powerful CLI interface.

Command | Description python3 byakugan.py | Quick scan of a single file or directory. python3 byakugan.py -o | Scan and save a professional forensic report (.txt). python3 byakugan.py -h | Show help menu and available flags.

📄how to use

Termux / Linux Commands

Navigate to the folder: cd "/path/to/BYAKUGAN/"

Analyze a single image: python3 byakugan.py "image.jpg"

Analyze and save a forensic report: python3 byakugan.py "image.jpg" -o

Scan an entire directory: python3 byakugan.py "/storage/emulated/0/DCIM/Camera/" -o

Windows (CMD/PowerShell) Commands

Analyze and save report on Windows: python byakugan.py "C:\Users\Name\Pictures\photo.jpg" -o

📄 Sample Report Structure

Reports generated with the -o flag include a professional audit header:

==================================================
        BYAKUGAN FORENSIC REPORT
==================================================
Project      : https://github.com
Author       : Akher Sheikh
Date & Time  : 2026-03-16 23:15:42
Target File  : IMG_20260316.jpg
==================================================
[Full Metadata Output Follows...]

🤝 Contributing

Contributions are welcome! If you have ideas for enhancing the forensic capabilities or adding privacy risk scoring, please open an issue or submit a pull request.

BYAKUGAN — See what the world hides.

Developed by Akher Sheikh