Skip to content

curlew/WiGLE.py

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

WiGLE.py

CLI tool for searching for Wi-Fi networks using the WiGLE API. WiGLE is a worldwide database of wireless networks.

Usage

API access requires a free account and an API token from https://wigle.net/account. Put this in API_TOKEN in wigle.py.

usage: wigle.py [-h] [-t] [--bssid BSSID] [--ssid SSID] [--channel CHANNEL] [--encryption {None,WEP,WPA,WPA2,WPA3,Unknown}] [--country COUNTRY] [--city CITY]
                [--coords LAT LONG] [--results RESULTS]

Query the WiGLE database

options:
  -h, --help            show this help message and exit
  -t, --table           Display results in table format
  --bssid BSSID         BSSID to search for (at least the first 3 octets are required)
  --ssid SSID           SSID to search for
  --channel CHANNEL     Filter results by channel
  --encryption {None,WEP,WPA,WPA2,WPA3,Unknown}
                        Filter results by encryption type
  --country COUNTRY     Filter results by 2-letter country code
  --city CITY           Filter results by city
  --coords LAT LONG     Order results by proximity to coordinates
  --results RESULTS     Number of results to return

examples:
  ./wigle.py --bssid 00:11:22:33:44:55
  ./wigle.py --ssid MyNetwork --encryption WPA2 --city "Chicago"
  ./wigle.py -t --channel 6 --country US --results 25
  ./wigle.py -t --coords "-35.30694126991865" "149.124945877085" --results 10

Example output

$ ./wigle.py --ssid "eduroam" --country AU --results 1

{
  "success": true,
  "totalResults": 164635,
  "first": 1,
  "last": 1,
  "resultCount": 1,
  "results": [
    {
      "trilat": -33.89452362,
      "trilong": 151.19444275,
      "ssid": "eduroam",
      "qos": 2,
      "transid": "20140902-00000",
      "firsttime": "2014-09-03T00:00:00.000Z",
      "lasttime": "2014-09-16T04:00:00.000Z",
      "lastupdt": "2022-06-08T11:00:00.000Z",
      "netid": "00:03:52:A7:D8:23",
      "name": null,
      "type": "infra",
      "comment": null,
      "wep": "2",
      "bcninterval": 0,
      "freenet": "?",
      "dhcp": "?",
      "paynet": "?",
      "userfound": false,
      "channel": 4,
      "frequency": 0,
      "rcois": "0",
      "encryption": "wpa2",
      "country": "AU",
      "region": "New South Wales",
      "road": "Locomotive Street",
      "city": "Sydney",
      "housenumber": "2",
      "postalcode": "2015"
    }
  ],
  "searchAfter": "14271633443",
  "search_after": 14271633443
}

Example output (table format)

$ ./wigle.py -t --coords "-35.30694126991865" "149.124945877085" --results 10

┌─────────────────────┬───────────────────┬────────────┬─────────┬─────────┬────────────────────────────┬──────────────────────────┬──────────────────────────┐
│ SSID                │ BSSID             │ Encryption │ Channel │ Country │ Est. Coordinates           │ First Seen               │ Last Seen                │
├─────────────────────┼───────────────────┼────────────┼─────────┼─────────┼────────────────────────────┼──────────────────────────┼──────────────────────────┤
│ ABC_CORP            │ 6C:F3:7F:3F:07:02 │ wpa2       │ 11      │ AU      │ -35.30713272, 149.12484741 │ 2014-04-24T11:00:00.000Z │ 2018-11-08T20:00:00.000Z │
├─────────────────────┼───────────────────┼────────────┼─────────┼─────────┼────────────────────────────┼──────────────────────────┼──────────────────────────┤
│ DIRECT-BMW 22685    │ 5A:E4:03:1B:1B:8F │ wpa2       │ 157     │ AU      │ -35.30709076, 149.12516785 │ 2024-09-07T04:00:00.000Z │ 2025-09-10T23:00:00.000Z │
├─────────────────────┼───────────────────┼────────────┼─────────┼─────────┼────────────────────────────┼──────────────────────────┼──────────────────────────┤
│ pcwn                │ 70:DF:2F:BC:14:00 │ wpa2       │ 6       │ AU      │ -35.30694199, 149.12524414 │ 2018-11-09T14:00:00.000Z │ 2020-01-02T05:00:00.000Z │
├─────────────────────┼───────────────────┼────────────┼─────────┼─────────┼────────────────────────────┼──────────────────────────┼──────────────────────────┤
│ WiFiParliament      │ 70:DF:2F:A1:E7:01 │ unknown    │ 11      │ AU      │ -35.30699921, 149.12528992 │ 2018-11-09T14:00:00.000Z │ 2020-01-02T05:00:00.000Z │
├─────────────────────┼───────────────────┼────────────┼─────────┼─────────┼────────────────────────────┼──────────────────────────┼──────────────────────────┤
│ pcun                │ 70:DF:2F:A1:E7:02 │ wpa2       │ 11      │ AU      │ -35.30700302, 149.12528992 │ 2018-11-09T14:00:00.000Z │ 2020-01-02T05:00:00.000Z │
├─────────────────────┼───────────────────┼────────────┼─────────┼─────────┼────────────────────────────┼──────────────────────────┼──────────────────────────┤
│ None                │ 70:DF:2F:A1:E7:03 │ wpa2       │ 11      │ AU      │ -35.30700684, 149.12528992 │ 2018-11-09T14:00:00.000Z │ 2020-01-02T05:00:00.000Z │
├─────────────────────┼───────────────────┼────────────┼─────────┼─────────┼────────────────────────────┼──────────────────────────┼──────────────────────────┤
│ RETAIL              │ 40:CE:24:BE:CB:42 │ wpa2       │ 11      │ AU      │ -35.3070488, 149.12527466  │ 2018-11-09T14:00:00.000Z │ 2025-02-05T13:00:00.000Z │
├─────────────────────┼───────────────────┼────────────┼─────────┼─────────┼────────────────────────────┼──────────────────────────┼──────────────────────────┤
│ None                │ B6:CD:DE:C3:74:26 │ wpa3       │ 6       │ AU      │ -35.30706406, 149.12527466 │ 2025-02-05T21:00:00.000Z │ 2025-02-05T13:00:00.000Z │
├─────────────────────┼───────────────────┼────────────┼─────────┼─────────┼────────────────────────────┼──────────────────────────┼──────────────────────────┤
│ None                │ 16:0C:6B:EB:7B:95 │ wpa2       │ 9       │ AU      │ -35.30686188, 149.12530518 │ 2025-02-05T21:00:00.000Z │ 2025-02-05T13:00:00.000Z │
├─────────────────────┼───────────────────┼────────────┼─────────┼─────────┼────────────────────────────┼──────────────────────────┼──────────────────────────┤
│ ARLO_VMB_3179999295 │ A4:11:62:33:B2:8C │ wpa2       │ 2       │ AU      │ -35.30686188, 149.12530518 │ 2025-02-05T21:00:00.000Z │ 2025-02-05T13:00:00.000Z │
└─────────────────────┴───────────────────┴────────────┴─────────┴─────────┴────────────────────────────┴──────────────────────────┴──────────────────────────┘

Showing 10 results out of 1753218334 total results.

About

CLI tool for WiGLE network searches

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Contributors

Languages