/wififox

A menubar app for bypassing WiFi login pages.

Primary LanguageJavaScriptGNU General Public License v3.0GPL-3.0

WiFiFox


GitPoint

A menubar app for bypassing WiFi login pages.

WiFiFox is a menubar app for bypassing captive portals in wireless networks. It also includes a tiny network scanner. Works in OSX, Windows and Linux.

Please consider sponsoring this project if this is useful to you.

Installation

npm install -g wififox
sudo wififox

Usage

  1. Connect to any open network (WEP, WPA and WPA2 are not supported).
  2. Click "Bypass" in WiFiFox.
  3. Wait for WiFiFox to bypass the captive portal.
  4. Browse the web. You can just ignore any captive popups.

How it Works

WiFiFox uses MAC spoofing to bypass the portal. It automates the following steps:

  1. Discovers other connected clients and their MAC addresses through ping scan or passively.
  2. Clones/spoofs these MAC addresses in random order.
  3. Checks connection by attempting to reach a known public resource.

Disclaimer

Only use this software on networks you own or have permission to use.