Skip to content

Releases: 8tp/netmap

v1.0.0

05 Mar 06:54
@8tp 8tp

Choose a tag to compare

netmap v1.0.0

First release — a visual network topology mapper and scanner TUI.

Features

  • ARP scanning (root) and fallback discovery (non-root) for host detection
  • TCP port scanning on top 50 common ports with service name mapping
  • Interactive topology graph — gateway at top, hosts as colored nodes with connection lines
  • Host detail panel — IP, MAC, vendor (OUI lookup), latency, open ports, sparkline history
  • Sortable host table — by IP, latency, ports, or vendor
  • Auto-refresh every 30s with countdown timer
  • ARP proxy detection — collapses captive portal ghost hosts automatically
  • Device type heuristics — Router, NAS, Printer, Apple Device, Server, etc.
  • JSON export — press e to dump scan results
  • Vim-style navigationj/k, Tab to switch panels, ? for help

Install

# From source (recommended — requires Go 1.22+ and libpcap)
git clone https://github.com/8tp/netmap.git
cd netmap
go build -o netmap .
sudo ./netmap

Or download the macOS binary below.

Pre-built Binary

Platform Architecture File
macOS x86_64 (Intel) netmap-v1.0.0-darwin-amd64.tar.gz

Note: Linux users should build from source (go build) since the binary requires libpcap linked at compile time. macOS arm64 (Apple Silicon) users can run the amd64 binary via Rosetta, or build from source natively.

Requirements

  • libpcap — ships with macOS Xcode CLI tools; apt install libpcap-dev on Linux
  • sudo recommended for full ARP scanning (runs in limited mode without root)