Skip to content

USB security framework that monitors, logs, audits, and blocks unauthorized USB devices in real time.

Notifications You must be signed in to change notification settings

shahdevam8/USB-Monitoring

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

15 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🔐 USB Device Monitoring and control device

A complete Windows USB security framework that monitors USB devices in real time, auto-blocks unauthorized devices, audits activity, and displays everything in a live GUI dashboard.


✅ What This Project Does

  • Real-time USB plug & unplug detection
  • Auto-block unauthorized USB devices
  • Allowlist & Blocklist based control
  • Live GUI dashboard with logs
  • USB activity auditing
  • Stable, clean V2 architecture

🧰 Requirements

  • Windows 10 / 11
  • Python 3.10+
  • Administrator privileges

📦 Installation

git clone https://github.com/shahdevam8/USB-Montoring.git
cd USB-Monitoring
python -m venv venv
venv\Scripts\activate
pip install -r requirements.txt

▶️ How to Run

python run.py

🖥 GUI Dashboard

  • Live USB activity logs
  • Allowed / Blocked status
  • Auto-refreshing view

Logs stored in:

logs/usb_activity.log

🔒 USB Policy Management

allowlist.json

[""]

blocklist.json

[""]

Format: VID:PID


⚙ settings.json

{
  "auto_block": true,
  "audit_usb_files": true,
  "log_level": "INFO"
}

📁 Project Structure

USB_Device_Control_Framework_V2/
├── run.py
├── core/
├── gui/
├── config/
├── logs/
└── data/

🧪 Testing

  • Insert USB
  • Check GUI
  • Verify logs
  • Modify allowlist/blocklist
  • Re-test device behavior

🔐 Security Note

Always run with Administrator privileges.


📌 License

Open-source for educational & research use.

About

USB security framework that monitors, logs, audits, and blocks unauthorized USB devices in real time.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages