https://github.com/zaneschepke/wgtunnel

An alternative Android client app for WireGuard VPN
https://github.com/zaneschepke/wgtunnel

amnezia-vpn android apk f-droid f-droidrepos floss foss jetpack-compose kotlin vpn vpn-client wireguard wireguard-tunnel wireguard-ui wireguard-vpn

Last synced: 2 months ago
JSON representation

An alternative Android client app for WireGuard VPN

• Host: GitHub
• URL: https://github.com/zaneschepke/wgtunnel
• Owner: zaneschepke
• License: mit
• Created: 2023-05-24T05:14:12.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-09-18T03:29:20.000Z (4 months ago)
• Last Synced: 2024-09-18T09:53:29.548Z (4 months ago)
• Topics: amnezia-vpn, android, apk, f-droid, f-droidrepos, floss, foss, jetpack-compose, kotlin, vpn, vpn-client, wireguard, wireguard-tunnel, wireguard-ui, wireguard-vpn
• Language: Kotlin
• Homepage: https://zaneschepke.com/wgtunnel-docs
• Size: 3.28 MB
• Stars: 762
• Watchers: 12
• Forks: 42
• Open Issues: 57
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE
  • Code of conduct: .github/CODE_OF_CONDUCT.md
  • Security: SECURITY.md
  • Support: .github/SUPPORT.md

Awesome Lists containing this project

README

        


WG Tunnel





[![Discord](https://img.shields.io/badge/Discord-%235865F2.svg?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/rbRRNh6H7V)

[![X Community](https://img.shields.io/badge/X-000000?style=for-the-badge&logo=x&logoColor=white)](https://twitter.com/i/communities/1780655267685736818)

[![Telegram](https://img.shields.io/badge/Telegram-2CA5E0?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/wgtunnel)





[![Google Play](https://img.shields.io/badge/Google_Play-414141?style=for-the-badge&logo=google-play&logoColor=white)](https://play.google.com/store/apps/details?id=com.zaneschepke.wireguardautotunnel)

[![F-Droid](https://img.shields.io/static/v1?style=for-the-badge&message=F-Droid&color=1976D2&logo=F-Droid&logoColor=FFFFFF&label=)](https://f-droid.org/packages/com.zaneschepke.wireguardautotunnel/)





This is an alternative Android Application for [WireGuard](https://www.wireguard.com/)

and [AmneziaWG](https://docs.amnezia.org/documentation/amnezia-wg/) with added

features. Built using the [wireguard-android](https://github.com/WireGuard/wireguard-android)

library and [Jetpack Compose](https://developer.android.com/jetpack/compose), this application was

inspired by the official [WireGuard Android](https://github.com/WireGuard/wireguard-android) app.





## Screenshots



  

  

  

  





## Inspiration

The original inspiration for this app came from the inconvenience of having to manually turn VPN off

and on while on different networks. This app was created to offer a free solution to this problem.

## Features

* Add tunnels via .conf file, zip, manual entry, or QR code

* Auto connect to tunnels based on Wi-Fi SSID, ethernet, or mobile data

* Split tunneling by application with search

* WireGuard support for kernel and userspace modes

* Amnezia support for userspace mode for DPI/censorship protection

* Pre/Post Up/Down scripts support for all modes on a rooted device

* Always-On VPN support

* Export Amnezia and WireGuard tunnels to zip

* Quick tile support for tunnel toggling, auto-tunneling

* Static shortcuts support for tunnel toggling, auto-tunneling

* Intent automation support for all tunnels

* Automatic auto-tunneling service and/or tunnel restart after reboot or app update

* Battery preservation measures

* Restart tunnel on ping failure (beta)

## Fdroid

Want updates faster?

Check out my personal [fdroid repository](https://github.com/zaneschepke/fdroid) to get updates the

moment they are released.

## Docs

Information about features, behaviors, and answers to common questions can be found in the

app [documentation](https://zaneschepke.com/wgtunnel-docs/overview.html).

The repository for these docs can be found [here](https://github.com/zaneschepke/wgtunnel-docs).

## Translation

This app is using [Weblate](https://weblate.org) to assist with translations.

Help translate WG Tunnel into your language

at [Hosted Weblate](https://hosted.weblate.org/engage/wg-tunnel/).\

[![Translation status](https://hosted.weblate.org/widgets/wg-tunnel/-/multi-auto.svg)](https://hosted.weblate.org/engage/wg-tunnel/)

## Building

```

$ git clone https://github.com/zaneschepke/wgtunnel

$ cd wgtunnel

```

And then build the app:

```

$ ./gradlew assembleDebug

```

## Contributing

Any contributions in the form of feedback, issues, code, or translations are welcome and much

appreciated!

Please read

the [code of conduct](https://github.com/zaneschepke/wgtunnel?tab=coc-ov-file#contributor-code-of-conduct)

before contributing.