Skip to content

v4.4.0 — “Aurora”

Choose a tag to compare

View all tags
@github-actions github-actions released this 04 Nov 07:34
· 13 commits to main since this release
v4.4.0
deb3d87

✨ The Aurora GUI

The desktop GUI is now a local web application: a loopback-only HTTP bridge (vpeen/webui.py) runs the proxy core + tunnel controller and serves a zero-dependency UI (vanilla HTML/CSS/JS) shown in a native window via pywebview (Windows/macOS) or the default browser (Linux). CustomTkinter / Pillow / the whole Tk runtime are gone — the core stays pure-stdlib Python.

  • 🌌 Deep-space dark theme — drifting aurora gradients, dot grid, glass surfaces, gradient-ring power orb with phase-reactive states (connecting shimmer / connected glow / error arc)
  • 🗺️ Location sheet with circular flags, live search, per-region latency bars (real TCP-probe ms) and an “Optimal” card
  • 📊 Live stat cards: down/up totals with live rates, session timer, connections; IP card flips between real IP and exit IP, click-to-copy
  • ⚙️ Settings modal with full server-side validation, toasts, color-coded copyable log sheet
  • ⚡ Long-poll event stream (/api/poll) — sub-second UI updates, zero third-party JS
  • ♿ Full keyboard operation, focus rings, prefers-reduced-motion, ARIA labels
  • 🎬 New cinematic demo GIF — bespoke “aurora dart” cursor with comet trail and layered click ripples (README)

🔧 12 defects found & fixed (full audit of the new bridge + UI)

Critical

  1. Demo/data connect crashed mid-response (KeyError: country) → UI stuck on “Connecting…” forever
  2. Bridge exceptions killed HTTP responses — every endpoint now answers with a logged JSON 500
  3. Tunnel mode never showed the exit country (region recorded after the TUN layer was raised)

High

  1. Tunnel disconnect hung for 8 s — core stops the moment the tunnel confirms down
  2. Region switch while connected did nothing in demo mode
  3. Disconnect during “connecting” self-reconnected ~4 s later (generation counters now invalidate stale timelines)
  4. Out-of-range ports/MTU saved silently — validated at save time with per-field messages

Medium

  1. Switch reconnect could be lost forever
  2. Stale tunnel styling after disconnect
  3. Footer showed stale ports after saving settings
  4. Tunnel switch while connected didn’t apply (v4.3 parity restored)
  5. Misleading System-Proxy tooltip

📦 Downloads

Asset Platform Install
VPeeN-4.4.0-Windows.zip Windows 10/11 unzip → VPeeN.exe
VPeeN-4.4.0-macOS.zip macOS 10.13+ unzip → VPeeN.app (right-click → Open the first time)
VPeeN-4.4.0-Linux.tar.gz Linux x64 extract → ./VPeeN

Windows/macOS open the UI in a native desktop window; Linux opens it in the default browser — same UI, same features.

✅ Verification

scripts/test_webui_demo.py         27/27 PASS   (live demo-mode server)
scripts/test_vpeen_fixes.py        59/59 PASS
scripts/test_vpeen_integration.py  11/11 PASS   (fake TLS upstream)
manual real-network check          connect → SOCKS5 fetch → exit-IP match

Full Changelog: v4.3.1...v4.4.0

Assets 5
Loading