Skip to content

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.

Notifications You must be signed in to change notification settings

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