Metadata-Version: 2.4
Name: pnutmap
Version: 0.8.2
Summary: A simple python wrapper for nmap
Author-email: Peanut <pnutvacation@gmail.com>
Project-URL: Homepage, https://github.com/realpnut/pnutmap
Project-URL: Bug Tracker, https://github.com/realpnut/pnutmap/issues
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# pnutmap

<p align="center">
  <img src="https://raw.githubusercontent.com/realpnut/pnutmap/main/demo/banner.png" width="512">
</p>

![Python](https://img.shields.io/badge/python-3.x-3776AB?style=flat-square)
![Nmap](https://img.shields.io/badge/powered%20by-nmap-4CAF50?style=flat-square)
![Status](https://img.shields.io/badge/status-active-success?style=flat-square)
![License](https://img.shields.io/badge/license-MIT-lightgrey?style=flat-square)

## about

pnutmap is a simple interactive Python wrapper for `nmap` designed for fast network scanning from the terminal.

it provides an easier way to run common reconnaissance commands without manually typing full nmap flags every time.

built for Linux environments, learning, lab use, and authorized security testing.

---

## features

```bash

                                      ▄▖    ▗ ▖  ▖    
                                      ▙▌▛▌▌▌▜▘▛▖▞▌▀▌▛▌
                                      ▌ ▌▌▙▌▐▖▌▝ ▌█▌▙▌
                                                   ▌ v0.8.1
         +------------------------+------------------------+------------------------+
         | 1. Quick Scan          | 6. Stealth Scan        | 11.IPv6 Scan           |
         | 2. Full Scan           | 7. Ping Discovery      | 12.SSH Brute Force     |
         | 3. Service Detection   | 8. Vulnerability Scan  | 13. UDP Scan           |
         | 4. OS Detection        | 9. Trace Route         | 14. Show this Menu     |
         | 5. Aggressive Scan     | 10.Firewall Evasion    | 0. Exit                |
         +------------------------+------------------------+------------------------+
      
Select an option:
```

<details>
<summary>show features</summary>

<br>

- quick scan (`-F`)
- full scan (`-p-`)
- service detection (`-sV`)
- os detection (`-O`)
- aggressive scan (`-A`)
- stealth scan (`-sS`)
- ping discovery (`-sn`)
- vulnerability scan (`--script vuln`)
- trace route (`--traceroute`)
- firewall evasion (`-f`)
- IPv6 scan (`-6`)
- SSH brute force (`-p 22 --script ssh-brute`)

</details>

---

## requirements

- Linux (Debian, Ubuntu, Arch, Kali, etc.)
- Python 3.x
- nmap installed

---

## installation (linux)

### Debian / Ubuntu / Kali / Arch / ANYTHING
```bash
pipx install pnutmap --force
```

## disclaimer

this tool is intended for educational purposes and authorized security testing only.

do not use it against systems you do not own or have explicit permission to test.

---

## license

MIT License

#
#
#
#
#
#
#
#

#
#
#
#
#
#
#

#
#
#
plz
