core

Implements a WireGuard VPN tunnel backend: lifecycle management, configuration parsing, connection handling, secure key management, monitoring and diagnostics for client applications.

#parsing
#network
#debug

Suggest an edit

Android

JVM

GitHub stars3

Authorswgtunnel

Dependents0

LicenseMIT License

Creation date26 days ago

Last activityabout 10 hours ago

Latest release1.5.0 (3 days ago)

Homepage GitHub repository

WG Tunnel Core

The shared backend used by the WG Tunnel apps: WireGuard / AmneziaWG config parsing, tunnel orchestration, tunnel recovery, DNS bootstrap, and native JNI.

Modules

Artifact	Description
`com.wgtunnel:parser`	WireGuard / AmneziaWG conf parser (JVM)
`com.wgtunnel:backend`	Kotlin Multiplatform tunnel backend (pulls the Android or JVM variant)
`com.wgtunnel:backend-android`	Android variant of the backend
`com.wgtunnel:backend-jvm`	JVM / desktop variant of the backend
`com.wgtunnel:backend-android-jni`	AmneziaWG userspace + JNI
`com.wgtunnel:hevtunnel`	hev-socks5-tunnel JNI for lockdown / kill switch

Requirements

Install these before a source build.

JDK 21
Git
make
Android SDK
Android NDK
C toolchain
MinGW-w64
On Linux and macOS, flock

Go toolchain is downloaded and patched.

Build

From the repo root:

./gradlew build

Format Kotlin:

./gradlew format

Using the libraries

repositories {
    mavenCentral()
}

dependencies {
    implementation("com.wgtunnel:parser:<version>")
    implementation("com.wgtunnel:backend:<version>")
    // Android
    implementation("com.wgtunnel:backend-android-jni:<version>")
    implementation("com.wgtunnel:hevtunnel:<version>")
}

Replace <version> with the latest Maven Central version.

License

MIT. See LICENSE and NOTICE for third-party components (AmneziaWG, hev-socks5-tunnel, Tailscale-derived desktop firewall/router).