Skip to content

Commit

Permalink
Added readme description
Browse files Browse the repository at this point in the history
  • Loading branch information
Kif11 committed Mar 10, 2019
1 parent 0c6d984 commit cb93743
Showing 1 changed file with 32 additions and 0 deletions.
32 changes: 32 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
# Anti Captive Portals

Bypass captive portals and get free WiFi easy 😝

To build
```
./build.sh
```

To run
```
cd build
./anticap
```

Use `-h` flag to get more help on different options. Use `-v` to show log output.

## What does this tool do exactly?

1. Capture packets in monitor mode for a given WiFi network
2. Go through the list of discover devices and try to access internet
3. Derive some connection rating based on the previous step
4. Pick a device with the best connection and set your mac address to this device

This tool is tested on Mojave 10.14.2 with
Card Type: AirPort Extreme (0x14E4, 0x133)
Firmware Version: Broadcom BCM43xx 1.0 (7.77.61.1 AirPortDriverBrcmNIC-1305.2)

Special thanks for people developing following tools

- https://github.com/feross/SpoofMAC
- https://github.com/unixpickle/JamWiFi

0 comments on commit cb93743

Please sign in to comment.