Skip to content

Latest commit

Β 

History

11 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ”Œ YunuUSBNet V1.0.0

yunu00 yunu01

Ultra-Lightweight Windows Reverse Tethering GUI β€” Powered by Gnirehtet & ADB


πŸ–ΌοΈ Screenshots

image (3)

πŸ“– What is YunuUSBNet?

YunuUSBNet is an ultra-lightweight, portable Windows GUI wrapper built in AutoIt for Gnirehtet and ADB. It shares your PC/Laptop's internet connection (Ethernet or Wi-Fi) with an Android smartphone via USB reverse-tethering β€” no root, no complicated CMD commands, no driver hell.

It's purpose-built for budget and low-spec PCs (2GB RAM) β€” the kind of "potato PC" that chokes on heavier tethering tools. YunuUSBNet strips away the bloat and gives you a clean, one-click GUI on top of the proven Gnirehtet engine.

Perfect for:

  • πŸ’» Old laptops / budget PCs with 2GB RAM
  • 🏒 Office or campus computers with strict spec limits
  • πŸ“Ά Areas with no Wi-Fi but a spare Android phone with mobile data (or vice versa)
  • πŸ™… Anyone tired of fiddling with raw adb and gnirehtet CMD commands

πŸ”₯ What's New in Latest Release πŸŽ‰

πŸ“± YunuUSBNet (NEW RELEASE V1.2.5 πŸŽ‰)

  • πŸšͺ Smart Startup Gatekeeper & GDI+ Engine: Introduced an intelligent startup splash gate with high-quality bicubic image rendering (yunu00.png / yunu01.png). Scans Windows PnP hardware for official Android Vendor IDs (Google, Xiaomi, Samsung, Oppo, Realme, MediaTek, Transsion/Infinix) and opens automatically upon cable insertion. Includes an instant Dev Bypass for testing without physical devices.
  • πŸ› οΈ Protected Developer Mode & Dynamic UI: Unlock real-time raw telemetry logs via password authentication (yunu). Features dynamic window geometry resizing (490px compact mode vs. 625px extended telemetry mode) with native GUIResizeMode protection to prevent button stretching.
  • ⚑ Isolated ADB Engine (0ms Anti-Deadlock): Complete overhaul of the ADB execution pipeline. Goodbye hanging processes and Stdout pipe buffer freezes! ADB commands now run via isolated temp stream redirection backed by a strict 2,500ms timeout watchdog kill.
  • πŸ“Ά Adaptive 75% Smart Data Tier Pipeline: Integrated an unlimited data quota tracker driven purely by physical network octets. The progress bar automatically doubles target capacity (1 GB -> 2 GB -> 4 GB ...) whenever 75% of the current tier is reached.
  • πŸ›‘οΈ Continuous Explorer Popup Guard: Say goodbye to annoying Windows AutoPlay / MTP File Explorer popups every time you plug in your phone! Automatically intercepts, detects, and closes newly spawned CabinetWClass windows in the background within a 4-second window.
  • πŸ€– Deep Android System Tuning: Automatically injects shell optimizations before establishing the tunnel: disables conflicting phone Wi-Fi, wipes stubborn HTTP proxy settings, wakes up the screen (keyevent 224), dismisses keyguard, and whitelists Gnirehtet from Android battery Doze Mode.
  • πŸͺŸ Taskbar Crash Guard & 3-Way Exit Modal: Handled Win32 TaskbarCreated messages so the notification tray icon automatically re-registers if explorer.exe crashes. Added an elegant close confirmation modal allowing users to choose between Full Exit, Minimize to Tray, or Cancel.
  • πŸ“œ Smart 3-Session Rolling Logger: Replaced infinite log file bloat with a smart rolling parser that cleanly retains only the last 3 active sessions, complemented by millisecond-precise developer telemetry logs (filelogdeveloper.txt).
  • πŸ”„ Dual-Track Jitter Recovery: Added a 1.5-second debounce cooldown filter to handle physical USB cable shakes/jitters seamlessly without triggering destructive ADB resets.

This is the first official release of YunuUSBNet. Here's everything packed into it:

635577197-92fd0a41-497b-4bb2-af60-4766651ea698

