802.11 monitor-mode Wi-Fi signal tracker with terminal UI
Project description
airohunt-ng
[!CAUTION] This software was almost entirely written by Claude.ai Sonnet 4.6
A terminal-based 802.11 Wi-Fi signal tracker for Linux that runs in monitor mode.
Displays access points, connected clients, and probe requests in a live three-pane interface, and lets you select any device to track its signal strength over time on a real-time graph.
Requirements
- monitor mode capable wireless interface
- tcpdump
- iw
- Python 3.8+
Installation
pip (recommended)
pip install airohunt-ng
Arch Linux (AUR)
yay -S airohunt-ng
From source
git clone https://github.com/bag-man/airohunt-ng
cd airohunt-ng
pip install .
Usage
First put your wireless interface into monitor mode:
sudo ip link set wlan0 down
sudo iw dev wlan0 set type monitor
sudo ip link set wlan0 up
Then run:
sudo airohunt-ng wlan0
Options
positional arguments:
interface Monitor-mode interface (e.g. wlan0)
options:
--band {2.4,5,both} Band to scan: 2.4 GHz (default), 5 GHz, or both
-c CH, --channel CH Lock to a single channel instead of hopping
--bssid MAC Go straight to the signal graph for this BSSID (requires -c)
-A Show Access Points pane only
-C Show Connected Clients pane only
-P Show Probes pane only
Pane flags may be combined: -AC shows Access Points and Connected Clients.
Key bindings
| Key | Action |
|---|---|
h / l or ← / → |
Switch active pane |
j / k or ↑ / ↓ |
Scroll within pane |
Enter |
Open signal graph for selected device |
Space |
Pause / resume scanning |
r |
Clear all results |
q |
Quit |
Inside the signal graph:
| Key | Action |
|---|---|
Space |
Pause / resume |
r |
Reset graph history |
Esc |
Back to scanner |
q |
Quit |
Encryption detection
Encryption is determined by parsing the raw beacon frame bytes (RSN and WPA IEs), not just the verbose tcpdump output. The ENC column shows one of:
| Value | Meaning |
|---|---|
OPN |
Open network |
WEP |
WEP (Privacy bit set, no WPA/RSN IE) |
WPA |
WPA1 (vendor IE 00:50:f2:01) |
WPA2-PSK |
WPA2 Personal (RSN IE, AKM type 2) |
WPA2-EAP |
WPA2 Enterprise (RSN IE, AKM type 1) |
WPA3-SAE |
WPA3 Personal (RSN IE, AKM type 8) |
WPA3-OWE |
WPA3 Enhanced Open (RSN IE, AKM type 18) |
WPA2/3 |
Transition mode (both PSK and SAE advertised) |
License
GNU General Public License v3.0 or later — see LICENSE.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file airohunt_ng-1.0.5.tar.gz.
File metadata
- Download URL: airohunt_ng-1.0.5.tar.gz
- Upload date:
- Size: 25.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ff3940df1d3f296d211235066daed8132725e42a6e3406898d59753df44b924d
|
|
| MD5 |
90479c9f3768f1d03aeccbb8ea2ad70f
|
|
| BLAKE2b-256 |
3a880cd676f4c2c83110f2c8ce496b4589083b51206b051a507279dfc6e1b93b
|
File details
Details for the file airohunt_ng-1.0.5-py3-none-any.whl.
File metadata
- Download URL: airohunt_ng-1.0.5-py3-none-any.whl
- Upload date:
- Size: 26.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c17e33f0e685fff654d81bf63c0fc238bf44dee9b208dfdee332af57e5d79ddf
|
|
| MD5 |
0df0e1c670857a1115f76b16830f4bf4
|
|
| BLAKE2b-256 |
a6dc37a79e86857ff7eb6eceb2126407644b07c95a8541b66613f773955f1ffc
|