WGControl

org.supersane.wgcontrol
by Zapstore Catalog

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

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.

First release: Nov 3, 2026, 1 total release.

Most recent release: Nov 3, 2026.

Repo

Appears in 0 app stacks.

0 sats / 0 zaps received in the past year.

Sats Received

Underlying data available via MCP: app_zaps, app_releases.

Zap Count

Underlying data available via MCP: app_zaps, app_releases.

Releases

  • Nov 3, 2026 WGControl-1.48.60311
    Version 1.48 Changelog EN * New: wireless Android Auto head units are now recognized automatically (via their Bluetooth service UUID) and added to the trigger list without asking (with an info notification; details in the log); for all other new devices the "Is this Android Auto?" prompt remains * Changed: the app's notifications (status, Bluetooth prompt, "device added") now use a "WG" logo as small icon instead of a generic system lock icon, which looked different depending on the device manufacturer * Changed: the Status tab now warns about missing permissions - location (including "Allow all the time", which is also required for the automatic start after a reboot; the nearby Wi-Fi devices permission no longer counts as a replacement), control WireGuard tunnels, notifications, and Bluetooth if Bluetooth monitoring is on - as well as "Restricted" background usage, with buttons to fix them; active battery optimization and "Pause app activity if unused" are shown in the same card, which then turns orange instead of red as they are less urgent (the buttons of the "Reliable Background Detection" card moved into this warning) * New: the Status tab has a button to the discussion thread on the XDA Forums * New: failed service starts (e.g. after a reboot) are now written to the log with the reason * New: AmneziaWG tunnels can now be controlled as well - when adding a tunnel in Settings you choose whether it lives in the WireGuard or the AmneziaWG app (org.amnezia.awg); everything else (per-Wi-Fi assignment, default tunnels, pause, backup) works the same for both, and the Status tab warns if the AmneziaWG control permission is missing * Changed: the release build is now shrunk and optimized with R8, which makes the APK smaller
    More…
    Changelog DE * Neu: Wireless-Android-Auto-Geräte werden jetzt automatisch (über ihre Bluetooth-Service-UUID) erkannt und ohne Nachfrage in die Trigger-Liste eingetragen (mit Info-Benachrichtigung, Details im Protokoll); bei allen anderen neuen Geräten bleibt die Nachfrage "Ist das Android Auto?" bestehen * Geändert: Die Benachrichtigungen der App (Status, Bluetooth-Nachfrage, "Gerät hinzugefügt") verwenden jetzt ein "WG"-Logo als kleines Icon statt eines generischen System-Schloss-Icons, das je nach Gerätehersteller unterschiedlich aussah * Geändert: Der Status-Tab warnt jetzt vor fehlenden Berechtigungen - Standort (einschließlich "Immer zulassen", das auch für den automatischen Start nach einem Neustart nötig ist; die Berechtigung für Wi-Fi-Geräte in der Nähe gilt nicht mehr als Ersatz), WireGuard-Tunnel steuern, Benachrichtigungen und Bluetooth, falls die Bluetooth-Überwachung aktiv ist - sowie "Eingeschränkte" Hintergrundnutzung, mit Buttons zum Beheben; aktive Akku-Optimierung und "App-Aktivität pausieren, wenn nicht genutzt" werden in derselben Karte angezeigt, die dann orange statt rot ist, da sie weniger dringend sind (die Buttons der Karte "Zuverlässige Hintergrund-Erkennung" sind in diese Warnung gewandert) * Neu: Der Status-Tab hat einen Button zum Diskussions-Thread im XDA-Forum * Neu: Fehlgeschlagene Dienststarts (z. B. nach einem Neustart) werden jetzt mit Ursache ins Protokoll geschrieben * Neu: AmneziaWG-Tunnel können jetzt ebenfalls gesteuert werden - beim Hinzufügen eines Tunnels in den Einstellungen wählst du, ob er in der WireGuard- oder der AmneziaWG-App (org.amnezia.awg) liegt; alles andere (WLAN-Zuordnung, Standard-Tunnel, Pause, Backup) funktioniert für beide gleich, und der Status-Tab warnt, falls die AmneziaWG-Steuerungsberechtigung fehlt * Geändert: Der Release-Build wird jetzt mit R8 verkleinert und optimiert, die APK wird dadurch kleiner