WG Tunnel
Featuredv5.7.5-nightly+git.6829d1eScreenshots
(9)About Application
WG Tunnel
WG Tunnel is an Android client for WireGuard and AmneziaWG, inspired by the official WireGuard Android app. It adds advanced features like auto-tunneling, tunnel-in-a-tunnel multihop, lockdown (a tunnel-independent kill switch), local proxying (a local SOCKS5/HTTP proxy), and many more!
Get the app
Community
Screenshots
Features
- Auto-Tunneling: Automatically activate tunnels based on your device's active network details.
- Deferred Endpoint Bootstrapping: Safely resolves endpoints and updates peers after the tunnel is up for better reliability and leak protection on startup.
- Multihop: Tunnel through another tunnel so traffic passes through more than one hop.
- Handshake Monitoring: Real-time handshake monitoring for tunnel health feedback.
- AmneziaWG Support: Full support for AmneziaWG 2.0 through 3.1, providing robust censorship protection.
- Split Tunneling: Flexible support for routing specific apps or traffic through the VPN.
- Split & Encrypted DNS: Resolve DNS through the tunnel using plain DNS, DoT, or DoH, and optionally split by domain suffix (tunnel or system).
- Local Proxy Mode: Expose WireGuard tunnels over a local SOCKS5 or HTTP proxy to browsers or firewall apps (like AdGuard).
- Lockdown Mode: Advanced in-app kill switch that blocks all traffic while the tunnel is down.
- Quick Controls: Quick Settings tile and home screen shortcuts for easy toggling.
- Remote Control Support: Intent-based automation for controlling tunnels and auto-tunneling from automation apps (like Tasker).
- Dynamic DNS Handling: Automatically detect and update endpoints on server IP changes without requiring a restart.
- IPv6 Endpoints: Automatically upgrade to IPv6 endpoints or fall back to IPv4 based on network conditions without requiring a restart.
- Android TV Support: Full support for nearly all features on Android TV.
Building
App build
git clone https://github.com/wgtunnel/android cd android ./gradlew assembleDebug
Full build (app + core)
To build against a local core (native JNI, backend, parser, hevtunnel), clone core next to this repo:
parent/ android/ # this repository core/ # https://github.com/wgtunnel/core
cd /path/to/parent git clone https://github.com/wgtunnel/android git clone https://github.com/wgtunnel/core cd android
You also need the core build requirements (JDK 21, Android NDK, make, a C toolchain).
Then switch Gradle from Maven Central to the composite build:
- In
settings.gradle.kts, uncomment the local-devincludeBuild:
// Local dev includeBuild("../core") { dependencySubstitution { substitute(module("com.wgtunnel:backend")) .using(project(":backend")) substitute(module("com.wgtunnel:backend-android")) .using(project(":backend")) substitute(module("com.wgtunnel:backend-android-jni")) .using(project(":backend-android-jni")) substitute(module("com.wgtunnel:hevtunnel")) .using(project(":hevtunnel")) substitute(module("com.wgtunnel:parser")) .using(project(":parser")) } }
- Build from
android/:
./gradlew assembleDebug
Please restore the commented includeBuild before opening a PR.
Translation
Help translate WG Tunnel on Crowdin.
|
Zane Schepke (zaneschepke) 249913 words |
Marco Martinelli (martinellimarco) 4792 words |
Petr Sedl (Pida88) 2211 words |
Matthaiks 2005 words |
Surfoo 1984 words |
solokot 1254 words |
Evan Huang (EvanTechDev) 1120 words |
|
Ali Saeedi (alis36) 1050 words |
그냥기여자 (justcontributor) 965 words |
LEDPixel 950 words |
CyanWolf (cyanwolfg) 891 words |
Den (tehb29) 460 words |
pixnet 378 words |
ron (zlronron159) 320 words |
|
Philip (ppac) 273 words |
YuryKomar 271 words |
TrainsLater 265 words |
georgybog 257 words |
Dariusz (darbrzozo) 125 words |
Acknowledgements
Thank you to the following:
- All of the users that have helped contribute to the project with ideas, translations, feedback, bug reports, testing, and donations.
- WireGuard - Jason A. Donenfeld (https://github.com/WireGuard/wireguard-android)
- AmneziaWG - Amnezia Team (https://github.com/amnezia-vpn/amneziawg-android)
- JetBrains - For supporting open-source developers with free software licenses.
Contributing
Any contributions in the form of feedback, issues, code, or translations are welcome and much appreciated!
For PRs, please make sure to format before submitting.
./gradlew format
CI runs ./gradlew formatCheck, which uses the same files and style as format. If that job fails, run ./gradlew format and commit the result.
If your PR requires core changes, please link the associated PR.
Release Notes & Changelog
What's new:
- Dynamic AMOLED theme
- Ping servers from main screen while no tunnel is active
- Bugfixes for Android TV file imports
- Bugfixes for split tunnel configuration changes
- Bugfixes for backup/restore, with TV support
- Various other minor improvements and fixes
SHA-256 fingerprints for the 4096-bit signing certificate:
5204d82e766e8aa14dcbb06dc70aebae2bdd812d4d6203cd521a8a685d7d3d80
To verify fingerprint:
apksigner verify --print-certs [path to APK file] | grep SHA-256
Changelog
:sparkles: New Features
3308c60- lang: update/complete Basque (eu) and Spanish (es) translations (PR #1528 by @planetryan)499eaa4- add server ping to main screen (commit by @zaneschepke)d0fbe71- add AMOLED dynamic theme (commit by @zaneschepke)37e25fe- lang: New Crowdin updates (PR #1517 by @zaneschepke)
:bug: Bug Fixes
f8c8850- split tunneling configuration stale saves, UX improvements (commit by @zaneschepke)e247010- tv: file importing (commit by @zaneschepke)14a0493- db backup crash, Android TV support, error handling (commit by @zaneschepke)
:recycle: Refactors
f7230b5- ui: add description for trusted networks (commit by @zaneschepke)4cd5839- ui: remote key rotation and docs link (commit by @zaneschepke)93b2dcc- ui: improve standalone download progress indicator (commit by @zaneschepke)
:wrench: Chores
Declared Android Permissions
23 totalShizuku API Permissions
This application connects to the Shizuku service to execute system-level operations with ADB elevated privileges.
Standard Android Permissions
Specifications
Install via ShizuStore to enable automatic updates and silent installations using Shizuku.
More in Network
Other applications in this category