How okdunli/windows-hotspot-butler works
Windows Hotspot Butler is a Windows hotspot-management desktop application. The primary workflow runs from the user interface through the web backend to hotspot control, then gathers client and traffic data for device views and reporting. Separate capabilities provide guest access through a captive portal and LAN utilities such as file sharing and port forwarding. The graph also shows shared configuration, persistence, and Windows command layers. Source excerpts and the SOURCE INDEX support the listed links; several feature internals were not sampled, so their detailed interactions are omitted.
Main entry points: backend.py Web backend · hotspot.py Hotspot controller · deviceman.py Device manager · app.py Web UI host
Components 22
User interfaces
- Application entry
main.py - Web UI host
hotspot/webui/app.py - Web UI
hotspot/webui/ui/app.js - Web backend
hotspot/webui/backend.py - Tk interface
hotspot/ui/app.py - Tray and hotkey
hotspot/webui/tray.py
Hotspot control
- Hotspot controller
hotspot/core/hotspot.py - Wi-Fi capabilities
hotspot/core/wificaps.py - Network information
hotspot/core/netinfo.py - Windows commands
hotspot/core/pshell.py
Client and traffic management
- Device manager
hotspot/core/deviceman.py - Traffic accounting
hotspot/core/traffic.py - Profiles and history
hotspot/core/storage.py - Device identification
hotspot/core/oui.py
Guest access
- Captive portal
hotspot/core/portal.py - DNS interception
hotspot/core/captive.py - Welcome templates
hotspot/templates
LAN utilities and settings
- Configuration
hotspot/core/config.py - LAN file sharing
hotspot/core/share.py - Port forwarding
hotspot/core/portforward.py - Download speed test
hotspot/core/speedtest.py
Other components
- User
Connections 29
- User → Application entry: starts
README.md - Application entry → Web UI host: launches
main.py - Application entry → Tk interface: launches fallback
README.md - Web UI host → Web backend: hosts
hotspot/webui/app.py - Web UI host → Tray and hotkey: sets up
hotspot/webui/app.py - Web UI → Web backend: requests state and actions
- Web backend → Hotspot controller: controls
hotspot/webui/backend.py - Web backend → Device manager: manages clients
hotspot/webui/backend.py - Web backend → Traffic accounting: reads and exports
hotspot/webui/backend.py - Web backend → Captive portal: manages access
hotspot/webui/backend.py - Web backend → DNS interception: configures interception
hotspot/webui/backend.py - Web backend → LAN file sharing: controls
hotspot/webui/backend.py - Web backend → Port forwarding: controls
hotspot/webui/backend.py - Web backend → Download speed test: runs
hotspot/webui/backend.py - Hotspot controller → Wi-Fi capabilities: detects capabilities
hotspot/core/hotspot.py - Hotspot controller → Windows commands: runs commands
hotspot/core/hotspot.py - Hotspot controller → Network information: reads adapter info
hotspot/core/hotspot.py - Device manager → Network information: merges network data
hotspot/core/deviceman.py - Device manager → Device identification: identifies vendors
hotspot/core/deviceman.py - Device manager → Profiles and history: reads and updates profiles
hotspot/core/deviceman.py - Device manager → Traffic accounting: uses traffic data
hotspot/core/deviceman.py - Traffic accounting → Profiles and history: persists accounting
hotspot/core/traffic.py - Captive portal → Profiles and history: records acceptances
hotspot/core/portal.py - Captive portal → Welcome templates: renders
README.md - DNS interception → Captive portal: routes guests
hotspot/core/captive.py - LAN file sharing → User: serves LAN files
README.md - Port forwarding → Windows commands: configures portproxy
hotspot/core/portforward.py - Hotspot controller → Configuration: uses settings
hotspot/core/hotspot.py - Web UI host → Configuration: loads UI settings
hotspot/webui/app.py