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.5.tar.gz (25.9 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.5-py3-none-any.whl (26.5 kB view details)

Uploaded Python 3

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

Hashes for airohunt_ng-1.0.5.tar.gz
Algorithm Hash digest
SHA256 ff3940df1d3f296d211235066daed8132725e42a6e3406898d59753df44b924d
MD5 90479c9f3768f1d03aeccbb8ea2ad70f
BLAKE2b-256 3a880cd676f4c2c83110f2c8ce496b4589083b51206b051a507279dfc6e1b93b

See more details on using hashes here.

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

Hashes for airohunt_ng-1.0.5-py3-none-any.whl
Algorithm Hash digest
SHA256 c17e33f0e685fff654d81bf63c0fc238bf44dee9b208dfdee332af57e5d79ddf
MD5 0df0e1c670857a1115f76b16830f4bf4
BLAKE2b-256 a6dc37a79e86857ff7eb6eceb2126407644b07c95a8541b66613f773955f1ffc

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