# thenareshofficial/ipscanmaster architecture

> Architecture diagram of the GitHub repository thenareshofficial/ipscanmaster, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/thenareshofficial/ipscanmaster
- Repository: https://github.com/thenareshofficial/ipscanmaster

## Overview

IPScan Master is a command-line reconnaissance and security-assessment tool. Users select scan or attack mode and provide an IP address or domain; the CLI validates and dispatches the target to the relevant checks. Scan mode combines reachability, DNS/reverse lookup, WAF, subdomain, port, web, directory, IP-information, and WHOIS checks. Attack mode coordinates scans and external tools, queries archive history, and saves output. The graph preserves documented capabilities, but some integrations are represented only where the README or sampled callers show their use; unsampled implementation details are not inferred.

Main entry points: [`main.py`](https://github.com/thenareshofficial/ipscanmaster/blob/main/main.py) (Argument dispatch), [`src/attack.py`](https://github.com/thenareshofficial/ipscanmaster/blob/main/src/attack.py) (Attack coordinator), [`src/wayback.py`](https://github.com/thenareshofficial/ipscanmaster/blob/main/src/wayback.py) (Archive history), [`src/api/ipinfo.py`](https://github.com/thenareshofficial/ipscanmaster/blob/main/src/api/ipinfo.py) (IP information)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI and coordination"]
  node_main["Argument dispatch<br/>[main.py]"]
end

subgraph group_recon["Target reconnaissance"]
  node_reachability["IP reachability<br/>[ping.py]"]
  node_reverse["IP and DNS lookup<br/>[reverse.py]"]
  node_ports["Port scanning<br/>[ports.py]"]
  node_subdomains["Subdomain enumeration<br/>[sublister.py]"]
  node_ipinfo["IP information<br/>[ipinfo.py]"]
  node_whois["WHOIS lookup<br/>[whois.py]"]
  node_ip_change["IP normalization<br/>[IPchg.py]"]
end

subgraph group_web["Web assessment"]
  node_waf["WAF detection<br/>[waf.py]"]
  node_directory["Directory search<br/>[dir.py]"]
  node_whatweb["Technology fingerprinting<br/>[whatWEB.py]"]
  node_wayback["Archive history<br/>[wayback.py]"]
  node_xss["XSS testing<br/>[xss.py]"]
end

subgraph group_attack["Attack workflow"]
  node_attack_runner["Attack coordinator<br/>[attack.py]"]
  node_httpx["HTTPX toolkit<br/>[attack.py]"]
  node_nmap["Nmap checks<br/>[attack.py]"]
  node_output["Attack output files<br/>[attack.py]"]
end

subgraph group_support["Shared utilities"]
  node_inet["Connectivity check<br/>[inet.py]"]
  node_history["IP history<br/>[ip_history.py]"]
  node_terminal["Terminal presentation<br/>[color.py]"]
end

node_user(("CLI user"))
node_ipinfo_service(("IPinfo API"))
node_archive_service(("Wayback Machine"))
node_subfinder_service(("subfinder"))
node_external_tools(("External scan tools"))

node_user -->|"selects target"| node_main
node_main -->|"checks reachability"| node_reachability
node_main -->|"looks up DNS"| node_reverse
node_main -->|"checks WAF"| node_waf
node_main -->|"runs enumeration"| node_subfinder_service
node_main -->|"scans ports"| node_ports
node_main -->|"fingerprints web"| node_whatweb
node_main -->|"searches paths"| node_directory
node_main -->|"normalizes target"| node_ip_change
node_main -->|"gets IP details"| node_ipinfo
node_main -->|"queries WHOIS"| node_whois
node_main -->|"starts attack"| node_attack_runner
node_main -->|"starts XSS test"| node_xss
node_main -->|"queries archives"| node_wayback
node_main -->|"enumerates domains"| node_subdomains
node_main -->|"checks connection"| node_inet
node_main -->|"records target"| node_history
node_attack_runner -->|"looks up DNS"| node_reverse
node_attack_runner -->|"scans ports"| node_ports
node_attack_runner -->|"runs enumeration"| node_subfinder_service
node_attack_runner -->|"probes subdomains"| node_httpx
node_attack_runner -->|"runs WAF and directory checks"| node_external_tools
node_attack_runner -->|"gets archive data"| node_wayback
node_attack_runner -->|"runs scripts"| node_nmap
node_attack_runner -->|"writes results"| node_output
node_ipinfo -->|"requests details"| node_ipinfo_service
node_wayback -->|"requests snapshots"| node_archive_service

click node_main "https://github.com/thenareshofficial/ipscanmaster/blob/main/main.py"
click node_attack_runner "https://github.com/thenareshofficial/ipscanmaster/blob/main/src/attack.py"
click node_reachability "https://github.com/thenareshofficial/ipscanmaster/blob/main/src/ping.py"
click node_reverse "https://github.com/thenareshofficial/ipscanmaster/blob/main/src/reverse.py"
click node_ports "https://github.com/thenareshofficial/ipscanmaster/blob/main/src/ports.py"
click node_subdomains "https://github.com/thenareshofficial/ipscanmaster/blob/main/src/sublister.py"
click node_ipinfo "https://github.com/thenareshofficial/ipscanmaster/blob/main/src/api/ipinfo.py"
click node_whois "https://github.com/thenareshofficial/ipscanmaster/blob/main/src/whois.py"
click node_ip_change "https://github.com/thenareshofficial/ipscanmaster/blob/main/src/IPchg.py"
click node_waf "https://github.com/thenareshofficial/ipscanmaster/blob/main/src/waf.py"
click node_directory "https://github.com/thenareshofficial/ipscanmaster/blob/main/src/dir.py"
click node_whatweb "https://github.com/thenareshofficial/ipscanmaster/blob/main/src/whatWEB.py"
click node_wayback "https://github.com/thenareshofficial/ipscanmaster/blob/main/src/wayback.py"
click node_xss "https://github.com/thenareshofficial/ipscanmaster/blob/main/src/xss.py"
click node_httpx "https://github.com/thenareshofficial/ipscanmaster/blob/main/src/attack.py"
click node_nmap "https://github.com/thenareshofficial/ipscanmaster/blob/main/src/attack.py"
click node_output "https://github.com/thenareshofficial/ipscanmaster/blob/main/src/attack.py"
click node_inet "https://github.com/thenareshofficial/ipscanmaster/blob/main/tools/inet.py"
click node_history "https://github.com/thenareshofficial/ipscanmaster/blob/main/tools/ip_history.py"
click node_terminal "https://github.com/thenareshofficial/ipscanmaster/blob/main/tools/color.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_main,node_user toneBlue
class node_reachability,node_reverse,node_ports,node_subdomains,node_ipinfo,node_whois,node_ip_change toneAmber
class node_waf,node_directory,node_whatweb,node_wayback,node_xss,node_ipinfo_service toneMint
class node_attack_runner,node_httpx,node_nmap,node_output toneRose
class node_inet,node_history,node_terminal,node_archive_service,node_subfinder_service,node_external_tools toneIndigo
```

## Components

### CLI and coordination

- [Argument dispatch](https://github.com/thenareshofficial/ipscanmaster/blob/main/main.py): `main.py`

### Target reconnaissance

- [IP reachability](https://github.com/thenareshofficial/ipscanmaster/blob/main/src/ping.py): `src/ping.py`
- [IP and DNS lookup](https://github.com/thenareshofficial/ipscanmaster/blob/main/src/reverse.py): `src/reverse.py`
- [Port scanning](https://github.com/thenareshofficial/ipscanmaster/blob/main/src/ports.py): `src/ports.py`
- [Subdomain enumeration](https://github.com/thenareshofficial/ipscanmaster/blob/main/src/sublister.py): `src/sublister.py`
- [IP information](https://github.com/thenareshofficial/ipscanmaster/blob/main/src/api/ipinfo.py): `src/api/ipinfo.py`
- [WHOIS lookup](https://github.com/thenareshofficial/ipscanmaster/blob/main/src/whois.py): `src/whois.py`
- [IP normalization](https://github.com/thenareshofficial/ipscanmaster/blob/main/src/IPchg.py): `src/IPchg.py`

### Web assessment

- [WAF detection](https://github.com/thenareshofficial/ipscanmaster/blob/main/src/waf.py): `src/waf.py`
- [Directory search](https://github.com/thenareshofficial/ipscanmaster/blob/main/src/dir.py): `src/dir.py`
- [Technology fingerprinting](https://github.com/thenareshofficial/ipscanmaster/blob/main/src/whatWEB.py): `src/whatWEB.py`
- [Archive history](https://github.com/thenareshofficial/ipscanmaster/blob/main/src/wayback.py): `src/wayback.py`
- [XSS testing](https://github.com/thenareshofficial/ipscanmaster/blob/main/src/xss.py): `src/xss.py`

### Attack workflow

- [Attack coordinator](https://github.com/thenareshofficial/ipscanmaster/blob/main/src/attack.py): `src/attack.py`
- [HTTPX toolkit](https://github.com/thenareshofficial/ipscanmaster/blob/main/src/attack.py): `src/attack.py`
- [Nmap checks](https://github.com/thenareshofficial/ipscanmaster/blob/main/src/attack.py): `src/attack.py`
- [Attack output files](https://github.com/thenareshofficial/ipscanmaster/blob/main/src/attack.py): `src/attack.py`

### Shared utilities

- [Connectivity check](https://github.com/thenareshofficial/ipscanmaster/blob/main/tools/inet.py): `tools/inet.py`
- [IP history](https://github.com/thenareshofficial/ipscanmaster/blob/main/tools/ip_history.py): `tools/ip_history.py`
- [Terminal presentation](https://github.com/thenareshofficial/ipscanmaster/blob/main/tools/color.py): `tools/color.py`

### Other components

- **CLI user**
- **IPinfo API**
- **Wayback Machine**
- **subfinder**
- **External scan tools**

## Connections

- CLI user → Argument dispatch: selects target (evidence: `main.py`)
- Argument dispatch → IP reachability: checks reachability (evidence: `main.py`)
- Argument dispatch → IP and DNS lookup: looks up DNS (evidence: `main.py`)
- Argument dispatch → WAF detection: checks WAF (evidence: `main.py`)
- Argument dispatch → subfinder: runs enumeration (evidence: `main.py`)
- Argument dispatch → Port scanning: scans ports (evidence: `main.py`)
- Argument dispatch → Technology fingerprinting: fingerprints web (evidence: `main.py`)
- Argument dispatch → Directory search: searches paths (evidence: `main.py`)
- Argument dispatch → IP normalization: normalizes target (evidence: `main.py`)
- Argument dispatch → IP information: gets IP details (evidence: `main.py`)
- Argument dispatch → WHOIS lookup: queries WHOIS (evidence: `main.py`)
- Argument dispatch → Attack coordinator: starts attack (evidence: `main.py`)
- Argument dispatch → XSS testing: starts XSS test (evidence: `main.py`)
- Argument dispatch → Archive history: queries archives (evidence: `main.py`)
- Argument dispatch → Subdomain enumeration: enumerates domains (evidence: `main.py`)
- Argument dispatch → Connectivity check: checks connection (evidence: `main.py`)
- Argument dispatch → IP history: records target (evidence: `main.py`)
- Attack coordinator → IP and DNS lookup: looks up DNS (evidence: `src/attack.py`)
- Attack coordinator → Port scanning: scans ports (evidence: `src/attack.py`)
- Attack coordinator → subfinder: runs enumeration (evidence: `src/attack.py`)
- Attack coordinator → HTTPX toolkit: probes subdomains (evidence: `src/attack.py`)
- Attack coordinator → External scan tools: runs WAF and directory checks (evidence: `src/attack.py`)
- Attack coordinator → Archive history: gets archive data (evidence: `src/attack.py`)
- Attack coordinator → Nmap checks: runs scripts (evidence: `src/attack.py`)
- Attack coordinator → Attack output files: writes results (evidence: `src/attack.py`)
- IP information → IPinfo API: requests details (evidence: `src/api/ipinfo.py`)
- Archive history → Wayback Machine: requests snapshots (evidence: `src/wayback.py`)
