{"id":46788569,"url":"https://github.com/wgtunnel/android","last_synced_at":"2026-06-13T06:05:00.181Z","repository":{"id":172632872,"uuid":"644710160","full_name":"wgtunnel/android","owner":"wgtunnel","description":"A FOSS WireGuard \u0026 AmneziaWG Android client with auto-tunneling, lockdown \u0026 proxying.","archived":false,"fork":false,"pushed_at":"2026-06-04T05:16:58.000Z","size":11209,"stargazers_count":2739,"open_issues_count":108,"forks_count":155,"subscribers_count":18,"default_branch":"master","last_synced_at":"2026-06-04T07:06:06.869Z","etag":null,"topics":["amnezia-vpn","android","apk","f-droid","f-droidrepos","floss","foss","http-proxy","jetpack-compose","kotlin","socks5-proxy","vpn","vpn-client","wireguard","wireguard-tunnel","wireguard-ui","wireguard-vpn"],"latest_commit_sha":null,"homepage":"https://wgtunnel.com","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wgtunnel.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":".github/SUPPORT.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"ko_fi":"zaneschepke","liberapay":"zaneschepke","github":"zaneschepke","custom":["https://wgtunnel.com/donate/"]}},"created_at":"2023-05-24T05:14:12.000Z","updated_at":"2026-06-04T05:17:02.000Z","dependencies_parsed_at":"2024-02-19T05:31:28.531Z","dependency_job_id":"1fc1c590-778a-44ae-948f-f3c8e7e9ff20","html_url":"https://github.com/wgtunnel/android","commit_stats":null,"previous_names":["zaneschepke/wgtunnel","wgtunnel/wgtunnel","wgtunnel/android"],"tags_count":132,"template":false,"template_full_name":null,"purl":"pkg:github/wgtunnel/android","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wgtunnel%2Fandroid","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wgtunnel%2Fandroid/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wgtunnel%2Fandroid/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wgtunnel%2Fandroid/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wgtunnel","download_url":"https://codeload.github.com/wgtunnel/android/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wgtunnel%2Fandroid/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34010556,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-07T02:00:07.652Z","response_time":124,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["amnezia-vpn","android","apk","f-droid","f-droidrepos","floss","foss","http-proxy","jetpack-compose","kotlin","socks5-proxy","vpn","vpn-client","wireguard","wireguard-tunnel","wireguard-ui","wireguard-vpn"],"created_at":"2026-03-10T02:26:51.211Z","updated_at":"2026-06-13T06:05:00.131Z","avatar_url":"https://github.com/wgtunnel.png","language":"Kotlin","funding_links":["https://ko-fi.com/zaneschepke","https://liberapay.com/zaneschepke","https://github.com/sponsors/zaneschepke","https://wgtunnel.com/donate/"],"categories":["Jul 30, 2025","Apps","Kotlin"],"sub_categories":["Network"],"readme":"\u003ch1 align=\"center\"\u003e\nWG Tunnel\n\u003c/h1\u003e\n\n\u003cdiv align=\"center\"\u003e\n\nAn alternative FOSS Android client for [WireGuard](https://www.wireguard.com/)\nand [AmneziaWG](https://docs.amnezia.org/documentation/amnezia-wg/)\n\u003cbr /\u003e\n\u003cbr /\u003e\n\u003ca href=\"https://github.com/zaneschepke/wgtunnel/issues/new?assignees=zaneschepke\u0026labels=bug\u0026projects=\u0026template=bug_report.md\u0026title=%5BBUG%5D+-+Problem+with+app\"\u003eReport a Bug\u003c/a\u003e\n·\n\u003ca href=\"https://github.com/zaneschepke/wgtunnel/issues/new?assignees=zaneschepke\u0026labels=enhancement\u0026projects=\u0026template=feature_request.md\u0026title=%5BFEATURE%5D+-+New+feature+request\"\u003eRequest a Feature\u003c/a\u003e\n·\n\u003ca href=\"https://github.com/zaneschepke/wgtunnel/discussions\"\u003eAsk a Question\u003c/a\u003e\n\n\u003c/div\u003e\n\n\u003cbr/\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n[![Google Play](https://img.shields.io/badge/Google_Play-414141?style=for-the-badge\u0026logo=google-play\u0026logoColor=white)](https://play.google.com/store/apps/details?id=com.zaneschepke.wireguardautotunnel)\n[![IzzyOnDroid](https://img.shields.io/static/v1?style=for-the-badge\u0026message=IzzyOnDroid\u0026color=1976D2\u0026logo=F-Droid\u0026logoColor=FFFFFF\u0026label=)](https://apt.izzysoft.de/fdroid/index/apk/com.zaneschepke.wireguardautotunnel)\n[![Obtainium](https://img.shields.io/badge/Obtainium-414141?style=for-the-badge\u0026logo=Obtainium\u0026logoColor=white)](https://apps.obtainium.imranr.dev/redirect?r=obtainium://app/%7B%22id%22%3A%22com.zaneschepke.wireguardautotunnel%22%2C%22url%22%3A%22https%3A%2F%2Fgithub.com%2Fzaneschepke%2Fwgtunnel%22%2C%22author%22%3A%22zaneschepke%22%2C%22name%22%3A%22WG%20Tunnel%22%2C%22preferredApkIndex%22%3A0%2C%22additionalSettings%22%3A%22%7B%5C%22includePrereleases%5C%22%3Afalse%2C%5C%22fallbackToOlderReleases%5C%22%3Atrue%2C%5C%22filterReleaseTitlesByRegEx%5C%22%3A%5C%22%5C%22%2C%5C%22filterReleaseNotesByRegEx%5C%22%3A%5C%22%5C%22%2C%5C%22verifyLatestTag%5C%22%3Atrue%2C%5C%22sortMethodChoice%5C%22%3A%5C%22date%5C%22%2C%5C%22useLatestAssetDateAsReleaseDate%5C%22%3Afalse%2C%5C%22releaseTitleAsVersion%5C%22%3Afalse%2C%5C%22trackOnly%5C%22%3Afalse%2C%5C%22versionExtractionRegEx%5C%22%3A%5C%22%5C%22%2C%5C%22matchGroupToUse%5C%22%3A%5C%22%5C%22%2C%5C%22versionDetection%5C%22%3Atrue%2C%5C%22releaseDateAsVersion%5C%22%3Afalse%2C%5C%22useVersionCodeAsOSVersion%5C%22%3Afalse%2C%5C%22apkFilterRegEx%5C%22%3A%5C%22%5C%22%2C%5C%22invertAPKFilter%5C%22%3Afalse%2C%5C%22autoApkFilterByArch%5C%22%3Atrue%2C%5C%22appName%5C%22%3A%5C%22WG%20Tunnel%5C%22%2C%5C%22appAuthor%5C%22%3A%5C%22Zane%20Schepke%5C%22%2C%5C%22shizukuPretendToBeGooglePlay%5C%22%3Afalse%2C%5C%22allowInsecure%5C%22%3Afalse%2C%5C%22exemptFromBackgroundUpdates%5C%22%3Afalse%2C%5C%22skipUpdateNotifications%5C%22%3Afalse%2C%5C%22about%5C%22%3A%5C%22%5C%22%2C%5C%22refreshBeforeDownload%5C%22%3Afalse%7D%22%2C%22overrideSource%22%3Anull%7D)\n\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n\n[\u003cimg  src=\"https://img.shields.io/badge/Telegram-26A5E4.svg?style=for-the-badge\u0026logo=Telegram\u0026logoColor=white\"\u003e](https://t.me/wgtunnel)\n[\u003cimg src=\"https://img.shields.io/badge/Matrix-000000.svg?style=for-the-badge\u0026logo=Matrix\u0026logoColor=white\"\u003e](https://matrix.to/#/#wg-tunnel-space:matrix.org)\n\u003c/div\u003e\n\n\u003cdetails open=\"open\"\u003e\n\u003csummary\u003eTable of Contents\u003c/summary\u003e\n\n- [About](#about)\n- [Screenshots](#screenshots)\n- [Features](#features)\n- [Building](#building)\n- [Translation](#translation)\n- [Acknowledgements](#acknowledgements)\n- [Contributing](#contributing)\n\n\u003c/details\u003e\n\n\u003cdiv style=\"text-align: left;\"\u003e\n\n## About\n\nWG Tunnel is an alternative Android client for WireGuard and AmneziaWG, inspired by the official WireGuard Android app. It fills gaps in the official client by adding advanced features like auto-tunneling, AmneziaWG support, different app modes like **Lockdown** (a custom kill switch for leak prevention), and **Local Proxy** (expose a tunnel over a local SOCKS5/HTTP proxy server) for enhanced privacy, censorship resistance, and flexibility.\n \n\u003c/div\u003e\n\n\u003cdiv style=\"text-align: left;\"\u003e\n\n## Screenshots\n\n\u003c/div\u003e\n\u003cdiv style=\"display: flex; flex-wrap: wrap; justify-content: left; gap: 10px;\"\u003e\n    \u003cimg label=\"Main\" src=\"fastlane/metadata/android/en-US/images/phoneScreenshots/main_screen.png\" width=\"200\"  alt=\"Main\"/\u003e\n    \u003cimg label=\"Config\" src=\"fastlane/metadata/android/en-US/images/phoneScreenshots/config_screen.png\" width=\"200\"  alt=\"Config\"/\u003e\n    \u003cimg label=\"Settings\" src=\"fastlane/metadata/android/en-US/images/phoneScreenshots/settings_screen.png\" width=\"200\"  alt=\"Settings\"/\u003e\n    \u003cimg label=\"Auto-tunnel\" src=\"fastlane/metadata/android/en-US/images/phoneScreenshots/auto_screen.png\" width=\"200\"  alt=\"Auto-tunnel\"/\u003e\n\u003c/div\u003e\n\n## Features\n\n- **Auto-Tunneling:** Automatically activate tunnels based on your device's active network details.\n- **Deferred Endpoint Bootstrapping:** Safely resolves endpoints and updates peers after the tunnel is up for better reliability and leak protection on startup.\n- **Handshake Monitoring:** Real-time handshake monitoring for instant tunnel health feedback.\n- **AmneziaWG Support:** Full support for AmneziaWG 2.0, providing robust censorship protection.\n- **Split Tunneling:** Flexible support for routing specific apps or traffic through the VPN.\n- **Local Proxy Mode:** Expose WireGuard tunnels over a local SOCKS5 or HTTP proxy to browsers or firewall apps (like AdGuard).\n- **Lockdown Mode:** Advanced in-app kill switch that blocks all traffic while the tunnel is down.\n- **Quick Controls:** Quick Settings tile and home screen shortcuts for easy toggling.\n- **Remote Control Support:** Intent-based automation for controlling tunnels and auto-tunneling from automation apps (like Tasker).\n- **Dynamic DNS Handling:** Automatically detect and update endpoints on server IP changes without requiring a restart.\n- **IPv6 Endpoints:** Automatically upgrade to IPv6 endpoints or fall back to IPv4 based on network conditions without requiring a restart.\n- **Android TV Support:** Full support for nearly all features on Android TV.\n\n## Building\n\n```sh\ngit clone https://github.com/wgtunnel/wgtunnel\ncd wgtunnel\n```\n\n```sh\n./gradlew assembleDebug\n```\n\n## Translation\n\nThis app is using [Weblate](https://weblate.org) to assist with translations.\n\nHelp translate WG Tunnel into your language\nat [Hosted Weblate](https://hosted.weblate.org/engage/wg-tunnel/).\\\n[![Translation status](https://hosted.weblate.org/widgets/wg-tunnel/-/multi-auto.svg)](https://hosted.weblate.org/engage/wg-tunnel/)\n\n## Acknowledgements\n\nThank you to the following:\n\n- All of the users that have helped contribute to the project with ideas, translations, feedback, bug reports, testing, and donations.\n- [WireGuard](https://www.wireguard.com/) - Jason A. Donenfeld (https://github.com/WireGuard/wireguard-android)\n- [AmneziaWG](https://docs.amnezia.org/documentation/amnezia-wg/) - Amnezia Team (https://github.com/amnezia-vpn/amneziawg-android)\n- [JetBrains](https://jetbrains.com) - For supporting open-source developers with free software licenses.\n\n## Contributing\n\nAny contributions in the form of feedback, issues, code, or translations are welcome and much\nappreciated!\n\nPlease read\nthe [code of conduct](https://github.com/zaneschepke/wgtunnel?tab=coc-ov-file#contributor-code-of-conduct)\nbefore contributing.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwgtunnel%2Fandroid","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwgtunnel%2Fandroid","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwgtunnel%2Fandroid/lists"}