Skip to content

README.md

Latest commit

 

History

History
148 lines (101 loc) · 2.65 KB

README.md

File metadata and controls

148 lines (101 loc) · 2.65 KB
Raw

Phone-Net Banner

📱 Phone-Net — USB Reverse Tethering for Android (Windows)

Use your Windows PC wired Ethernet connection on your Android phone over USB.
No Wi-Fi hotspot, no mobile data, no battery drain.

Built for fast, reliable development & testing.

🚀 Features

  • Reverse tethering: PC → Phone over USB
  • No root required
  • Fully portable folder
  • One-click start & stop
  • Auto-downloads dependencies
  • Clean shutdown (VPN + adb)
  • Logging for debugging
  • Works with Samsung Galaxy S25 and all modern Android devices

📦 Folder Layout

phone-net/
├─ start-phone-net.bat
├─ stop-phone-net.bat
├─ README.md
├─ LICENSES.md
├─ .gitignore
├─ gnirehtet-rust-win64/ (auto-downloaded)
├─ platform-tools/ (auto-downloaded)
├─ *.log (runtime logs)

Only the .bat files and documentation are tracked in Git.

⚙️ Requirements

  • Windows 10 / 11
  • USB cable
  • Android phone
  • Developer Mode enabled
  • USB debugging enabled

🔧 One-Time Phone Setup

On your phone:

Settings → About phone → Software info → Tap "Build number" 7 times
Settings → Developer options → Enable "USB debugging"

Approve the USB debugging prompt when connecting to the PC.

▶ Start Internet on Phone

  1. Connect phone via USB
  2. Double-click:
start-phone-net.bat

On first run:

  • Dependencies will be downloaded automatically
  • Gnirehtet VPN permission prompt will appear on the phone → Allow

Your phone is now using your PC's Ethernet connection.

⏹ Stop & Clean Everything

Double-click:

stop-phone-net.bat

This will:

  • Stop reverse tethering
  • Remove VPN
  • Kill adb server
  • Kill leftover adb.exe
  • Restore normal phone networking

🧾 Logs

Each run generates logs:

start-phone-net.log
stop-phone-net.log

Logs are auto-cleared on every new run.

🔐 Security Notes

  • Gnirehtet uses Android's built-in VPN API
  • No traffic inspection
  • No credential interception
  • No permanent system changes
  • adb access is limited to the connected phone

🧩 Third-Party Software

This project uses open-source tools under the Apache License 2.0.

See full details in: ➡ LICENSES.md

🏁 Summary

This setup gives you:

  • Wired-speed internet on your phone
  • Zero Wi-Fi dependency
  • Perfect for development, QA, and testing environments

💡 Credits

Reverse tethering powered by Gnirehtet
Android tooling by Google Platform Tools