Security & Privacy · Open source

WGControl

FadeFX

Automated WireGuard tunnel control via home Wi-Fi and Bluetooth.

Download

Opens the official F-Droid page

WGControl screenshot 1WGControl screenshot 2WGControl screenshot 3

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.

What's new in 1.47.61910

- New: manage several WireGuard tunnels, with per-Wi-Fi-network assignment ("Configured Networks") and separate default tunnels for Wi-Fi, mobile data, and roaming - New: home screen widget with status, current network, active tunnel, Bluetooth info, and the same pause buttons as the notification; adapts to widget size (abbreviated labels/icon buttons when narrow), background style and opacity configurable - Changed: Quick Settings tile long-press now opens the app (Status tab) instead of the sy

How to install WGControl

  1. Tap Download — the app's official page on F-Droid opens.
  2. Install it with the F-Droid app (recommended, for automatic updates), or use the download button on that page.
  3. If Android asks, allow the F-Droid app or your browser to install apps, then tap Install.
  4. Open WGControl from your app drawer.

More security & privacy apps

More