Wi-Fi Network Scanner Desktop App

Anyone who has fought with slow Wi-Fi in a crowded apartment building has met the real problem this project addresses: dozens of access points shouting over each other on the same channels, with no visibility into which channel is actually free. Consumer devices just show signal bars; they never show that your router and four neighbors are all piled onto channel 6, or that a network claims WPA2 but is really running the broken WEP protocol. A proper Wi-Fi scanner exposes the radio facts — SSID, BSSID, RSSI in dBm, channel, band, width, security suite, vendor OUI — and aggregates them into channel utilization views that make congestion obvious. This project implements that as a real desktop application with passive scanning, live signal history, neighbor analysis and CSV export.

1. The app puts the wireless adapter into scan mode and issues channel-by-channel probe sweeps, collecting 802.11 beacon and probe-response frames.
2. Each frame is parsed for SSID, BSSID, RSSI, channel, band, channel width, supported rates and the RSN information element describing security.
3. The vendor is resolved from the BSSID's OUI prefix against a local lookup table.
4. Results are aggregated per channel to build the utilization graphs, counting networks and weighting by signal strength.
5. Selecting a network starts a 60-second RSSI sampler that plots signal history and refreshes the neighbor list on that channel.
6. Scans can be exported to CSV with timestamps for before/after comparisons when repositioning an access point.

Tech stack:

• Python 3
• PyQt6 · Qt (desktop UI)
• Scapy (802.11 frame parsing)
• SQLite (scan history)
• OUI vendor database
• Matplotlib-style custom canvas graphs
• PyInstaller (packaging)

• [Passive network discovery] Scans all 2.4 GHz and 5 GHz channels for beacon frames and lists every in-range access point with SSID and BSSID.
• [Signal strength in dBm] Real RSSI values with quality grading (excellent/good/fair/poor) instead of vague bars, sortable across networks.
• [Security auditing] Identifies WPA3, WPA2, open and legacy WEP networks at a glance, flagging weak configurations worth avoiding.
• [Channel utilization graphs] Per-band bar charts show how many networks crowd each channel, making the least-congested choice obvious.
• [Signal history tracking] Select a network to watch its RSSI plotted over the last 60 seconds — useful for finding dead spots by walking around.
• [Neighbor analysis] Lists co-channel and adjacent-channel networks with their signal levels to explain interference on a chosen channel.
• [CSV export] Save any scan with full details for reports, site surveys and documentation.

• Complete desktop application source code
• Installer and adapter setup guide
• Site-survey walkthrough document (how to read the graphs)
• Project report PDF (802.11 scanning, dBm math, channel overlap, security suites)
• PPT presentation for final review
• Viva Q&A preparation document (beacon frames, RSSI vs bars, WPA2 vs WPA3, channel bonding)

• The app is strictly passive — it never deauthenticates, cracks or connects to networks it does not own; it is a survey tool, not a penetration tool.
• Hidden SSIDs are shown as reported by probe responses; the app does not attempt to force their disclosure.
• 6 GHz (Wi-Fi 6E) needs a 6E-capable adapter and is supported only where the OS exposes the band.
• RSSI values vary between adapter chipsets — use them comparatively on one machine, not as absolute lab figures.
• Windows and macOS restrict raw monitor mode, so some advanced views are richest on Linux.
• Signal history is a 60-second rolling window, not a long-term logger.