Home › Documentation › Tools › gnulte-wifi
gnulte-wifi(8) — Wi-Fi disassociation testing
An 802.11 Deauthentication frame is crafted with the source MAC set to the access point's BSSID and the destination set to one station. The station assumes its router disconnected it and drops the Wi-Fi association — the same behaviour as a router's “kick client” control, reproduced for authorised testing.
Requirements
- Root.
- A wireless interface already in monitor mode
(
airmon-ng start wlan0oriw dev wlan0 set type monitor). GNULTE does not change the interface mode itself. - An adapter that supports injection; some cap injection rates (raise
--countif a single frame rarely lands).
Synopsis
sudo gnulte-wifi -i IFACE -a APBSSID -s STATIONMAC
sudo gnulte-wifi -i wlan0mon -a 00:0c:41:63:45:6a -s aa:bb:cc:dd:ee:ff
Options
| Option | Description |
|---|---|
-i, --interface IFACE | wireless interface in monitor mode (e.g. wlan0mon) |
-a, --ap MAC | access point BSSID (the router's MAC) |
-s, --station MAC | station to disconnect; ff:ff:ff:ff:ff:ff = every client on the BSSID |
--reason CODE | 802.11 deauth reason code (default 7 = STA leaving BSS) |
--count N | frames per burst (default 64) |
--delay SECONDS | seconds between bursts (repeat kicks a client that reconnects; default 5) |
--jitter-ms N | random 0–N ms delay before each frame — irregular timing defeats reconnect timers (0 = no jitter) |
--mix | rotate the reason code each burst (default on; off when --reason is given explicitly) |
--hop-channels | hop the adapter through a channel list after each burst, so a channel-hopping AP stays in range |
--channels LIST | hop list, comma-separated (default 1,6,11) |
--once | send a single burst and exit |
--duration SECONDS | auto-stop after N seconds (0 = until Ctrl+C) |
--force | skip interactive confirmations |
--no-banner | skip the banner (alias: --minimal) |
-q, --quiet | results only |
--settings | open the settings editor and exit |
--docs | print the safety documents and exit |
--reset-safety | remove the acceptance record and exit |
--version | print version and exit |
-h, --help | show the built-in help |
Examples
sudo gnulte-wifi -i wlan0mon -a 00:0c:41:63:45:6a -s aa:bb:cc:dd:ee:ff --once
sudo gnulte-wifi -i wlan0mon -a 00:0c:41:63:45:6a -s ff:ff:ff:ff:ff:ff --duration 60 --jitter-ms 150
Installation
Part of the GNULTE suite. Build and install everything at once;
git clone https://github.com/notmicrosoft2000-cmd/gnulte-go.git
cd gnulte-go
./build.sh # builds all eight binaries, runs go vet + go test ./...
sudo ./install.sh # installs to /usr/local/bin + safety docs
installs gnulte-wifi to /usr/local/bin/gnulte-wifi. See
installation for requirements.
Common errors
- Nothing is injected
- Check the interface is in monitor mode (
airmon-ng start/iw dev ... set type monitor); GNULTE does not switch the mode itself. - The station rarely drops
- Some adapters cap injection rates: raise
--count, add--jitter-ms, and repeat with--delay. - The client will not stay disconnected
- That is expected for a single burst — a station that rejoins is kicked again on the next burst, which is what
--delayrepeats.
Related tools
- gnulte — the wired equivalent: impair rather than disconnect
- gnulte-scan — identify the clients before testing them