How to Capture a WPA Handshake
To recover a forgotten WiFi password, you need to capture the WPA 4-way handshake — a brief cryptographic exchange that happens when any device connects to your network. This guide covers two methods: hcxdumptool (recommended) and aircrack-ng.
Before you start
You need a WiFi adapter that supports monitor mode. Most built-in laptop adapters do not support this. A USB adapter based on the Realtek RTL8812AU or MediaTek MT7612U chipsets works well in 2026. You also need a Linux system (Ubuntu, Kali, or any distro).
Authorized use only. Every method and command on this page applies only to a WiFi network you own or have documented written permission to test. Capturing a handshake from, or attacking, any other network is illegal.
Method 1: hcxdumptool (Recommended)
hcxdumptool is purpose-built for WPA capture and is preferred in practice because it also captures PMKIDs without needing a client to reconnect — airodump-ng is handshake-only. It outputs .pcapng files, which hcxpcapngtool converts to the .hc22000 format that hashcat reads (Step 4).
Step 1 — Install hcxdumptool
# Ubuntu / Debian sudo apt update && sudo apt install hcxtools hcxdumptool # Kali Linux (usually pre-installed) sudo apt install hcxdumptool hcxtools
On Kali these are two separate packages: hcxdumptool is the capture tool, and hcxtools provides the hcxpcapngtool converter used in Step 4. The packaged version can lag the upstream CLI, so check hcxdumptool --help against the commands below.
Step 2 — Find your WiFi interface name
ip link show # Look for your WiFi adapter — typically wlan0, wlp3s0, or wlan1
The interface name will be used in all commands below. Replace wlan0 with your actual interface name.
Step 3 — Capture the handshake
# Stop NetworkManager from interfering sudo systemctl stop NetworkManager # Compile a filter that passes only YOUR access point (addr3 = the AP's BSSID) hcxdumptool --bpfc="wlan addr3 <your_ap_bssid>" > own-ap.bpf # Capture on your AP's channel, restricted to your AP by the filter above # (replace wlan0 with your interface, 6a with your AP's channel) sudo hcxdumptool -i wlan0 -w capture.pcapng -c 6a --bpf=own-ap.bpf # A few minutes is usually enough if you can make a device you control # reconnect on demand; otherwise expect to run much longer # Press Ctrl+C to stop when done
Your own BSSID only: run this against your own access point, or one you have documented written permission to test. hcxdumptool is an active tool — by default it hops channels and disassociates clients on every non-PMF access point in range, so the channel and the BPF filter above are what keep the run off other networks. Replace 6a with your AP's channel and band (band a = 2.4 GHz, b = 5 GHz), and add --disable_disassociation for a listen-only run.
While the capture runs, have a device you control reconnect to your WiFi network — the EAPOL handshake is captured during that connection. A PMKID, however, can often be captured with no client present at all, so a quiet capture can still succeed. Note: the --active_beacon flag was removed in hcxdumptool 6.x, and the pcapng output flag is -w (renamed from -o in hcxdumptool 6.3.0, so older tutorials' -o fails with an unrecognized option).
Step 4 — Convert to hashcat format (optional)
# Convert .pcapng to .hc22000 (hashcat modern format) hcxpcapngtool -o capture.hc22000 capture.pcapng # Check if handshake was captured cat capture.hc22000 | head -1 # Should start with: WPA*01* (PMKID) or WPA*02* (EAPOL handshake)
You can submit either the .pcapng or the .hc22000 to our recovery service. Both are supported.
Method 2: aircrack-ng + airodump-ng
The classic method using the aircrack-ng suite. Outputs a .cap file. Slightly more involved setup but widely documented.
Install aircrack-ng
sudo apt install aircrack-ng
Enable monitor mode
sudo airmon-ng check kill sudo airmon-ng start wlan0 # Interface is now typically called wlan0mon
Find your network's channel and BSSID
sudo airodump-ng wlan0mon # Find your network in the list # Note the BSSID (MAC address) and CH (channel) columns
Capture the handshake
# Your own network only — use your own router's BSSID and channel # Replace XX:XX:XX:XX:XX:XX with your router BSSID # Replace 6 with your network channel sudo airodump-ng -c 6 --bssid XX:XX:XX:XX:XX:XX -w capture wlan0mon # In another terminal, reconnect a device to your WiFi # When you see "WPA handshake: XX:XX:XX:XX:XX:XX" in the output, you're done # Press Ctrl+C to stop
The output file will be capture-01.cap. This file is ready to upload directly.
Troubleshooting
No handshake captured after several minutes
Interface doesn't support monitor mode
hcxdumptool: permission denied
hc22000 file is empty after conversion
Ready to submit your capture file?
Upload your .cap, .pcapng, or .hc22000 file to verify the handshake and submit for GPU recovery.