Skip to content

Latest commit

 

History

History
33 lines (21 loc) · 907 Bytes

File metadata and controls

33 lines (21 loc) · 907 Bytes

PortSentinel - Lightweight Port Scan Detector

PortSentinel is a simple, lightweight Intrusion Detection System built using Scapy. It monitors incoming TCP traffic to detect potential port scanning attacks on your network.

⚙️ Features

  • Detects TCP port scans based on connection frequency
  • Customizable thresholds via command-line
  • Logs alerts to alerts.log
  • Colored terminal output using colorama
  • Graceful shutdown with Ctrl+C

📸 Screenshot

screenshot


🚀 Getting Started

🧩 Requirements

  • Python 3.7+
  • Npcap (Windows only)
  • Admin/root privileges for sniffing

🔧 Installation

  1. Clone the repo
    git clone https://github.com/yourusername/PortSentinel.git
    cd PortSentinel