Skip to main content

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.

Scanner Tracker

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

airohunt_ng-1.0.2.tar.gz (27.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

airohunt_ng-1.0.2-py3-none-any.whl (26.3 kB view details)

Uploaded Python 3

File details

Details for the file airohunt_ng-1.0.2.tar.gz.

File metadata

  • Download URL: airohunt_ng-1.0.2.tar.gz
  • Upload date:
  • Size: 27.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.3

File hashes

Hashes for airohunt_ng-1.0.2.tar.gz
Algorithm Hash digest
SHA256 28dcf61b731c81cc9bc8f285029053bbfa8326c92e07109d289787e8ff021369
MD5 67dea733ef9d3402b3791b9a84612f70
BLAKE2b-256 b864def97cfda094e4017c33c4097d303afc7884cb1811f3051905bd7ffc4f97

See more details on using hashes here.

File details

Details for the file airohunt_ng-1.0.2-py3-none-any.whl.

File metadata

  • Download URL: airohunt_ng-1.0.2-py3-none-any.whl
  • Upload date:
  • Size: 26.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.3

File hashes

Hashes for airohunt_ng-1.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 80bdc3fcc8c665ed9cb21559dbe0021fc537d46bb5b90f7995e32de4ee7f9623
MD5 637ad4f0efc2039c7158a49dfb0125a8
BLAKE2b-256 ba2e324b9bb6b638cccb4a2883e8a5d0c4545fffc921f7c6949af25f28daf3ac

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page