Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/emtee40/wireguard-android
Imported from https://git.zx2c4.com/wireguard-android
https://github.com/emtee40/wireguard-android
vpn vpn-client vpn-tunnel wireguard wireguard-android wireguard-tunnel wireguard-vpn
Last synced: about 2 months ago
JSON representation
Imported from https://git.zx2c4.com/wireguard-android
- Host: GitHub
- URL: https://github.com/emtee40/wireguard-android
- Owner: emtee40
- License: apache-2.0
- Created: 2022-07-12T14:43:54.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2022-07-12T14:50:33.000Z (over 2 years ago)
- Last Synced: 2023-03-11T10:08:23.873Z (almost 2 years ago)
- Topics: vpn, vpn-client, vpn-tunnel, wireguard, wireguard-android, wireguard-tunnel, wireguard-vpn
- Language: Kotlin
- Homepage: https://www.wireguard.com
- Size: 2.28 MB
- Stars: 2
- Watchers: 1
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: COPYING
Awesome Lists containing this project
README
# Android GUI for [WireGuard](https://www.wireguard.com/)
**[Download from F-Droid](https://f-droid.org/en/packages/com.wireguard.android/)**
This is an Android GUI for [WireGuard](https://www.wireguard.com/). It [opportunistically uses the kernel implementation](https://git.zx2c4.com/android_kernel_wireguard/about/), and falls back to using the non-root [userspace implementation](https://git.zx2c4.com/wireguard-go/about/).
## Building
```
$ git clone --recurse-submodules https://git.zx2c4.com/wireguard-android
$ cd wireguard-android
$ ./gradlew assembleRelease
```macOS users may need [flock(1)](https://github.com/discoteq/flock).
## Embedding
The tunnel library is [on Maven Central](https://search.maven.org/artifact/com.wireguard.android/tunnel), alongside [extensive class library documentation](https://javadoc.io/doc/com.wireguard.android/tunnel).
```
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](https://developer.android.com/studio/write/java8-support#library-desugaring):
```
compileOptions {
sourceCompatibility JavaVersion.VERSION_1_8
targetCompatibility JavaVersion.VERSION_1_8
coreLibraryDesugaringEnabled = true
}
dependencies {
coreLibraryDesugaring "com.android.tools:desugar_jdk_libs:1.1.5"
}
```## Translating
Please help us translate the app into several languages on [our translation platform](https://crowdin.com/project/WireGuard).