How gyuri1999/netwatch works
NetWatch is a network-monitoring and security product: a sensor captures live traffic, detects suspicious activity, and serves a dashboard with alerts, history, and investigation tools. The README also documents active network tests, learning/CTF features, and an Android alert companion. The graph preserves these product branches; edges are limited to relationships shown in excerpts, the SOURCE INDEX, or README. Several feature modules are unsampled, so their internal connections are not inferred.
Main entry points: server.py HTTP and SSE server · capture.py Traffic capture · AlertWorker.kt Alert polling · SetupActivity.kt Agent setup
Components 24
Capture and detection
- Traffic capture
capture.py - Detection engine
detect.py - Shared config and helpers
core.py - Threat feeds and history
storage.py
Dashboard and response
- HTTP and SSE server
server.py - Web dashboard
sw.js
Network investigation
- Security audit
assess.py - Pentest toolkit
pentest.py - Scan reports
pentest_report.py - Network tools
netkit.py - Network triage
nettriage.py - Operations tools
ops.py - Threat hunting
hunt.py - Wireshark notes
netdocs.py
Learning and labs
- PCAP CTF
ctf.py - Learning academy
academy/engine.js
Companion clients
- Agent setup
android/app/src/main/java/io/github/netwatch/android/SetupActivity.kt - Pinned agent client
android/app/src/main/java/io/github/netwatch/android/AgentClient.kt - Companion settings
android/app/src/main/java/io/github/netwatch/android/Store.kt - Alert polling
android/app/src/main/java/io/github/netwatch/android/AlertWorker.kt - Dashboard WebView
android/app/src/main/java/io/github/netwatch/android/MainActivity.kt - Mobile notifications
android/app/src/main/java/io/github/netwatch/android/Notifier.kt
Other components
- Network operator
- NetWatch agent
Connections 25
- Network operator → HTTP and SSE server: uses dashboard
- Traffic capture → Detection engine: feeds packets
capture.py - Traffic capture → Threat feeds and history: uses history
capture.py - Traffic capture → Shared config and helpers: uses helpers
capture.py - Traffic capture → PCAP CTF: supports replay labs
capture.py - HTTP and SSE server → Traffic capture: routes monitoring
server.py - HTTP and SSE server → Security audit: routes audit
server.py - HTTP and SSE server → Pentest toolkit: routes scans
server.py - HTTP and SSE server → Network tools: routes tools
server.py - HTTP and SSE server → Network triage: routes triage
server.py - HTTP and SSE server → Operations tools: routes operations
server.py - HTTP and SSE server → Threat hunting: routes hunting
server.py - HTTP and SSE server → PCAP CTF: routes CTF
server.py - HTTP and SSE server → Web dashboard: serves interface
- Pentest toolkit → Scan reports: exports reports
- Network operator → Learning academy: studies networking
- Network operator → Agent setup: configures companion
- Agent setup → Pinned agent client: checks fingerprint and status
android/app/src/main/java/io/github/netwatch/android/SetupActivity.kt - Agent setup → Companion settings: saves agent config
android/app/src/main/java/io/github/netwatch/android/SetupActivity.kt - Dashboard WebView → Companion settings: reads settings
android/app/src/main/java/io/github/netwatch/android/MainActivity.kt - Dashboard WebView → Alert polling: schedules polling
android/app/src/main/java/io/github/netwatch/android/MainActivity.kt - Alert polling → Companion settings: reads and updates state
android/app/src/main/java/io/github/netwatch/android/AlertWorker.kt - Alert polling → Pinned agent client: fetches status
android/app/src/main/java/io/github/netwatch/android/AlertWorker.kt - Alert polling → Mobile notifications: shows alerts
android/app/src/main/java/io/github/netwatch/android/AlertWorker.kt - Pinned agent client → NetWatch agent: polls status
android/app/src/main/java/io/github/netwatch/android/AgentClient.kt