How ramonvermeulen/whosthere works
Whosthere discovers and enriches LAN devices, then presents results through an interactive terminal UI or a single-scan CLI; daemon mode exposes live device data over HTTP. The main discovery path configures concurrent mDNS, SSDP, and ARP scanners plus an optional subnet sweeper, merging observations and looking up manufacturers. Other product branches include port scanning, persistent device aliases, YAML configuration, and theming. Relationships for unsampled capabilities are included only where documented by the README; source-level edges cite the available excerpts or index references.
Main entry points: engine_builder.go Engine builder · engine.go Discovery engine · cmd CLI commands · app.go Interactive TUI
Components 23
Commands and configuration
- CLI commands
internal/cmd - Configuration
internal/core/config - Daemon HTTP API
internal/cmd/daemon.go - Scan output
internal/core/output/output.go
LAN discovery
- Engine builder
internal/core/engine_builder.go - Discovery engine
pkg/discovery/engine.go - mDNS scanner
pkg/discovery/scanners/mdns/mdns.go - SSDP scanner
pkg/discovery/scanners/ssdp/ssdp.go - ARP scanner
pkg/discovery/scanners/arp/arp.go - Subnet sweeper
pkg/discovery/sweeper/sweeper.go - OUI enrichment
pkg/discovery/oui/oui.go - Port scanner
pkg/discovery/port_scanner.go
User experience and state
- Interactive TUI
internal/ui/app.go - Device state
internal/core/state/state.go - Device dashboard
internal/ui/views/dashboard.go - Device table
internal/ui/components/device_table.go - Device details
internal/ui/views/detail.go - Themes
internal/ui/theme/theme.go
Device metadata
- Alias import/export
internal/core/aliases/importer.go - Alias database
internal/core/devicemeta/bbolt_store.go
Other components
- Network operator
- Local network
- HTTP API client
Connections 36
- Network operator → CLI commands: runs
- CLI commands → Configuration: loads
internal/cmd/scan.go - CLI commands → Engine builder: builds engine
internal/cmd/scan.go - Engine builder → Discovery engine: configures
internal/core/engine_builder.go - Engine builder → mDNS scanner: registers
internal/core/engine_builder.go - Engine builder → SSDP scanner: registers
internal/core/engine_builder.go - Engine builder → ARP scanner: registers
internal/core/engine_builder.go - Engine builder → Subnet sweeper: configures
internal/core/engine_builder.go - Engine builder → OUI enrichment: initializes
internal/core/engine_builder.go - Discovery engine → mDNS scanner: runs concurrently
pkg/discovery/engine.go - Discovery engine → SSDP scanner: runs concurrently
pkg/discovery/engine.go - Discovery engine → ARP scanner: runs concurrently
pkg/discovery/engine.go - Discovery engine → Subnet sweeper: starts
pkg/discovery/engine.go - Discovery engine → OUI enrichment: enriches devices
pkg/discovery/engine.go - mDNS scanner → Local network: discovers devices
- SSDP scanner → Local network: discovers devices
- ARP scanner → Local network: reads ARP cache
- Subnet sweeper → Local network: probes subnet
- CLI commands → Scan output: formats results
internal/cmd/scan.go - CLI commands → Interactive TUI: starts TUI
internal/cmd/root.go - Interactive TUI → Discovery engine: starts scans
internal/ui/app.go - Interactive TUI → Device state: creates state
internal/ui/app.go - Interactive TUI → Device dashboard: shows views
internal/ui/app.go - Device dashboard → Device table: renders
internal/ui/views/dashboard.go - Device table → Device state: reads devices
internal/ui/components/device_table.go - Device details → Device state: reads selection
internal/ui/views/detail.go - Interactive TUI → Themes: applies theme
- Network operator → Daemon HTTP API: starts daemon
- Daemon HTTP API → Engine builder: builds engine
internal/cmd/daemon.go - Daemon HTTP API → Discovery engine: starts scans
internal/cmd/daemon.go - Daemon HTTP API → Device state: stores discoveries
internal/cmd/daemon.go - HTTP API client → Daemon HTTP API: requests devices
- CLI commands → Alias import/export: imports or exports
internal/cmd/aliases.go - Alias import/export → Alias database: reads and writes
internal/core/aliases/importer.go - Interactive TUI → Alias database: loads and saves aliases
internal/ui/app.go - Device details → Port scanner: requests scan