ShizuStore

WG Tunnel Nightly (WG Tunnel)

wgtunnel

5.7.5-nightly+git.6829d1e · GitHub

Download APK
Network Android 8.0+ 1 month ago MIT
22 ShizuStore
355.5k GitHub
3.4k Stars
55 MB Size

More about this app

A FOSS Android client for WireGuard and AmneziaWG with auto-tunneling.

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

Zapstore Google Play IzzyOnDroid WG Tunnel F-Droid Obtainium GitHub

Community

Telegram Matrix

Screenshots

Main Config Settings Auto-tunnel

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:

  1. In settings.gradle.kts, uncomment the local-dev includeBuild:
// 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"))
	}
}
  1. Build from android/:
./gradlew assembleDebug

Please restore the commented includeBuild before opening a PR.

Translation

Help translate WG Tunnel on Crowdin.

logo
Zane Schepke
(zaneschepke)

249913 words
logo
Marco Martinelli
(martinellimarco)

4792 words
logo
Petr Sedl
(Pida88)

2211 words
logo
Matthaiks

2005 words
logo
Surfoo

1984 words
logo
solokot

1254 words
logo
Evan Huang
(EvanTechDev)

1120 words
logo
Ali Saeedi
(alis36)

1050 words
logo
그냥기여자
(justcontributor)

965 words
logo
LEDPixel

950 words
logo
CyanWolf
(cyanwolfg)

891 words
logo
Den
(tehb29)

460 words
logo
pixnet

378 words
logo
ron
(zlronron159)

320 words
logo
Philip
(ppac)

273 words
logo
YuryKomar

271 words
logo
TrainsLater

265 words
logo
georgybog

257 words
logo
Dariusz
(darbrzozo)

125 words

Acknowledgements

Thank you to the following:

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.

Close

How Shizuku is used

Can detect connected Wi-Fi names for auto-tunneling via `cmd wifi status` through Shizuku.

This is an AI-assisted analysis of Shizuku-related usages in the app's public source code. It is best effort, so it may not catch every single usage.

How this app uses Shizuku

Shizuku is used as an optional Wi-Fi detection method to support auto-tunneling without location access.

  • Detect Wi-Fi networks: when the Shizuku detection method is selected, the app runs the cmd wifi status shell command through Shizuku to read the current Wi-Fi name and hardware address, which auto-tunneling uses to decide when to start or stop tunnels.

Android APIs or commands used

  • cmd wifi status

Notable details

Shizuku Wi-Fi detection is one selectable option alongside the system default and legacy methods, so the app can still detect networks without Shizuku when another method is chosen. Unlike the system methods, the Shizuku method does not require location permissions.

Close

Changelog

What's new for version 5.7.5-nightly+git.6829d1e

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

  • 4292957 - update screenshots (commit by @zaneschepke)
  • 4d0ca4f - delete old support.md (commit by @zaneschepke)
  • 2e75aaa - deps: bump gradle wrapper to 9.8.1 (commit by @zaneschepke)
  • db07ccd - release 5.8.2 (commit by @zaneschepke)
Close

Permissions

23 permissions requested

  • android.permission.REQUEST_INSTALL_PACKAGES
  • android.permission.INTERNET
  • android.permission.POST_NOTIFICATIONS
  • android.permission.POST_PROMOTED_NOTIFICATIONS
  • android.permission.WRITE_EXTERNAL_STORAGE
  • android.permission.QUERY_ALL_PACKAGES
  • android.permission.FOREGROUND_SERVICE_SPECIAL_USE
  • android.permission.FOREGROUND_SERVICE
  • android.permission.REQUEST_IGNORE_BATTERY_OPTIMIZATIONS
  • android.permission.RECEIVE_BOOT_COMPLETED
  • android.permission.ACCESS_WIFI_STATE
  • android.permission.ACCESS_COARSE_LOCATION
  • android.permission.ACCESS_FINE_LOCATION
  • android.permission.ACCESS_BACKGROUND_LOCATION
  • android.permission.ACCESS_NETWORK_STATE
  • android.permission.ACCESS_LOCAL_NETWORK
  • android.permission.SCHEDULE_EXACT_ALARM
  • android.permission.FOREGROUND_SERVICE_SYSTEM_EXEMPTED
  • android.permission.CAMERA
  • android.permission.WAKE_LOCK
  • com.zaneschepke.wireguardautotunnel.nightly.DYNAMIC_RECEIVER_NOT_EXPORTED_PERMISSION
  • moe.shizuku.manager.permission.API_V23
  • android.permission.READ_EXTERNAL_STORAGE
Close

Sources

3 sources

5.7.5-nightly+git.6829d1e Universal GitHub · com.zaneschepke.wireguardautotunnel.nightly
Selected Download
5.7.5-nightly+git.6829d1e arm64-v8a GitHub · com.zaneschepke.wireguardautotunnel.nightly
Download
5.7.5-nightly+git.6829d1e armeabi-v7a GitHub · com.zaneschepke.wireguardautotunnel.nightly
Download