Skip to content

Latest commit

Β 

History

8 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

VigiLance

Python Security Encryption Platform Status

A Windows-based intrusion detection system designed to monitor unauthorized access to WhatsApp Desktop, capture forensic evidence, encrypt logs, and send real-time Telegram alerts.


πŸš€ Features

  • Real-time WhatsApp Desktop activity detection
  • Automated webcam-based intruder photo capture
  • Encrypted forensic log storage (Fernet encryption)
  • Instant Telegram alert notifications (with evidence)
  • Password-protected control panel
  • Standalone executable deployment via PyInstaller
  • Lightweight background monitoring engine

πŸ› οΈ Tech Stack

  • Python 3.12
  • OpenCV
  • Cryptography (Fernet)
  • Psutil
  • PyGetWindow
  • Requests (Telegram Bot API)
  • Tkinter (GUI Framework)
  • PyInstaller (Executable Packaging)

πŸ“¦ Installation & Usage (Development Mode)

1️⃣ Clone the Repository

git clone https://github.com/aroh3006/VigiLance.git
cd VigiLance

2️⃣ Install Dependencies

pip install -r requirements.txt

3️⃣ Run Background Monitoring Engine

python guard_v6.py

4️⃣ Run Control Panel

python control_panel.py

πŸ—οΈ Architecture

  1. guard_v6.py

    • Background monitoring engine
    • Detects WhatsApp foreground activity
    • Captures image evidence
    • Encrypts logs
    • Sends Telegram alerts
  2. control_panel.py

    • GUI-based protection control
    • Password authentication
    • Start / Stop protection
    • View encrypted logs

πŸ—οΈ Project Structure

VigiLance/
β”‚
β”œβ”€β”€ control_panel.py      # GUI controller
β”œβ”€β”€ guard_v6.py           # Background monitoring engine
β”œβ”€β”€ requirements.txt
β”œβ”€β”€ VigiLance.ico
└── README.md

🧠 How It Works

  1. The background engine continuously monitors:

    • Active window titles
    • Running processes
  2. When WhatsApp Desktop activity is detected:

    • Webcam captures an image
    • WhatsApp process is terminated
    • Incident is encrypted and logged
    • Telegram alert is sent instantly
  3. The control panel allows:

    • Secure start/stop functionality
    • Password-protected access

πŸ” Security Concepts Implemented

  • Endpoint Monitoring
  • Process Inspection
  • Real-Time Threat Detection
  • Incident Response Automation
  • Encrypted Logging
  • Cloud-Based Alerting
  • Defensive Security Engineering

πŸ“² Telegram Alert Integration

  • Custom Telegram Bot integration
  • Instant alert messages upon detection
  • Photo evidence delivery
  • Remote monitoring capability

πŸ§ͺ Executable Build (Production Mode)

python -m PyInstaller --onefile --noconsole guard_v6.py
python -m PyInstaller --onefile --noconsole --icon=VigiLance.ico --name VigiLance control_panel.py

⚠️ Disclaimer

This project is developed strictly for educational and authorized defensive security purposes only. Do NOT deploy or use on systems without proper permission.


πŸ“Œ Future Improvements

  • Multi-application monitoring support
  • Cloud log backup integration
  • Admin dashboard with analytics
  • Auto-start on system boot
  • AI-based anomaly detection
  • Cross-platform support (Linux/macOS)

πŸ‘¨β€πŸ’» Author

Aroh Maurya

GitHub: https://github.com/aroh3006


⭐ If you found this project interesting, consider giving it a star.

About

Windows-based intrusion detection system with encrypted forensic logging and real-time Telegram alerts for WhatsApp Desktop.

Topics

Resources

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages