🗺️ Network Topology

Visualize your network structure as ASCII art, interactive HTML diagrams, or DOT/Graphviz exports.

Quick Start

Access topology mapping from the interactive menu:

netscan
# Press 'y' for Network Topology

Output Formats

ASCII Art (Terminal)

python3 helpers/topology.py --scan --ascii

======================================================================
  NETWORK TOPOLOGY
======================================================================

                        ☁️  INTERNET
                            │
                            │
                    ┌───────┴───────┐
                    │   🌐 GATEWAY  │
                    │ 192.168.1.1   │
                    │ A4:91:B1:XX:XX│
                    └───────┬───────┘
                            │
        ────────────────────┼────────────────────
                      LOCAL NETWORK

  📡 ROUTERS/APs:
    ├── 192.168.1.2       TP-Link Access Point

  💻 HOSTS:
    ├── 192.168.1.10      Apple, Inc.
    ├── 192.168.1.15      Dell Inc.
    ├── 192.168.1.20      Samsung Electronics
    └── 192.168.1.25      Unknown

======================================================================
  Total devices: 5 | Gateway: 192.168.1.1
======================================================================

Interactive HTML

python3 helpers/topology.py --scan --html --output topology.html

Creates an interactive diagram using vis.js that you can:

• 🖱️ Drag nodes to rearrange
• 🔍 Zoom in/out with scroll
• ℹ️ Hover for device details
• 📱 Responsive for mobile viewing

DOT/Graphviz

# Generate DOT file
python3 helpers/topology.py --scan --dot --output network.dot

# Render with Graphviz
dot -Tpng network.dot -o network.png
dot -Tsvg network.dot -o network.svg
dot -Tpdf network.dot -o network.pdf

JSON Export

python3 helpers/topology.py --scan --json --output topology.json

CLI Reference

# From existing scan results
python3 helpers/topology.py --input scan.json --ascii

# Fresh network scan
python3 helpers/topology.py --scan --html --output map.html

# All options
python3 helpers/topology.py \
    --input scan.json \    # Use existing scan data
    --scan \               # Or perform fresh scan
    --ascii \              # ASCII art output
    --dot \                # DOT/Graphviz output
    --html \               # Interactive HTML
    --json \               # JSON structure
    --output FILE          # Save to file

Node Types & Colors

Python API

from helpers.topology import TopologyMapper

# Create mapper
mapper = TopologyMapper()

# Build from device list
devices = [
    {"ip": "192.168.1.1", "mac": "AA:BB:CC:DD:EE:FF", "vendor": "Cisco"},
    {"ip": "192.168.1.10", "mac": "11:22:33:44:55:66", "vendor": "Apple"},
]

topology = mapper.build_topology(devices)

# Render outputs
ascii_art = mapper.render_ascii()
html = mapper.render_html()
dot = mapper.render_dot()

# Access topology data
print(f"Gateway: {topology.gateway.ip}")
print(f"Nodes: {len(topology.nodes)}")