WGControl
Automated WireGuard tunnel control via home Wi-Fi and Bluetooth.
org.supersane.wgcontrol
About WGControl
WGControl automatically manages your WireGuard tunnel based on your Wi-Fi and Bluetooth connections. It disables the tunnel when connected to your configured home Wi-Fi or selected Bluetooth devices (e.g., Android Auto) and re-enables it upon leaving.
This app is a VibeCode product. I have thoroughly tested all functions and believe everything works reliably.
However, I assume no responsibility for errors, results of errors, or atomic fallout.
Key Features:
- Wi-Fi & Bluetooth Detection: Automatically toggles the tunnel based on home networks or paired Bluetooth devices.
- Real-Time Monitoring: Continuously checks system-level VPN status and enforces the target state.
- Ping Connectivity Check (optional, off by default): Verifies internet availability via ICMP/TCP ping to a configurable host (example.com by default) before re-enabling the tunnel.
- Notification Pause Buttons: Manually override the tunnel from the status notification - indefinitely or for a configurable duration - without opening the app.
- Admin Password Protection: Secures configuration tabs using salted PBKDF2 hashing.
- Local Logging: Tracks tunnel commands and network events locally for up to 24 hours with search and export capabilities.
- QuickSettings Tiles and widget to control pause.
Essential Setup Steps:
1. WireGuard App: Enable "Allow user-controlled tunnel management" in settings.
2. Grant Permission: Allow "WireGuard tunnel control" permission.
3. Location Access: Set to "Allow all the time" for background Wi-Fi detection.
4. Battery Optimization: Disable for BOTH WGControl and the WireGuard app.
Note: Not affiliated with WireGuard or Jason A. Donenfeld. Controls the official WireGuard app via its public broadcast interface.