WiFi Portal

lovitus

1.1.2 · GitHub

Download APK

Network Android 5.0+ 5 months ago Proprietary

88 ShizuStore

234 GitHub

3 Stars

160 KB Size

More about this app

Applies captive-portal probe settings via Shizuku with backup, verify-before-write and regional presets.

WiFi Portal

Small native Android app for applying captive portal probe settings through Shizuku/Sui.

Scope

Min SDK 21, target/compile SDK 35.
No AndroidX UI stack and no native libraries.
Uses Shizuku UserService, not the deprecated Shizuku.newProcess.
Persists desired settings locally and checks them again whenever the app opens with Shizuku active.
Requests Shizuku authorization again when permission is missing.
Backs up original runtime values before writes and lets users restore all keys or a single key.
Shows the saved value, runtime value, original backup, target value, and exact shell command before any write.
Includes a China mainland preset using MIUI and Huawei 204 endpoints; it only saves the preset after the write is verified.

Shizuku/Sui currently require Android 6.0+. The APK keeps minSdk 21 so Android 5 devices can install and retain the same settings model, but in-app privileged apply/check depends on Shizuku/Sui being available.

Captive portal keys

The app writes and verifies the known captive portal settings used across Android 5 through current NetworkStack builds:

Android 5/6 legacy: captive_portal_server, captive_portal_detection_enabled
Android 6+: captive_portal_mode
Android 7+: captive_portal_http_url, captive_portal_https_url, captive_portal_fallback_url
NetworkStack / Android 10+: captive_portal_other_fallback_urls, captive_portal_other_http_urls, captive_portal_other_https_urls, captive_portal_user_agent, captive_portal_use_https, captive_portal_fallback_probe_specs
Optional old Wi-Fi watchdog compatibility keys: network_avoid_bad_wifi, wifi_watchdog_on, wifi_watchdog_poor_network_test_enabled, wifi_watchdog_background_check_enabled

For Android 10+ mirrored NetworkStack keys are also written to device_config connectivity when available. Older devices simply skip device_config.

Build

./gradlew testDebugUnitTest assembleDebug

Safety model

Writes are never executed directly from a mismatch prompt. The app reads runtime values through Shizuku, records the data source and read commands in the audit log, builds a write plan, shows the exact commands to the user, and executes only after confirmation. After execution it reads the same keys again and updates the displayed snapshot.

Release signing is configured through Gradle properties:

WIFIPORTAL_STORE_FILE=/absolute/path/wifiportal-release.jks
WIFIPORTAL_STORE_PASSWORD=...
WIFIPORTAL_KEY_ALIAS=wifiportal
WIFIPORTAL_KEY_PASSWORD=...

GitHub Secrets

Generate a release keystore and configure repository secrets:

scripts/generate-release-keystore.sh
scripts/configure-github-secrets.sh owner/repo release/wifiportal-release.jks

Required secrets:

ANDROID_KEYSTORE_BASE64
ANDROID_KEYSTORE_PASSWORD
ANDROID_KEY_ALIAS
ANDROID_KEY_PASSWORD

The workflow builds debug APKs for every push/PR and signed release APKs when the signing secrets are present. It does not upload Actions artifacts. For v* tags it uploads the signed APK directly to the matching GitHub Release.

How Shizuku is used

Can read and apply WiFi captive-portal and watchdog settings via `settings` and `cmd device_config` through Shizuku.

This is an AI-assisted analysis of Shizuku-related usages in the app's public source code. It is best effort, so it may not catch every single usage.

How this app uses Shizuku

WiFi Portal uses Shizuku to read and write system captive portal and WiFi watchdog settings that normal apps cannot change.

Read current configuration: shows the live system values for portal detection, portal mode, probe URLs, HTTPS use, user agent, probe specs and legacy WiFi watchdog options, read with settings get global and cmd device_config get connectivity through Shizuku.
Apply custom portal settings: writes URLs and options typed in the app, such as HTTP, HTTPS and fallback URLs, extra URL lists, portal mode, HTTPS use, user agent and probe specs, with settings put global and cmd device_config put connectivity through Shizuku, then re-reads to verify.
Disable portal detection: turns off captive portal checks and optionally legacy WiFi watchdog behavior by writing disabled values or clearing keys with settings put global, settings delete global and matching cmd device_config commands through Shizuku.
Restore original values: puts back the original system values saved before the first change, for all settings at once or for one selected setting, using the same settings and cmd device_config write path through Shizuku.
Apply China preset: switches to built in China endpoints with one confirmation, then writes those recommended URLs and options through Shizuku and saves them as the local scheme after verification.

Android APIs or commands used

settings get global
settings put global
settings delete global
cmd device_config get connectivity
cmd device_config put connectivity
cmd device_config delete connectivity
getprop ro.build.version.sdk

Notable details

The app keeps an automatic backup of the original system values before the first privileged write and re-reads settings after each write to confirm the change, with per item and full restore using those backups.