numint Android app

A thin WebView wrapper around a self-hosted numint server. The phone does no intelligence work itself — it loads the server's web UI and supplies the login. All scanning, lookups, and presence checks run on the server (that is the whole point: the server reaches endpoints the phone can't).

Nothing about your server is baked into the app. On first launch it asks for the server URL and login, stored on-device only. So this source is safe to keep in a public repo.

Build it (no local toolchain needed)

The APK is built by GitHub Actions, not on your PC or your VPS:

1. Put this project on GitHub (a new repo of your own).

2. Open the Actions tab → Build Android APK → Run workflow (it also runs automatically when you push changes under android/).

3. When the run finishes, open it and download the numint-apk artifact.

4. Unzip it — inside is app-debug.apk.

Install it on your phone

1. Get app-debug.apk onto the phone (gofile, Google Drive, USB — whatever).

2. Tap it. Android will ask you to allow installing from this source — allow it.

3. Open numint. On first launch, enter:

   • Server URL — e.g. http://YOUR_VPS_IP:8080

   • Username / Password — the NUMINT_WEB_USER / NUMINT_WEB_PASSWORD you set on the server.

4. That's it. Change them anytime from the ⋮ menu → Server settings.

Notes

• The default backend is plain HTTP, so the app allows cleartext traffic (usesCleartextTraffic). Anyone able to sniff the connection could read it — put the server behind HTTPS (a domain + reverse proxy) for real privacy.

• It is a debug APK: unsigned, fine for personal sideloading. For the Play Store you would sign a release build.

• Authorized use only — the same rule as the rest of numint.