A lightweight Python-based port scanner that uses the nmap module to scan a target's open ports (1–1024 by default). Features a clean terminal loader animation and logs scan results to a report file.
- 🔍 Scans TCP ports (1–1024) using
nmap - 🎯 Accepts IP address or domain as input
- ⏳ Real-time loading animation during scan
- 📁 Auto-saves scan reports in the
scan_reports/folder - 💡 Simple, terminal-friendly, and beginner-safe
- Python 3.x
python-nmappackagenmapmust be installed on your system
-
Clone the Repository
git clone https://github.com/your-username/port-scanner.git cd port-scanner -
Install Python Requirements
pip install python-nmap
-
Install Nmap Tool (if not already installed)
- For Linux (Debian/Kali):
sudo apt install nmap
- For Windows:
Download from official site and addnmapto system PATH.
- For Linux (Debian/Kali):
python3 port_scanner.pyThen enter your target IP or domain when prompted:
Enter your target (Domain or IP) >> scanme.nmap.org- The tool creates a folder
scan_reports/(you can create it manually if not present). - Each scan creates or updates a file named like
scanme_nmap_org.txt.
Example content:
Host : scanme.nmap.org ()
port : 22 state : open
port : 80 state : open
2025-07-10 10:32:19.150041 scanned using namap module
This tool is for educational and authorized testing only.
Never scan a system you don't have permission to test.
Developed with ❤ by Amal
Python + Nmap = Fast & Friendly Scanning 🔐