Skip to content

punithsai18/sensorGuard

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🛡️ 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.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors