Port-Scanner

KO | EN

gitlite — search

#postgresql #cloud-native #ai-agents #github #javascript #large-language-models #react #electron #monitoring #python

(★ 9)

A simple Python port scanner for educational and authorized network testing.

File Explorer

ZIP Download

LICENCE
README.md
requirements.txt
scanner.py

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

### Fast & Lightweight TCP Port Scanning Tool

> **"Learn networks. Understand security. Build responsibly."**

A simple and efficient **Python-based TCP Port Scanner** created for **cybersecurity learning**, **network analysis**, and **authorized security testing**.

This tool helps users understand open ports, available services, and basic network security concepts through practical scanning.

---

# 👨‍💻 Developer

**Developed by:** **Adnan Abid**

Cybersecurity Learner • Ethical Hacking Enthusiast • Python Developer

Instagram: **@hackersec_lab**

---

# ⚠️ Disclaimer

> **This tool is created for educational purposes and authorized security testing only.**

Do not scan systems, networks, or devices without proper permission.

The developer is not responsible for any misuse or illegal activity performed using this tool.

Always test only your own systems or environments where you have explicit authorization.

---

# ✨ Highlights

* ⚡ Multi-threaded port scanning
* 🌐 IP address & domain support
* 🎨 Colorful terminal interface
* 🔍 TCP port detection
* 📡 Service name identification
* 🐍 Lightweight Python implementation
* 🚀 Fast scanning performance
* 📚 Beginner-friendly cybersecurity project

---

# 🔥 Features

* 🔎 Scan custom port ranges
* 🌍 Scan IP addresses or websites
* ⚡ 50 concurrent scanning threads
* 🟢 Detect open ports
* 🏷️ Identify common services
* 🎨 Terminal color output
* ⏱️ Fast socket-based scanning
* 💻 Works on Windows, Linux & macOS

---

# 📦 Installation

Clone the repository:

```bash
git clone https://github.com/hackerseclab/Port-Scanner.git
```

Move into the project directory:

```bash
cd Port-Scanner
```

Install requirements:

```bash
pip install -r requirements.txt
```

---

# 🚀 Usage

Run the scanner:

```bash
python scanner.py
```

Enter target:

```text
Enter target (IP or website):
```

Example:

```text
192.168.1.1
```

or:

```text
example.com
```

Select port range:

```text
Start Port (default 1): 1

End Port (default 100): 100
```

---

# 🖥️ Example Output

```text
🔍 Scanning example.com (93.xxx.xxx.xxx)
from port 1 to 100...

[+] Port 80 OPEN (http)
[+] Port 443 OPEN (https)

✅ Scanning finished.
```

---

# 🛠 Requirements

* Python 3.8+
* Colorama Library

Install:

```bash
pip install colorama
```

---

# 📁 Project Structure

```
Port-Scanner/
│
├── scanner.py
├── README.md
├── requirements.txt
└── LICENSE
```

---

# 🎯 Intended Audience

* Cybersecurity Students
* Python Beginners
* Ethical Hacking Learners
* Network Security Enthusiasts
* Security Researchers

---

# 🚀 Future Improvements

Planned features:

* 🔹 Banner grabbing
* 🔹 OS detection
* 🔹 Export scan reports
* 🔹 UDP scanning support
* 🔹 Better argument handling
* 🔹 Custom thread control

---

# 🤝 Contributing

Suggestions, improvements, and bug reports are welcome.

Feel free to open an issue or submit improvements.

---

# 📄 License

This project is for educational and authorized security testing purposes.

Users are responsible for following applicable laws and obtaining permission before scanning any system.

---

# ⭐ Support

If you find this project useful, consider giving it a ⭐ on GitHub.

---

## Developed by

# **Adnan Abid**

**Port Scanner v1.0**

Simple Network Security Learning Tool

Port-Scanner

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

Download README