Autonomous Multi-WLAN Failover & Zero-Downtime Wi-Fi Self-Healing Engine
Engineered for engineers hosting live web servers, competitive gamers, and remote workers.
Visit the interactive landing page and test the failover simulator in your browser:
👉 https://wifi.botdigit.site/ (or https://botdigit.github.io/zerodrop-wifi/)
- Zero-Downtime Multi-WLAN Failover: Tiered priority system (Tier 1 Primary Fiber, Tier 2 Backup Wi-Fi, Tier 3 Hotspot/Cellular).
- V2 Frozen Wi-Fi Self-Healing: Automatically detects deadlocked driver stacks / frozen gateway routes and power-cycles the hardware adapter autonomously before falling back.
- Anti-Flap Cooldown Hysteresis: 60-second cooldown prevents loop oscillation and ping-pong reconnects.
- Passive Beacon Signal Scorer: Scans nearby 2.4 GHz & 5 GHz beacons continuously in the background without dropping ongoing video calls or active web sessions.
- Automatic Primary Revert: When your primary fiber router comes back in range and is verified healthy over 3 consecutive cycles, ZeroDrop smoothly auto-reverts back.
- 100% Local & Privacy First: Zero external telemetry. Zero plaintext passwords stored. Relies purely on your OS's native Keychain / Credential Manager.
- Cross-Platform Parity:
- macOS: Native Swift AppKit Menu Bar app + live signal scanner.
- Linux: Systemd user service + GTK/AppIndicator3 system tray app.
- Windows: Scheduled task / Windows service + system tray app (
zerodrop-tray.pyw).
# Using Homebrew
brew install botdigit/tap/zerodrop
# Or one-line automated curl install
curl -fsSL https://raw.githubusercontent.com/botdigit/zerodrop-wifi/main/scripts/install.sh | bashcurl -fsSL https://raw.githubusercontent.com/botdigit/zerodrop-wifi/main/apps/linux/install-linux.sh | bashirm https://raw.githubusercontent.com/botdigit/zerodrop-wifi/main/apps/windows/install-windows.ps1 | iexThe zerodrop CLI provides instant inspection and control:
# View live connection health, active SSID, latency, and status
zerodrop status
# Interactive live updating terminal dashboard (TUI)
zerodrop monitor
# Trigger an immediate multi-target diagnostic probe
zerodrop check
# List in-range broadcasting and saved networks
zerodrop saved
# Set or update network priority (1 = Primary, 2 = Backup)
zerodrop add "My_Home_WiFi" 1
zerodrop add "Backup_Hotspot" 2
# Manually switch networks
zerodrop switch "Backup_Hotspot"
zerodrop switch-primary
zerodrop switch-backup
# Trigger V2 adapter power-cycle self-healing
zerodrop recover
# Launch native desktop GUI / Tray application
zerodrop gui├── apps/
│ ├── macos/ # Native Swift Menu Bar & Desktop GUI app
│ ├── linux/ # Linux AppIndicator3/GTK3 Tray app & installer
│ ├── windows/ # Windows System Tray app & PowerShell installer
│ └── cli/ # Cross-platform CLI executable (`zerodrop`)
├── core/
│ ├── adapters/ # Hardware abstraction layer
│ │ ├── base.py # Interface definition
│ │ ├── macos.py # macOS CoreWLAN & networksetup
│ │ ├── linux.py # Linux NetworkManager (nmcli) / iw
│ │ └── windows.py # Windows netsh & PowerShell NetAdapter
│ ├── config.py # Configuration schema
│ ├── metrics.py # Gateway, DNS, and HTTP probing engine
│ └── engine.py # 4-state engine & IPC exporter
├── docs/ # GitHub Pages static landing page & simulator
├── scripts/ # Installers and Sequoia CoreWLAN scan helpers
└── services/ # Launchd (macOS) and Systemd (Linux) units
ZeroDrop implements a strict 4-state cycle: STABLE ➔ DEGRADED ➔ FROZEN_RECOVERY ➔ COOLDOWN.
For in-depth packet flow and state diagrams, see ARCHITECTURE.md.
Contributions, issues, and feature requests are welcome!
See CONTRIBUTING.md for local development setup and guidelines.
ZeroDrop Wi-Fi is open-source software licensed under the MIT License.
Developed with ❤️ by BotDigit Inc.