Scan your wifi network and obtain troubleshooting details, with extreme granularity; using a colorful command-line tool with no technical skill necessary. (Assuming you are familiar with git, of course.)
Obtain the following details about your wifi connection:
Wifi statistics:
- SSID / wifi name / access point / router name you're connected to
- MAC address & manufacturer details
- Channel details; connection cipher/encryption for your connection
- Neighbor details:
- Nearby router / access point signal strength (in relation to you)
- Their router MAC & chip manufacturer info
- SSID (wifi name) and overall neighbor channel utilization
- What channel each router or AP is using
- How many routers/APs total are on that channel
Connectivity assessments:
- Connection detection
- Speed tests & packet loss
- IP & DNS information
- VPN detection
Optional, built-in enterprise capabilities:
Useful in scenarios where you're in a multi-access point environment; several APs carrying the same SSID but are posted in different locations throughout your campus.
- Determine whether or not you're on your organization's network / intranet
- Assign custom AP names to access points/routers at your organization (useful when determining which access point in your building is causing issues, such as channel overlap or evil twin attacks)
Compatible Operating Systems
| OS | Pre-prerequisite | Auto-Install (if not already in-use)? |
|---|---|---|
| Debian-based Linux | network-manager/nmcli | ☑️ |
| MacOS | brew | ☑️ |
| Windows 10 | Git, Bash | ❌ [details] |
| Test Option / Install Step | Image |
|---|---|
| Initial Setup |  |
| Main Menu |  |
| #2 (Extended: Basic + packet loss, IP & DNS information) |  |
| #3 (Basic + speed test only) |  |
| #5 (5g channel usage) |  |
| #6 (Access point + channel usage) - appearance varies by OS; Linux looks the coolest |  |
| Channel lookup (Linux only) |  |
- First Run Steps - How to install and use wiki
If you find this tool useful, you might also find these handy (both are currently for Linux only):
- wavemon - ncurses-based monitoring application for wireless network devices on Linux
- wifi-channel-watcher - Monitor channel usage of neighboring routers/access points & get an alert if your active channel is not optimal
There's a few cosmetic bugs that don't affect performance.
Original iteration of this application was written by my super cool boss.
I added cross-platform capabilities + enterprise AP customization, MAC lookups and channel details.