Skip to content

Latest commit

 

History

History
38 lines (30 loc) · 1.25 KB

README.md

File metadata and controls

38 lines (30 loc) · 1.25 KB
Raw

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.