wardrive-map-generator

Generate HTML Map from Wardrive/Wigle WiFi log files

Markers showing a wardrive from the log file I included in this repo.

Open WiFi networks are shown as green markers

---

Dependencies

python3, ipython, pandas, folium

Download Python 3 if you don't have it already. Make sure PIP is installed too.
Check it with:

python -V

and

pip -V

If both commands display versions, you're good to go.

Then run:

pip install ipython pandas folium --break-system-packages

---

Install

git clone https://github.com/sorinbotirla/wardrive-map-generator.git
cd ./wardrive-map-generator/

Add your wardrive .log files next to the script. When you run the script, it will parse all the log files and generate a html map which you can open in the browser. Open networks will be shown as green markers.

---

Run

ipython wardrive-map-generator.py

Then open mapdata.html in your browser and check the markers.

---

How to get wardrive log files

You can use the Wigle.net app or buy an ESP32 Marauder from https://justcallmekokollc.com/ or https://awokdynamics.com/

To build an ESP32 Marauder you can follow my guide here and here

---

Ok, but what's Wardriving?

According to Wikipedia, wardriving is

Wardriving is the act of searching for Wi-Fi wireless networks as well as cell towers, usually from a moving vehicle, using a laptop or smartphone. Software for wardriving is freely available on the internet.

You can scan all the WiFi networks around you using a software/app/device that has GPS and WiFi capabilities. The point is to collect all the wireless network locations, store them in log files, and upload the logs on the international wireless database found on https://wigle.net/, where you can contribute and search for the location of various wireless stations/access points around the world.

---

What's in the wardrive log files?

Each log file is basically a CSV file containing the following columns:

MAC,SSID,AuthMode,FirstSeen,Channel,RSSI,CurrentLatitude,CurrentLongitude,AltitudeMeters,AccuracyMeters,Type
6A:9A:XX:XX:XX:XX,TP-Link_XXX,[WPA2_PSK],2025-6-7 2:36:2,6,-91,44.4481659,26.0647907,90.50,4.25,WIFI

---

Is Wardriving legal?

Yes. You do not hack the wireless networks, neither connect to them. Wardriving is just creating a world map of wifi networks.