netmap#

Scans the local network and maintains a persistent device database at ~/.config/netmap/devices.json.

Requirements#

• nmap must be installed: brew install nmap
• Script: scripts/netmap.py

Commands#

bash

# Discover all devices on the network (fast, ~30-60s)
python3 scripts/netmap.py scan

# Deep scan — also port-scans each device to identify type (slower, ~2-3min)
python3 scripts/netmap.py scan --deep

# Override subnet (auto-detected by default)
python3 scripts/netmap.py scan --subnet 10.0.0.0/24

# List all known devices
python3 scripts/netmap.py list
python3 scripts/netmap.py list --times   # include first/last seen

# Find a device by IP, hostname, MAC, vendor, or device type
python3 scripts/netmap.py find printer
python3 scripts/netmap.py find 192.168.1.12
python3 scripts/netmap.py find Canon

# Label a device with a friendly name
python3 scripts/netmap.py label 192.168.1.12 "Canon Printer"
python3 scripts/netmap.py label AA:BB:CC:DD:EE:FF "Kevin's iPhone"

# Show devices first seen in the last N minutes
python3 scripts/netmap.py new --minutes 30

# Export device database as JSON
python3 scripts/netmap.py export

# Continuous watch mode (scans every 2min by default)
python3 scripts/netmap.py watch
python3 scripts/netmap.py watch --interval 60

Notes#

• MAC addresses and vendor info require running with sudo (or they appear blank without it)
• Deep scan adds port-based device fingerprinting: identifies printers, NAS, SSH servers, Apple devices, etc.
• Device database persists across scans — labels survive rescans
• Subnet is auto-detected from the machine's default interface
• Run scan --deep first time to populate device types, then scan for fast refreshes