How nestchao/hotspot-bypass-vpn-unlimited-hotspot works
Hotspot Bypass VPN shares a phone’s mobile data over Wi-Fi Direct: the host exposes a SOCKS5 proxy, while Android and Windows clients route traffic through it; Windows can also share onward to consoles and TVs. The repository also contains the product website and a separate GUI preview runtime. Android implementation details were not sampled, so those paths and links reflect README-documented behavior; Windows links are limited to relationships visible in the excerpts. The website and preview are included as distinct product-adjacent branches.
Main entry points: MobileRuntime.tsx Mobile runtime · HostService.kt Host service · main.py Windows client · Device.tsx Device model
Components 32
Android sharing
- Host controls
app/src/main/java/com/example/hotspot_bypass_vpn/MainActivity.kt - Wi-Fi Direct
app/src/main/java/com/example/hotspot_bypass_vpn/WiFiDirectBroadcastReceiver.kt - Host service
app/src/main/java/com/example/hotspot_bypass_vpn/HostService.kt - SOCKS5 proxy
app/src/main/java/com/example/hotspot_bypass_vpn/ProxyServer.kt - SOCKS5 parser
app/src/main/java/com/example/hotspot_bypass_vpn/Socks5Parser.kt - Android VPN client
app/src/main/java/com/example/hotspot_bypass_vpn/MyVpnService.kt
Windows client
- Windows client
laptop_proxy/main.py - TUN manager
laptop_proxy/main.py - Console sharing
laptop_proxy/console_bridge.py
Website
- Product pages
website/src/pages/index.astro - Guides and FAQ
website/src/views/Guide.astro - Downloads
website/src/views/Download.astro - Translations
website/src/i18n/en.ts
GUI preview
- Preview app
gui-preview/src/Prototype.tsx - Mobile runtime
gui-preview/src/mobile/MobileRuntime.tsx - Device model
gui-preview/src/mobile/Device.tsx - Phone frame
gui-preview/src/mobile/PhoneFrame.tsx - Keyboard simulation
gui-preview/src/mobile/Keyboard.tsx - Mobile scrolling
gui-preview/src/mobile/MobileScroll.tsx - Flow navigation
gui-preview/src/mobile/FlowStack.tsx - Carousel
gui-preview/src/mobile/Carousel.tsx - Bottom sheet
gui-preview/src/mobile/BottomSheet.tsx - Mobile cursor
gui-preview/src/mobile/MobileCursor.tsx - Mobile controls
gui-preview/src/mobile/components.tsx - Device assets
gui-preview/src/mobile/assets.ts - Device geometry
gui-preview/src/mobile/geometry.ts
Other components
- Mobile data
- Host user
- Android peer
- Windows user
- Console or TV
- Website visitor
Connections 24
- Host user → Host controls: starts sharing
README.md - Host controls → Host service: starts service
- Host service → Wi-Fi Direct: opens network
README.md - Host service → SOCKS5 proxy: exposes proxy
README.md - Mobile data → Host service: supplies traffic
README.md - Android peer → Wi-Fi Direct: joins network
README.md - Android peer → Android VPN client: starts VPN
README.md - Android VPN client → SOCKS5 proxy: routes traffic
README.md - Windows user → Windows client: connects
README.md - Windows client → TUN manager: starts tunnel
laptop_proxy/main.py - TUN manager → SOCKS5 proxy: connects to proxy
laptop_proxy/main.py - Windows client → Console sharing: configures sharing
laptop_proxy/main.py - Console or TV → Console sharing: receives shared network
README.md - Website visitor → Product pages: browses
README.md - Website visitor → Guides and FAQ: reads setup
README.md - Website visitor → Downloads: gets releases
README.md - Preview app → Mobile runtime: renders within
- Mobile runtime → Device model: uses device context
gui-preview/src/mobile/MobileRuntime.tsx - Mobile runtime → Phone frame: renders frame
gui-preview/src/mobile/MobileRuntime.tsx - Mobile runtime → Keyboard simulation: provides keyboard
gui-preview/src/mobile/MobileRuntime.tsx - Mobile scrolling → Keyboard simulation: reads insets
gui-preview/src/mobile/MobileScroll.tsx - Phone frame → Mobile cursor: uses cursor
gui-preview/src/mobile/PhoneFrame.tsx - Device model → Device assets: uses assets
gui-preview/src/mobile/Device.tsx - Device model → Device geometry: uses geometry
gui-preview/src/mobile/Device.tsx