Skip to content

dbuzatto/windows-system-auditor

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 

Repository files navigation

🧩 Windows System Auditor

A Python-based Windows system auditing tool that collects and visualizes key system information — including running processes, installed software, drives, services, and file inventory.
It automatically generates both CSV exports and an interactive HTML dashboard with data tables and charts.


🚀 Features

  • 🔍 System Information — OS version, CPU, architecture, and hostname
  • ⚙️ Process Scanner — Lists all active processes with CPU and memory usage
  • 🧠 Service Scanner — Detects non-Windows services using a PowerShell-based helper
  • 💾 Drive Usage — Displays total, used, and free space in stacked bar charts
  • 📦 Installed Programs — Reads installed software from Windows Registry
  • 📁 File Scanner — Recursively scans selected drives and lists all files (with size and modification date)
  • 📊 Interactive HTML Report — Bootstrap + DataTables + Plotly dashboard
  • 📜 CSV Exports — Each dataset saved individually under /outputs/

🖥️ Example Output

  • outputs/report_visual.html → Interactive HTML report
  • outputs/processes_*.csv → Process data
  • outputs/drives_*.csv → Drive info
  • outputs/installed_programs_*.csv → Installed software
  • outputs/files_*.csv → File listing

⚡ Requirements

  • Windows OS
  • Python 3.8+

Install dependencies:

pip install psutil plotly pandas

How to run

  1. Ensure you're on Windows and have Python 3.8+ installed.
  2. Install dependencies (see above).
  3. Run the auditor from the repository root:
python main.py

The script will create CSVs in the outputs/ folder and generate outputs/report_visual.html for a quick interactive view.

About

A Python-based Windows system auditing tool that scans running processes, non-Windows services, installed programs, drives, and files, generating detailed CSV reports and an interactive HTML dashboard.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages