Metadata-Version: 2.4
Name: portwarden
Version: 1.0.1
Summary: A fast multi-threaded TCP port scanner with JSON output.
Home-page: https://github.com/nfs-tech-bd/portwarden 
Author: B14CK-KN1GH7
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Developers
Classifier: Topic :: Security
Classifier: Environment :: Console
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license
Dynamic: license-file
Dynamic: requires-python
Dynamic: summary

<p align="center"><img src="https://raw.githubusercontent.com/nfs-tech-bd/PortWarden/refs/heads/main/logo.png" hight="300" width="300" alt="LOGO" border="0"></p>                                                                                                                         
                                                                                        
# 🔐 PortWarden – The Stealthy Port Scanner

> ⚡ Fast, threaded, and hacker-friendly TCP port scanner written in Python

[![Python](https://img.shields.io/badge/python-3.7%2B-blue.svg )](https://www.python.org/ )
[![Build](https://img.shields.io/badge/status-active-brightgreen.svg )](https://github.com/biplo8/portwarden )

---

## 🛠 What is PortWarden?

**PortWarden** is a powerful network reconnaissance tool designed for ethical hackers and penetration testers. It scans all 65,535 TCP ports using multi-threading, identifies known services running on open ports, and saves results in structured JSON format.

> Perfect for CTFs, bug bounty hunting, or learning how network scanning works under the hood.

---

## 🌟 Features

✅ Multi-threaded scanning (up to 300 threads)  
✅ Real-time open port detection  
✅ Live progress bar with ETA  
✅ Service name lookup for over 100+ common ports  
✅ Auto-saves results to `.json` file (`<target_ip>.json`)  
✅ Final summary: "Found X open ports"  

---

## 📦 Requirements

- Python 3.7+
- Standard libraries only (no external dependencies)

---

## 🚀 Usage

```bash
portwarden <host>
