portwave
github.com
- Free plan
- Windows
- macOS
- Linux
What portwave is
portwave is a free command-line port scanner for Linux, macOS, and Windows. It scans IPv4 and IPv6 targets supplied as IP addresses, CIDRs, ranges, domains, or ASNs, including mixed inputs. Adaptive TCP connect scanning covers a curated port list by default, while an explicit option requests all 65,535 TCP ports. Confirmed HTTP targets can receive banner, TLS, certificate SAN and issuer, and HTTP(S) enrichment, followed by nuclei scans when ProjectDiscovery nuclei is installed. Domain handling resolves names in parallel, filters wildcard DNS, and skips known CDN edge IPs by default, with options for hostname enrichment or CDN-edge scanning. Results include open-port evidence, HTTP and SSL findings, nuclei output, summaries, and differences between runs, exported as JSONL, JSON, or TXT. Packet rate and maximum scan time can be limited. Large IPv6 scopes are refused above 2²⁰ hosts unless overridden, while smart IPv6 mode samples likely addresses. It uses TCP connections without raw sockets or root.
Who it suits
It suits security researchers and operators scanning systems they own or have written permission to assess. It is intended for command-line workflows across Linux, macOS, and Windows.
Good to know, and what to watch
- Accepts mixed IP, CIDR, domain, range, and ASN targets
- HTTP, TLS, certificate, and nuclei enrichment
- Exports JSONL, JSON, and TXT results
- Rate and maximum-time controls
- Runs without raw sockets or root
- No service-version fingerprinting beyond protocol classification
- No SYN scans, IDS evasion, or ICMP discovery
- All-port scans require an explicit option
- Large IPv6 scopes need an override
The verdict
portwave combines adaptive TCP scanning with HTTP, SSL, and optional nuclei findings. Its documented scope limits and protocol-level detection should shape expectations before deployment.
What the maker publishes
- DNS and CDN handling
- It resolves domains in parallel, filters wildcard DNS, and skips known CDN edge IPs by default, with options to enrich hostnames or scan CDN edges. source
- Enrichment
- The pipeline includes banner grabbing, TLS inspection, native HTTP(S) probing, certificate SAN and issuer extraction, and nuclei scans of confirmed HTTP targets. source
- Inputs
- It accepts IPs, CIDRs, ranges, domains, and ASNs, including mixed target types. source
- Installation
- The maker provides install instructions for Linux and macOS and for Windows, plus commands to update, check for updates, and uninstall. source
- Integrations
- The README documents piping subfinder output into portwave and using ProjectDiscovery nuclei for vulnerability scanning when installed. source
- Intended use
- The maker describes portwave as a security-research tool and says to scan only systems owned by the user or covered by written permission. source
- IPv6 limits
- Scopes larger than 2²⁰ hosts are refused unless an override is used; --smart-ipv6 can sample likely addresses in large ranges. source
- IPv6 scope
- Scopes larger than 2²⁰ hosts are refused unless an override is used; smart IPv6 mode samples likely addresses for large ranges. source
- License
- The repository identifies the software as MIT licensed. source
- License and support
- The repository identifies the project as MIT licensed and directs users to GitHub issues and pull requests. source
- Limitations
- Portwave uses TCP connect scans without raw sockets or root, does not fingerprint service versions beyond protocol classification, and has no IDS evasion or ICMP discovery preflight. source
- Outputs
- It writes scan results, HTTP enrichment, SSL findings, summaries, and run-to-run port differences to files. source
- Purpose
- Portwave is an IPv4/IPv6 port scanner with HTTP(S) enrichment, SSL reconnaissance, and a nuclei pipeline. source
- Rate controls
- Scans can be constrained by packet rate and maximum scan time, and small scopes pace simultaneous probes per host. source
- Results
- Scan outputs include open-port evidence, HTTP enrichment, SSL findings, nuclei findings, summaries, and scan diffs. source
- Scanning
- It uses adaptive TCP connect scanning and can scan all 65,535 TCP ports when explicitly requested. source
- Scope limits
- A bare scan uses a curated port list; scanning all 65535 TCP ports requires the explicit --all-ports option. source
- Security behavior
- The README says bundled OpenSSL accepts self-signed, expired, hostname-mismatched, and malformed certificates so the scanner can inspect responses. source
- Support
- The maker directs users to GitHub Issues and pull requests for contact and support. source
- Targets
- It accepts IPs, CIDRs, ranges, domains, and ASNs, including mixed target inputs. source
- Technical limits
- Portwave uses TCP connect scanning and does not provide SYN scans, service-version fingerprinting beyond a 9-label protocol classification, IDS evasion, or ICMP host discovery. source
Checked against the maker's pages on 8 Oct 2026.