README

VPN Hotspot





(Pre-release channel)

Connecting things to your VPN made simple. Share your VPN connection over hotspot or repeater. (root required)  

This app is useful for:

 Connecting things that don't support VPN like Chromecasts behind corporate firewalls;
 Setting up gapps behind corporate firewalls;
 Connecting to your mobile hotspot but you're not bothered to set up VPN on your device;
 Identifying, monitoring and blocking (unwanted) clients;
 Bypassing tethering limits by:
    - (recommended) Use this app with a real VPN/socksifier;
    - Use this app with some adblock/DNS apps that uses system VPN service APIs, i.e. fake VPNs; (troubleshooting/a list of apps that work)
    - Try your luck and simply use this app.

P.S. You can also do the similar on Windows,
Mac,
and iOS.

 Features That Requires System App Installation

The following features in the app requires it to be installed under /system/priv-app since some restricted permissions are required.
One way to do this is to use App systemizer for Magisk.

 (Android 8-10, since app v2.4.0) android.permission.OVERRIDE_WIFI_CONFIG: Read/write system Wi-Fi hotspot configuration. (117)

Installing as system app also has the side benefit of launching root daemon less frequently due to having privileged permissions listed below.

 android.permission.CONNECTIVITY_USE_RESTRICTED_NETWORKS
 android.permission.LOCAL_MAC_ADDRESS
 android.permission.MANAGE_USB
 android.permission.OVERRIDE_WIFI_CONFIG
 android.permission.READ_WIFI_CREDENTIAL
 android.permission.TETHER_PRIVILEGED
 android.permission.WRITE_SECURE_SETTINGS
 Other system-app exclusive features that are not gated by permissions.

Whenever you install an app update, if there was a new protected permission addition (last updated in v2.17.1), you should update the app installed in system as well to make the system grant the privileged permission.

 Q & A

Search the issue tracker for more.

 What persistent changes can this app do to my system?

This app only indirectly write persistent changes through system APIs thus it should be generally pretty safe.

1. In Supplicant mode, the repeater asks wpa_supplicant to create a persistent group on startup, which Android persists in /data/vendor/wifi/wpa/p2p_supplicant.conf or /data/misc/wifi/p2p_supplicant.conf.
2. If you edited the system Wi-Fi hotspot configuration through this app, those changes will persist.
3. If you toggle tethering hardware offload through this app, the Android global tether_offload_disabled setting will persist.
   Toggle it back in this app or the matching Developer options setting to revert it.

Routing, firewall, addresses, and daemon/service state managed by this app are cleaned up when stopped, by Clean, or upon reboot.

 No root?

 Failed to create group due to internal error/repeater shuts down after a while?

This could caused by the Wi-Fi channel you selected is no longer available, due to:

1. Your device doesn't support operating on this channel, or
2. Ther