Skip to content
This repository was archived by the owner on Feb 13, 2026. It is now read-only.
 
 

Repository files navigation

Android GUI for WireGuard with wstunnel support

A soft fork of wireguard-android.

Warning

The actual WSTunnel functionality doesn't work right now because of Android constraints. I haven't been able to figure out how to allow the app to run wstunnel binary in production.

Probably won't fix it now because I don't even need the app anymore :)

This sucked

This is an Android GUI for WireGuard. It opportunistically uses the kernel implementation, and falls back to using the non-root userspace implementation.

This fork enables tunneling traffic through wstunnel to avoid some regional blockings.

Building

$ git clone --recurse-submodules https://git.zx2c4.com/wireguard-android
$ cd wireguard-android
$ ./gradlew assembleRelease

macOS users may need flock(1).

Embedding

The tunnel library is on Maven Central, alongside extensive class library documentation.

implementation 'com.wireguard.android:tunnel:$wireguardTunnelVersion'

The library makes use of Java 8 features, so be sure to support those in your gradle configuration with desugaring:

compileOptions {
    sourceCompatibility JavaVersion.VERSION_17
    targetCompatibility JavaVersion.VERSION_17
    coreLibraryDesugaringEnabled = true
}
dependencies {
    coreLibraryDesugaring "com.android.tools:desugar_jdk_libs:2.0.3"
}

Translating

Please help us translate the app into several languages on our translation platform.

About

Android GUI for WireGuard with Web Socket Tunnel support

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages