How meteadam/pairvpn-controller works
PairVPN Watchdog is a Windows desktop utility that monitors the PairVPN tunnel and quarantines the physical carrier connection when probes fail. The principal flow is adapter discovery, bound tunnel probing, watchdog/alarm handling, then adapter and firewall containment; users can restore connectivity, restart PairVPN, or optionally manage WireSock split tunneling. The main runtime is a monolith, so multiple components share its source path. Edges rely on the README’s architecture and capability descriptions plus the shown calls; unsampled implementation details are not asserted.
Main entry points: pairvpn_watchdog.py Controller UI · config.json Watchdog Settings
Components 17
User Interface
- Controller UI
pairvpn_watchdog.py - Watchdog Settings
config.json
Tunnel Monitoring
- Adapter Discovery
pairvpn_watchdog.py - Tunnel Probes
pairvpn_watchdog.py - Watchdog State
pairvpn_watchdog.py - Alarm Countdown
pairvpn_watchdog.py
Network Protection
- DNS MTU Optimizer
pairvpn_watchdog.py - Kill-Switch
pairvpn_watchdog.py - Carrier Adapter
- Windows Firewall
- Network Restore
pairvpn_watchdog.py - PairVPN Restart
pairvpn_watchdog.py
Optional Integrations
- WireSock Manager
pairvpn_watchdog.py - WireSock Profile
Other components
- Windows User
- PairVPN Tunnel
- WireSock Service
Connections 18
- Windows User → Controller UI: uses
README.md - Controller UI → Watchdog Settings: loads settings
pairvpn_watchdog.py - Controller UI → Watchdog State: starts monitoring
pairvpn_watchdog.py - Watchdog State → Adapter Discovery: discovers adapters
README.md - Watchdog State → Tunnel Probes: checks tunnel
README.md - Tunnel Probes → PairVPN Tunnel: probes through
README.md - Watchdog State → Alarm Countdown: starts countdown
README.md - Watchdog State → DNS MTU Optimizer: optimizes when healthy
README.md - Alarm Countdown → Kill-Switch: triggers on expiry
README.md - Kill-Switch → Carrier Adapter: disables
README.md - Kill-Switch → Windows Firewall: blocks outbound
README.md - Controller UI → Network Restore: offers recovery
README.md - Network Restore → Carrier Adapter: re-enables
README.md - Network Restore → Windows Firewall: removes block
README.md - Controller UI → PairVPN Restart: offers restart
README.md - Controller UI → WireSock Manager: manages optionally
pairvpn_watchdog.py - WireSock Manager → WireSock Profile: syncs profile
README.md - WireSock Manager → WireSock Service: controls tunnel
README.md