Visual Identity Fingerprint (VIF) 🛡️

Visual Identity Fingerprint (VIF) is a cybersecurity system designed to combat document leakage. By leveraging Constructive Watermarking and Computer Vision, VIF transforms an organization's official logo into a covert, intelligent tracking tool containing verified metadata.

---

🚀 Key Features

• Constructive Watermarking: The logo is reconstructed using data-infused text mosaics instead of solid pixels.
• Forensic Engine v1.0: Advanced recovery using Spectral Isolation (HSV), Morphological Welding, and CLAHE algorithms.
• Ground Truth Verification: Automated validation system that compares extracted data against system logs to confirm attribution.
• High Recovery Rate: Uses statistical consensus to recover User IDs and Device signatures from partial data fragments (99.9% Certainty).

---

🛠️ Technology Stack

• Core: Python 3.10+
• Image Processing: OpenCV, Pillow (PIL), NumPy
• Vector Graphics: CairoSVG
• AI-OCR: Tesseract 5 (LSTM Neural Nets)
• PDF Manipulation: PyMuPDF (Fitz)

---

📂 Repository Structure

File	Description
VIF_Demo.ipynb	(Start Here) Interactive Notebook to run the full system in Google Colab.
VIF_Generator.py	Generates the secure fingerprint from raw metadata using constructive text layering.
VIF_Overlay.py	Merges the fingerprint intelligently with PDF/Image documents.
VIF_Forensic_Scanner.py	(The Engine) Analyzes evidence, extracts EXIF data, and recovers hidden text using AI-OCR.
LOGO.svg	The vector source file for the official logo (Required for generation).
LICENSE	Custom Non-Commercial License (Patent Protection).

---

📖 Usage Guide

Option 1: Run in Google Colab (Recommended)

Click the "Open in Colab" badge above to launch the live demo.

• No installation required.
• Runs directly in your browser.
• Demonstrates the full cycle: Generation -> Protection -> Forensic Analysis.

Option 2: Local Installation

1. Clone the Repository:

   git clone [https://github.com/Ahmed-alrashidi/VIF.git](https://github.com/Ahmed-alrashidi/VIF.git)
   cd VIF

2. Install Dependencies:

   pip install -r requirements.txt
   # System Requirements: Tesseract-OCR, CairoSVG

3. ⚠️ Critical Setup:

   • You must place your official vector logo in the root folder.
   • The file must be named exactly: LOGO.svg.

4. Run the Tools:

   # 1. Generate Fingerprint
   python VIF_Generator.py
   
   # 2. Protect Document
   python VIF_Overlay.py your_document.pdf
   
   # 3. Analyze Evidence
   python VIF_Forensic_Scanner.py Protected_your_document.pdf

---

⚠️ Intellectual Property Notice

This software is the technical implementation of a patent-pending invention filed with the Saudi Authority for Intellectual Property (SAIP).

• Invention Title: Visual Identity Fingerprint (VIF)
• Application Number: 57168910
• Filing Date: 2025-10-26
• Author: Eng. Ahmed Hamad Al-Rashidi

Legal Warning: Any unauthorized commercial use, reproduction, or deployment of the algorithms described herein is a violation of intellectual property laws.

📜 License

This project is licensed under a Custom Non-Commercial & Academic Use License. You are free to view and study the code for educational purposes only. See the LICENSE file for full terms.

---

_{Made with ❤️ in Buraydah, Al-Qassim | KSA 🌴}