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.3.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.3-py3-none-any.whl (26.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: airohunt_ng-1.0.3.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.3.tar.gz
Algorithm Hash digest
SHA256 d211a4a2827fd905a46f9013f951c9af0a8ce14eddb013267ee4b5cc5459222d
MD5 1b369c77ccda7547685e6c64221404d4
BLAKE2b-256 70c6672f2497b1fc882f39c72a3dedf9c274535df1eaab83c047aa4455373cb2

See more details on using hashes here.

File details

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

File metadata

  • Download URL: airohunt_ng-1.0.3-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.3-py3-none-any.whl
Algorithm Hash digest
SHA256 b30ae58cbd8182ffdb20a4211c46fd7b513244d1810704de2468b441fe267fab
MD5 37dce5637f4b294cfac40843d612899b
BLAKE2b-256 2b14638c17403efa6601276677b94053ec72eb7954d5ae6781d75a87ddc3a4f2

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