🛡️ SensorGuard

SensorGuard is an advanced privacy and security monitoring suite for Windows. It provides a real-time dashboard to monitor sensors (Camera, Microphone, Location), track application screen time, and detect suspicious "Multi-Sensor" attack patterns.

🚀 Key Features

• Live Sensor Dashboard: Real-time monitoring of Battery, Network, Geolocation, Orientation, and Memory.
• Historical Timeline: Auditable logs of every sensor access and hardware event (stored in SQLite).
• Browser Forensics: Scans Chrome, Edge, and Firefox database files to show site-specific permissions.
• Active Defense: Integrated "Kill Process" switch to immediately terminate unauthorized apps accessing your sensors.
• USB Monitoring: Real-time logging of hardware insertion/removal event.
• Screen Time Tracking: Detailed breakdowns of which applications (and web domains) you spend the most time on.

🛠️ Architecture

SensorGuard uses a hybrid architecture for maximum effectiveness:

1. Frontend: React + Vite (Modern, responsive UI).
2. Backend (Node.js): Express server for browser forensics, registry scanning, and process management.
3. Monitors (Python): High-performance background scripts for low-level Win32 API interactions and WebSocket broadcasting.

📦 Installation & Setup

Prerequisites

• Node.js (v18+)
• Python 3.10+ (with pip)

1. Clone & Install Dependencies

git clone https://github.com/your-repo/sensorGuard.git
cd sensorGuard
npm install
pip install psutil websockets wmi pywin32

2. Start the Application

You can run everything concurrently:

# Run Vite Frontend + Node.js Backend
npm run dev:all

In separate terminals, start the Python monitoring services:

python sensorDetector.py
python background_apps_monitor.py
python screenTimeTracker.py

📖 Learn More

For a deep dive into the methodology, WebSocket implementation, and future roadmap, please refer to the Project Overview.

🛡️ Privacy Note

SensorGuard reads local system files and registry keys to provide privacy insights. All data remains on your local machine in the screen_time.db SQLite database. No data is sent to external servers.

---

Developed for Advanced Privacy Awareness.