Wardrive Log Visualizer

Desktop tool to ingest wardrive logs, merge them into one combined log, and plot the sightings on a map. Streets come from OpenStreetMap tiles under the dots (cached after the first view). It is not a Google Maps or satellite view.

(Main-window screenshot will go here once captured — docs/images/main-window.png.)

---

Features

• Ingest WiGLE CSV 1.6 exports (including Biscuit), with WIFI, BLE, LTE, and NR rows
• Merge multiple runs into one log — every logged row stays; combined order is by FirstSeen
• Plot map — OpenStreetMap streets under the logged GPS dots (no Google Maps, no satellite). Tiles cache locally; with no network the dots still draw on the dark canvas. View → Location estimates (off until checked) adds a diamond for each MAC+Type seen at least twice, at the signal-weighted center. One log is enough. Click a diamond for that estimate. A known MAC prefix (Flock, Axon, and other listed cameras) adds a Known device line. Flock and Axon in the legend stay visible when WIFI and BLE are off, on either radio. The logged dots stay
• Zoom (scroll), pan (drag), click a point for its fields; Previous / Next or arrow keys walk the log. Find jumps to the oldest sighting of a MAC or BSSID (full address or a fragment) in the logs that are on; Previous / Next walk the other matches
• Drop CSVs on the left square (or use Add logs); per-file on/off toggles; × removes a file from the list
• Legend filters — click WIFI / BLE / LTE / NR to hide or show that type (gray when off); Save still keeps every row
• Save / export — File → Combine (merge + save), Clean (blacklist; writes {name} CLEAN.csv only when rows were removed), Clean and Combine (merge then blacklist; CLEAN in the name only when rows were removed). Row-cap → Part N (with CLEAN last when cleaned).
• Row-cap split — File → Split CSV; Dropzone automation may auto-split oversized day files. Map Add/drop does not auto-split.
• Unique vs samples on the legend, file list, and status (unique = distinct MAC+Type; samples = every row)
• Settings (General · Blacklist · WiGLE · WDGWars · About) — Dropzone/Cleared folders, pulse, SSID/MAC blacklist (blacklist.xml), keys, activity log
• Automation — pulse Dropzone → Cleared by FirstSeen day; blacklist strip; .csv.done; same-day merge; Process Dropzone / open folders from the menu
• Activity log — plain-English logs/activity.log beside the app install
• Planned: upload to WiGLE / WDGWars / WarDrift (WiGLE + WDGWars keys already live in Settings; WarDrift next)

Alpha 0.0.6 — run from source until a GitHub Release is published (packaging scripts and Actions are in the repo).

---

Download

Releases are not published yet (alpha 0.0.6). When they exist:

1. Open this repository’s Releases page.
2. Download the file for your OS:
   • Windows portable — …-windows-portable.zip (extract and run the .exe)
   • Windows installer — …-windows-setup.exe (run the Setup wizard)
   • Mac — …-mac-apple-silicon.tar.gz or …-mac-intel.tar.gz
   • Linux — …-<distro>.tar.gz (e.g. …-ubuntu.tar.gz)
3. Extract if needed, then run Wardrive Log Visualizer.

Until then, run from source (see CONTRIBUTING.md).

---

How to use

1. Drop a CSV onto the square on the left, or use File → Add logs. Loaded files appear under the square. Toggle a file off to hide it from the map without removing it; toggle it back on to load it again. × on the right drops it from the list entirely. File → Clear log unloads everything.
2. The app merges the files that are on, keeps every logged row, and stitches them by FirstSeen. Points are drawn from those coordinates. Adding another log refits the map around everything loaded so far.
3. Scroll to zoom toward the cursor. Drag to move the map. Click a point to read its fields. Previous, Next, or the arrow keys move through the visible log. Type a MAC or BSSID, or part of one, and press Find (or Enter) to center on the oldest matching sighting. Previous and Next then walk the other times that address was seen. Wi-Fi BSSIDs live in the MAC column. View → Fit map frames every point again; View → Center pans to the selection. View → Location estimates draws a diamond on the signal-weighted center of each MAC+Type that was heard at least twice (one log is enough; uncheck it to hide them). Click a diamond to read it. A listed MAC prefix adds a Known device line on that diamond and on a logged dot. Click a type in the legend (WIFI, BLE, LTE, NR) to hide or show it — gray means off.
4. File → Combine merges and saves. Clean blacklists each enabled file and writes {name} CLEAN.csv only when something was removed (no hits → skip that file; multiple hits → pick a folder). Clean and Combine merges first, then blacklists — always saves the merge; appends CLEAN only when rows were removed. Over the line cap on combine paths → Part N files.
5. File → Split CSV splits by the Settings line cap — map import never auto-splits.
6. Settings holds Dropzone/Cleared folders, pulse interval, Blacklist, keys, and activity log helpers. Automation → Process Dropzone runs one inbox pass immediately.

---

Tips

• Prefer WiGLE CSV 1.6 when sharing or uploading — it is the shared format for WiGLE and WDGWars CSV ingest.
• Keep real capture files out of the repo; use a local folder and gitignored paths.
• Counts match the CSV. An on-device app may show a higher “seen” total if it filters personal devices from the export.
• If a file fails to parse, the status line names it. The logs that loaded stay on the map.
• Drag-and-drop needs tkinterdnd2 (installed by scripts/setup_env). Add logs works without it.
• Local files next to the app (not on GitHub): settings.xml, blacklist.xml, logs/activity.log.
• Inbox / Dropzone only picks up top-level *.csv files. After a successful pass, sources become *.csv.done. Cleared outputs use Wardriving Log {Month} {DayOrdinal} {Year}.csv (and Part N if split) — no CLEAN word on automation titles. Blacklist still strips matching rows into Cleared. File → Clean / Clean and Combine append CLEAN only when the blacklist actually removed rows.

---

License

MIT — see LICENSE.

---

Contributing

Want to build from source or send a pull request? See CONTRIBUTING.md.