📡 Wi-Fi Share

A lightweight network jumpstarter & IP dashboard for Android

Share your wifi internet over USB — instantly, natively, no proxies, no fuss.

---

✨ What Is This?

Wi-Fi Share is a minimal Android dashboard app that kickstarts Android's native OS-level USB tethering so your connected Windows PC gets online immediately — with zero configuration, zero proxy engines, and zero background battery drain.

No VPN. No hotspot fees. No system tray daemons. Just plug in and go.

---

😤 The Problem

If you've ever tried to work from a laptop, you've probably felt this: the Wi-Fi drops for a second, the VPN kicks you out, the video call stutters, or the download resets — all because your laptop's wireless card can't hold a stable connection. Laptop Wi-Fi is notoriously inconsistent. Drivers misfire, signal degrades through walls, and the antenna is a fraction of what a phone carries.

Meanwhile, your smartphone is sitting right next to you with a rock-solid Wi-Fi connection — better antenna placement, better power management, and a radio stack tuned for sustained connectivity. Phones simply hold Wi-Fi better than laptops do.

The obvious fix is USB tethering. Plug in your phone, share the connection, done. Except — Android's USB tethering normally only routes cellular data, not your phone's active Wi-Fi. So you'd burn through your mobile data plan just to get the stable connection your phone's Wi-Fi already has for free.

---

💡 The Solution

Wi-Fi Share bridges that gap. By waking Android's native rndis0 network interface, it forces the OS to route your phone's Wi-Fi connection — not cellular — through the USB tether to your PC.

The result: your laptop gets the stable, high-speed internet your phone's Wi-Fi already has, delivered over a wired USB link that doesn't drop, doesn't fluctuate, and doesn't cost you mobile data.

	Laptop Wi-Fi	Mobile Hotspot	Wi-Fi Share ✅
Connection stability	⚠️ Inconsistent	✅ Good	✅ Excellent
Uses phone's Wi-Fi	—	❌	✅
Burns mobile data	—	✅ Yes	❌ No
Wired reliability	❌	❌	✅ USB
Setup required	—	Minimal	None

---

🔮 The Magic — How It Actually Works

Wi-Fi Share is NOT a proxy server. There is no background process, no packet forwarding, and no continuous battery drain.

Here's the elegant trick under the hood:

When the app launches, it calls networkInterface.getIPAddress() — a simple, innocuous network query. But that single call is enough to wake Android's internal network routing stack. Specifically, it forces the rndis0 USB network interface to initialize, which triggers the kernel-level NAT (Network Address Translation) that Android uses for USB tethering.

Phone (rndis0) ──NAT──▶ Android Wi-Fi Stack ──▶ Internet
     ▲
     │ USB
     │
Windows PC ◀── auto-detected gateway ── no proxy needed

Once that routing wakes up, Windows detects the internet automatically via the standard RNDIS ethernet driver. The app has done its job. You can close it entirely — the connection persists at the OS level until you unplug.

Approach	Background Drain	Carrier Detection Risk	Proxy Config
Wi-Fi Share ✅	None (app can close)	Minimal	None
Traditional Hotspot	Continuous	High	None
Proxy App	Continuous	Medium	Required

---

🚀 Setup Guide

Step 1 — Connect via USB

Plug your Android phone directly into your Windows PC using a USB cable turn on usb terthing.

Step 2 — Enable USB Tethering

On your phone, go to:

Settings → Network & Internet → Hotspot & Tethering → USB Tethering → ON

Step 3 — Kickstart the Network

Open the Wi-Fi Share app. The dashboard will display your IP address — this is the network query that wakes the rndis0 interface and kicks NAT into gear.

Step 4 — You're Online!

Windows automatically detects the new network gateway within a few seconds. Open a browser on your PC and you're good to go. No proxy settings. No manual gateway entry.

Step 5 — Close the App

Once the connection is live, you can fully close Wi-Fi Share. The connection is now maintained entirely by Android's OS-level routing — no app needs to stay open.

---

📦 Releases

SHA-256 checksums can be verified with certutil -hashfile wifi-share.apk SHA256 (Windows) or sha256sum wifi-share.apk (Linux/macOS).

Version	Release Date	Download	SHA-256 Checksum
v1.0.0	2025-01-01	wifi-share-v1.0.0.apk	sha256:b5bcf88f61de....

Note: Only install APKs from official releases. Enable Install from unknown sources in Android Settings to sideload.

---

📋 Permissions

Wi-Fi Share requests only what it needs:

Permission	Why
ACCESS_NETWORK_STATE	Query current IP address to trigger NAT wake-up
ACCESS_WIFI_STATE	Read Wi-Fi interface info for the dashboard display

No location. No storage. No microphone. No background services.

---

🤝 Contributing

Pull requests are welcome! For major changes, please open an issue first to discuss what you'd like to change.

1. Fork the repo
2. Create a feature branch (git checkout -b feature/your-idea)
3. Commit your changes (git commit -m 'Add: your idea')
4. Push and open a PR

---

📄 License

Distributed under the MIT License. See LICENSE for details.

---

_{Built with ❤️ using React + Capacitor · No proxies were harmed in the making of this app}