Introduction

"Locate BSSID" is a simple tool made in Python3 to check the location of an MAC, BSSID address from a opensource database.

Why I made it?

I am learning how to use Application Programming Interface's (API) within Python and how to handle the returned data in json.

What can Locatebssid do?

With locatebssid you are able to enter a MAC, BSSID address and make an API request to get the location of the BSSID providing it is in the database. If the BSSD is in the database it will print out the Lat/Lon and give you the option to view it in Google Maps as a pin.

What does the json result look like?

The json below is returned from the API provider and I add some formatting to make it readable.

  {
    "result": 200,
    "data": {
        "time": 1494088927,
        "lon": 16.54751061246,
        "lat": 45.21966319365,
        "range": 132.926
    }
}

Example based on the test BSSID of 00:0C:42:1F:65:E9, I used the example BSSID from the API hence why it is the same. During development none of my own BSSID's returned a result.

What API am I using and why?

I am using the opensource WiFi database from https://www.mylnikov.org/ made by ALEXANDER MYLNIKOV. I started googling for a public WiFi database and found his. I choose it as it does not require a API Key or have a request limit so it is great for a first time API. It has over 35 million worldwide records in it apparently.

How to use locatebssid?

Simply clone or download the locatebssid project and make the script executable with the following command;

sudo chmod +x locatebssid.py

then to run locatebssid simply type;

python3 locatebssid.py

Below is an example of the console output.

If you select Y at the option it will open the browser to locate the BSSID.

Additional notes

Each time you run the script check the locatebssid.json file to see it change.
I have tried to make it as clean as passable adhering to PEP 8.

Credits

The API and lookup website belongs to ALEXANDER MYLNIKOV at https://www.mylnikov.org/

Want to use or change my code?

That's awesome! Thanks, but please adhere to the GNU GENERAL PUBLIC LICENSE. For more information see the LICENSE.txt in the repo.

Enjoy. D4rkC00d3r :-)

kjbaker-uk/locatebssid