πŸ“Š Dual-Unit Live Speedometer & 4-State Color Matrix

  • Real-time network speed display showing both KB/s (or MB/s) and Mbps simultaneously β€” e.g. 768.0 KB/s (6.1 Mbps).
  • Powered by a WMI Raw Performance Engine (Win32_PerfRawData_Tcpip_NetworkInterface) with a 2-sample Moving Average smoothing filter to eliminate false 0 KB/s dips.
  • Dynamic 4-State Color Matrix: switches between Theme Blue (#00AAFF) when active and Gray (#666666) when disconnected/idle β€” with zero flicker.
  • Flat visual progress meter bars rendered via native Windows uxtheme.dll calls.
  • WMI Warm-Up on launch: instantly detects PC internet status at startup via ping and octet checks.

πŸͺ– Military-Grade Hardware Resilience & Cable Shake Protection

  • Non-Destructive Instant Re-Attach (~100ms): automatically re-injects Gnirehtet without killing the ADB daemon or corrupting the phone's ADB session when physical micro-jitters occur.
  • Soft Hysteresis Retry Loop: 3x soft retries before escalating, making the connection immune to continuous cable shaking/vibration ("Rage-Gamer Proof").
  • Windows PnP Auto-Heal (WM_DEVICECHANGE 0x8000 / 0x8004): listens directly to Windows OS PnP kernel hardware messages for near-instant reconnection on USB insertion β€” fixes the classic "ding-dong" USB sound lockup.
  • Offline Device Auto-Recovery: automatically issues adb reconnect offline if ADB desyncs.
  • Graceful Android VPN Teardown: sends gnirehtet stop and am force-stop to the phone before closing PC-side processes on manual disconnect.

πŸͺΆ Ultra-Lightweight & System Hardening (Crash-Proof)

  • Single-Instance Enforcer (_Singleton): prevents multiple instances from fighting over USB sockets.
  • Explicit System Path Resolution (@SystemDir): protects against Windows %PATH% corruption or DLL side-loading.
  • Memory & Handle Leak Prevention: explicit StdioClose() handle cleanup and 15,000-character log buffer auto-purge.
  • High Priority Elevation (ProcessSetPriority(4)): elevates Gnirehtet to High Priority to prevent ping spikes during heavy gaming or 100% CPU load.
  • 0% CPU Idle Footprint: non-blocking single-loop execution with Sleep(10) yield.

πŸ“Œ System Tray & Window Lifecycle Overhaul

  • Minimize (_): minimizes normally to the Windows Taskbar.
  • Close (X): hides to the System Tray near the clock only when a connection is active. Exits completely when stopped.
  • Left-Click Tray Icon: instantly restores and activates the main window.
  • Headless Mode (--background): command-line argument support for silent execution without a GUI.

✨ Key Features

  • πŸ“Š Dual-Unit Live Speedometer β€” See real-time speed in KB/s / MB/s and Mbps at once
  • πŸͺ– Cable-Shake-Proof Connection β€” Instant re-attach with zero ADB session corruption
  • πŸͺΆ Ultra-Low RAM Usage β€” Runs smoothly on 2GB RAM systems (yes, really)
  • ⚑ 0% CPU Idle β€” Non-blocking loop keeps your PC free for gaming or work
  • πŸ”Œ No Root Required β€” Works entirely through standard USB debugging + ADB
  • πŸ–±οΈ One-Click GUI β€” No manual adb or gnirehtet CMD typing needed
  • πŸ“Œ Smart System Tray Behavior β€” Stays out of your way when active, exits clean when stopped
  • πŸ“¦ Fully Portable β€” No installation needed, ~15MB including the Engine folder
  • πŸ–₯️ Broad Compatibility β€” Windows 7, 8, 10, and 11 (32-bit & 64-bit)

πŸ†š Overview / Performance Comparison

Feature πŸ”Œ YunuUSBNet ⌨️ Official Gnirehtet CMD πŸ’° Commercial Tethering Tools
RAM Usage 3–8 MB 30MB+ 150MB+
CPU Usage (Idle) 0–1% 1–3% 3–5%
Setup Complexity βœ… One-click GUI ❌ Manual CMD commands ⚠️ Installer + Account
Root Required ❌ No ❌ No ❌ No
Cable-Shake Resilience βœ… Instant Re-Attach ❌ Manual restart needed ⚠️ Varies
Live Speedometer βœ… Dual-Unit (KB/s + Mbps) ❌ None ⚠️ Basic
Portable (No Install) βœ… Yes βœ… Yes (CMD only) ❌ No
Price πŸ†“ Free πŸ†“ Free πŸ’° Often Paid
Size ~15MB Varies 50MB+

Bottom Line: YunuUSBNet gives you the reliability and speed of Gnirehtet, wrapped in a lightweight GUI that's actually pleasant to use β€” even on a potato PC.


πŸ’» System Requirements

Minimum (Tested & Works)

  • CPU: Dual Core 2.0 GHz (Intel i3 2nd Gen or equivalent)
  • RAM: 2GB
  • OS: Windows 7, 8, 10, or 11 (32-bit & 64-bit)
  • USB: A working USB port + data-capable USB cable
  • Android: USB Debugging enabled on the phone

Recommended

  • CPU: Intel i3 3rd Gen or higher
  • RAM: 4GB+
  • USB: USB 3.0 port for best throughput

πŸš€ Quick Start / Installation Guide

πŸ–₯️ Windows Installation (7 / 8 / 10 / 11)

  1. Download YunuUSBNet_V1.0.0.zip from Releases.
  2. Extract using WinRAR, 7-Zip, or Windows' built-in extractor.
  3. Enable USB Debugging on your Android phone (Settings β†’ Developer Options).
  4. Connect your phone via USB cable and allow the ADB authorization prompt on the phone.
  5. Open the extracted folder and run YunuUSBNet.exe.
  6. Click Start/Connect and watch the speedometer come alive. πŸŽ‰

πŸ’‘ Tip for First-Time Users: If your phone isn't detected, install the correct USB/ADB driver for your device model first, then reconnect the cable.


βš™οΈ Features Explained

πŸ“Š Dual-Unit Live Speedometer

Reads live traffic counters straight from Windows' WMI performance layer and applies a 2-sample moving average, so the number you see is smooth and accurate instead of jumping to 0 KB/s between polling intervals. Both KB/s/MB/s and Mbps are shown together so you don't have to do the math yourself.

πŸͺ– Hardware Resilience

USB reverse-tethering is notoriously fragile β€” a loose cable or a bump on the desk usually kills the whole session and forces a full restart. YunuUSBNet listens directly to Windows' PnP hardware events and re-injects the Gnirehtet tunnel in roughly 100ms, without tearing down the underlying ADB session. Combined with the soft hysteresis retry loop, this makes the connection resilient enough to survive continuous cable movement.

πŸͺΆ System Hardening

Because the tool is meant to run for hours in the background on low-spec machines, every part of the codebase is written to avoid leaks: handles are explicitly closed, the log buffer is capped and auto-purged, and only a single instance is ever allowed to run β€” preventing two copies from fighting over the same USB socket.

πŸ“Œ Tray & Lifecycle Behavior

YunuUSBNet only occupies your taskbar or tray depending on connection state β€” it disappears completely once you've stopped tethering, so it never lingers as background clutter.


πŸ“Š Performance Comparison (Real-World Test)

Tested on a potato PC β€” Intel i3 2nd Gen + 2GB RAM:

Tool RAM CPU (Idle) CPU (Active) Setup Time
YunuUSBNet 3–8 MB 0–1% 1–2% ~10 sec
Official Gnirehtet CMD 30MB+ 1–3% 3–5% ~2–5 min
Commercial Tethering Tool 150MB+ 3–5% 5–10% ~1–3 min

YunuUSBNet uses up to 4–5x less RAM than a typical commercial tethering tool, while staying just as fast β€” because it's just a thin, well-optimized GUI shell around Gnirehtet, not a reinvented network stack.


πŸ› οΈ Troubleshooting

Q: My phone isn't detected at all? A: Make sure USB Debugging is enabled and you've accepted the "Allow USB Debugging" prompt on the phone. Reinstall the correct ADB driver for your device if needed.

Q: The connection drops when I move the cable slightly? A: This is exactly what the Hardware Resilience system is built to fix β€” update to the latest version. If it still happens, try a different USB cable (some cheap cables have poor shielding).

Q: The speedometer shows 0 KB/s even though internet is working? A: Wait a few seconds for the WMI Warm-Up to finish detecting your active network adapter, or check that your PC's internet connection itself is active.

Q: ADB says "device offline"? A: YunuUSBNet automatically issues adb reconnect offline in the background. If it persists, unplug and replug the USB cable once.

Q: The app won't close from the tray icon? A: By design, YunuUSBNet only fully exits when the connection is stopped β€” this prevents an abrupt VPN teardown on the phone. Click Stop first, then close.

Q: Can I run it without a visible window? A: Yes β€” launch it with the --background argument for headless/silent mode.


πŸ’¬ Community & Support

  • πŸ› Report a Bug: Open an Issue
  • πŸ’‘ Request a Feature / Ask Questions: Use Discussions
  • ⭐ Enjoying YunuUSBNet? Consider starring the repo β€” it helps a lot!

πŸ“ License

Other

πŸ‘€ Author

YunuP-Dev Modified & Engineered by: Yunu – Skanesa

Built for people with old computers who still want a reliable connection.

"Powered by Genymobile/gnirehtet"

Keywords: USB reverse tethering Windows β€’ Gnirehtet GUI β€’ ADB tethering tool β€’ share internet via USB Android β€’ lightweight tethering 2GB RAM β€’ potato PC internet sharing β€’ Windows 7/8/10/11 USB tethering β€’ portable Gnirehtet wrapper β€’ no root USB tethering β€’ ADB reverse tether GUI β€’ YunuUSBNet

About

Ultra-lightweight Windows reverse-tethering GUI for 2GB RAM systems. Features a WMI-powered dual-unit speedometer, PnP-driven instant reconnection, and cable-shake-proof hardware resilience. Powered by a stripped-down Gnirehtet + ADB backend. (Scroll down until you find the release and download it.)

Topics

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Contributors