How maeneko/senamneziawg works
SenAWG is a cross-platform Electron client for WireGuard and AmneziaWG VPNs. A user imports a VPN or SenAmnesia link, the main process parses it and stores tunnel or subscription data, then the tunnel manager connects through a platform-specific privileged backend; state and logs return to the renderer. The README also documents profile/subscription management, diagnostics, updates, setup and uninstall. Several platform and UI modules were not sampled, so their documented capabilities are shown without speculative call chains.
Main entry points: index.ts Electron main · App.tsx SenAWG window · manager.ts Subscription manager · macosScriptController.ts macOS controller
Components 31
User interface
- SenAWG window
src/renderer/src/App.tsx - IPC bridge
src/preload/index.ts - Tunnel views
src/renderer/src/components/TunnelViews.tsx - Profile view
src/renderer/src/components/ProfileView.tsx - Settings view
src/renderer/src/components/SettingsView.tsx - Logs view
src/renderer/src/components/LogsView.tsx
Application services
- Electron main
src/main/index.ts - VPN link parser
src/main/config/vpnLink.ts - Sen link parser
src/main/config/senLink.ts - Tunnel config
src/main/config/wgConfig.ts - Config conversion
src/main/config/wgConf.ts - Subscription manager
src/main/sen/manager.ts - Sen API client
src/main/sen/client.ts - Tunnel store
src/main/store.ts - Subscription store
src/main/sen/store.ts - Application logger
src/main/logger.ts - Update service
src/main/update/updater.ts
Tunnel runtime
- Tunnel manager
src/main/tunnel/manager.ts - Controller interface
src/main/tunnel/TunnelController.ts - Protocol versions
src/shared/awgVersion.ts - UAPI transport
src/main/tunnel/uapi.ts - UAPI config
src/main/tunnel/uapiConfig.ts - macOS controller
src/main/tunnel/macosScriptController.ts - macOS service
src/main/tunnel/macos/service.ts
Privileged helpers
- Windows helper client
src/main/tunnel/windows/helperClient.ts - Helper protocol
src/main/tunnel/windows/protocol.ts - Platform helper
helper/dispatch.go - AmneziaWG engine
Other components
- User
- Host operating system
- SenAmnesia service
Connections 36
- User → SenAWG window: uses
- SenAWG window → Tunnel views: renders
src/renderer/src/App.tsx - SenAWG window → Profile view: renders
src/renderer/src/App.tsx - SenAWG window → Settings view: renders
src/renderer/src/App.tsx - SenAWG window → Logs view: renders
src/renderer/src/App.tsx - SenAWG window → IPC bridge: invokes bridge
- IPC bridge → Electron main: sends IPC
- Electron main → VPN link parser: parses VPN links
src/main/index.ts - Electron main → Sen link parser: checks Sen links
src/main/index.ts - Electron main → Tunnel config: parses VPN config
src/main/index.ts - Electron main → Subscription manager: coordinates subscriptions
src/main/index.ts - Electron main → Tunnel manager: manages tunnels
src/main/index.ts - Electron main → Tunnel store: reads and removes
src/main/index.ts - Electron main → Application logger: logs events
src/main/index.ts - Subscription manager → Sen link parser: decodes links
src/main/sen/manager.ts - Subscription manager → Sen API client: requests service
src/main/sen/manager.ts - Subscription manager → Tunnel store: reads and updates
src/main/sen/manager.ts - Subscription manager → Subscription store: reads subscriptions
src/main/sen/manager.ts - Subscription manager → Tunnel config: applies tunnel config
- Tunnel manager → Tunnel store: loads tunnels
src/main/tunnel/manager.ts - Tunnel manager → Controller interface: controls tunnel
src/main/tunnel/manager.ts - Tunnel manager → Protocol versions: detects protocol
src/main/tunnel/manager.ts - macOS controller → Controller interface: implements operations
src/main/tunnel/macosScriptController.ts - macOS controller → UAPI transport: requests stats
src/main/tunnel/macosScriptController.ts - macOS controller → UAPI config: builds tunnel config
src/main/tunnel/macosScriptController.ts - macOS controller → Protocol versions: detects protocol
src/main/tunnel/macosScriptController.ts - macOS controller → Host operating system: runs privileged commands
src/main/tunnel/macosScriptController.ts - macOS service → Host operating system: installs service
src/main/tunnel/macos/service.ts - Windows helper client → Helper protocol: encodes requests
src/main/tunnel/windows/helperClient.ts - Windows helper client → Platform helper: requests over pipe
src/main/tunnel/windows/helperClient.ts - Platform helper → Host operating system: controls networking
- Host operating system → AmneziaWG engine: runs VPN engine
- Sen API client → SenAmnesia service: calls service
- Electron main → Update service: handles updates
- SenAWG window → Update service: shows update state
- Tunnel config → Config conversion: normalizes config
src/main/config/wgConf.ts