Skip to content

Ghost0d0/Ghost-Log-Monitor

Repository files navigation

Ghost Log Monitor 👻

Ghost Logo
A log monitoring tool for security analysis, threat detection, and system diagnostics


📜 Legal and Ethical Notice

This project is strictly for educational and authorized cybersecurity research purposes.

⚠️ Warning: Do not deploy this tool on systems you do not own or have explicit permission to monitor. Unauthorized use is illegal and violates ethical hacking principles.

By using Ghost Log Monitor, you agree to employ it only on systems where you have legal authorization.


📜 Youtube

https://youtu.be/HJRYHjQfJl0

🔍 Features

Real-time log monitoring (supports .log, .txt, and custom formats)
Automated threat detection (SQLi, XSS, brute force, suspicious IPs, etc.)
Custom alert system (GUI popups + optional email/SMTP notifications)
Threshold-based warnings (repeated IPs, error spikes, keyword patterns)
Dark/Light mode GUI (built with customtkinter for modern UI)
Log rotation & archiving (auto-compress old logs with configurable retention)


🛠️ Installation

Requirements

  • Python 3.7+
  • Libraries:
    customtkinter>=5.2.1
    pillow>=10.1.0
    
    (See requirements.txt)

Steps

  1. Clone the repo:
    git clone https://github.com/yourusername/ghost-log-monitor.git
    cd ghost-log-monitor
  2. Install dependencies:
    pip install -r requirements.txt
  3. (Optional) Use the included ghost-log-monitor.exe for Windows deployments.

⚙️ Configuration

Edit config.py to customize:

  • Security thresholds (IP/error limits, keywords)
  • Email alerts (SMTP server, recipients)
  • Log retention (file size/age triggers)
  • GUI themes (colors, refresh rate)

🖥️ Usage

python main.py

GUI Controls:

  • Browse & select log files
  • Start/stop monitoring
  • Real-time alert dashboard
  • Filter logs by severity/keyword

📜 Legal Reiteration

Educational Use Only:
This tool demonstrates log analysis techniques for defensive cybersecurity.

🚨 Unauthorized monitoring of systems is a crime. Use exclusively on networks/devices you own or have written consent to test.


📄 License

MIT License - See LICENSE.


👻 Ghost Log Monitor – Because even ghosts leave traces.

About

A log monitoring tool designed for security analysis and anomaly detection

Resources

License

Stars

Watchers

Forks

Packages

No packages published