Skip to content

Latest commit

 

History

History
50 lines (50 loc) · 2.68 KB

README.md

File metadata and controls

50 lines (50 loc) · 2.68 KB

System Audit Report Generator

This script collects various system details such as device information, logged-in users, MAC addresses, IP addresses, and installed applications. It then generates both an Excel and a PDF report containing this information.

Features

  • Collects system details (device name, processor, RAM, etc.)
  • Retrieves information about logged-in users
  • Gets the MAC address and IP addresses of the system
  • Gathers a list of installed applications (Windows only)
  • Creates Excel and PDF reports

Requirements

  • Python 3.x
  • Required packages: platform, socket, psutil, pandas, subprocess, datetime, getmac, tkinter, reportlab

Installation

Install the required packages using pip:

        pip install -r requirements.txt
    

Usage

  1. Run the script:
  2.             python main.py
            
  3. Select the directory where you want to save the reports.

The script will generate system_audit_report.xlsx and system_audit_report.pdf in the selected directory.

Script Details

The script includes the following functions:

  • get_system_details(): Collects system-related information.
  • get_users(): Retrieves information about logged-in users.
  • get_mac_addresses(): Gets the MAC address of the system.
  • get_ip_addresses(): Gathers IP address details for all network interfaces.
  • get_installed_apps_windows(): Uses a PowerShell command to get a list of installed applications on Windows.
  • create_excel_report(): Generates an Excel report and saves it to the specified path.
  • create_pdf_report(): Generates a PDF report and saves it to the specified path.
  • get_save_path(): Opens a file dialog for the user to select a directory to save the reports.

Contributing

Contributions are welcome! Please fork this repository and submit a pull request with your changes.

License

This project is licensed under the MIT License. See the LICENSE file for more details.