PAGES
← all tools
◆ Wireless & RF

hcxtools

2026-10-03 open-source

hcxtools converts packets from capture files to hash files for use with Hashcat or John the Ripper.

Summary

hcxtools is an open-source command-line toolset, free to use, that converts WiFi packet capturespacket capturesA packet capture, recorded network packets that can be inspected later. Analysts use it to reconstruct communication and investigate protocol behavior or suspicious traffic. (pcappcapA packet capture, recorded network packets that can be inspected later. Analysts use it to reconstruct communication and investigate protocol behavior or suspicious traffic., pcapng, cap) into hash formats readable by Hashcat and John the Ripper, letting someone check whether a WPAWPAA Wi-Fi authentication and encryption standard maintained by the Wi-Fi Alliance, replacing WEP; cyber tools target it to audit wireless network credentials and key exchange handshakes./WPA2 key or PMK was transmitted unencrypted. It targets people auditing their own wireless networks rather than general pentesters, and it is explicit about scope: it does not crack WPA PSKs, WEP, or WPS itself, and it does not decrypt traffic, deferring those jobs to Hashcat, JtR, aircrack-ng, Reaver, Bully, or Wireshark, which places it as a conversion and filtering step feeding into those tools rather than a competitor to any of them. It runs on Linux only, with no Windows, macOS, or Android support. First committed in 2017, it has 39 contributors and 137 commits in the past year, with its most recent release about six months ago.

hcxtools converts packets from capture files to hash files for use with Hashcat or John the Ripper.

How hcxtools helps

Was the WPA/WPA2 key or PMK for this network ever sent unencrypted?

converts the capture into the WPA-PBKDF2-PMKID+EAPOL hash format and lets that hash be checked, showing whether the key material appeared in the traffic rather than staying protected

Which of the hashes pulled from a capture are actually worth feeding to a cracking run?

filters the converted hash file down by user-specified criteria, so only the entries that meet those conditions carry forward

Is my access point or a connected client using a weak or guessable password?

produces the hash formats that Hashcat or John the Ripper accept, or the raw capture that can be submitted to an online password-recovery service, so the weakness check happens in those tools rather than here

Is this dump file too large to hand off conveniently?

writes its output with single-file gzip compression so the converted hash file can be stored or transferred compressed

all 14 features, with the evidence for each →

Languages

Not documented

Features

14 capabilities

Built from hcxtools's releases, docs, README and our own runs. “Seen” marks the month we first spotted a release the vendor didn't date. Group names and tags are our labels.

Compare with peers →

What hcxtools offers you

  • Command-line interface7
  • Offline mode1
All capabilities 14 capabilities
Weak password pattern generation shipped Generates simple passwords based on dictionary analysis from the wpa-sec dataset. 31 releases · 3 other sources · first seen Oct 2017

release 31 total

  • Adds --nmea-offset=<seconds> flag to hcxpcapngtool for specifying time offset between NMEA file and dump 2025-02-08 · Feb 2025 · source · release history
  • Adds --nmea-in=<file> flag to hcxpcapngtool for reading external NMEA 0183 GPS files 2025-02-08 · Feb 2025 · source · release history
  • Adds --genpattern to generate simple passwords based on wpa-sec dictionary analysis 6.3.2 · Nov 2023 · source · release history
  • Adds hcxpmktool binary (version 6.1.5-72-g585fe37) for calculating a PMK and verifying a 22000 hashline 2021-02-28 · Feb 2021 · source · release history
  • Adds -R <file> option to hcxpcapngtool to output an autohex-enabled wordlist derived from PROBEREQUEST frames. 2020-09-18 · Sep 2020 · source · release history
  • Adds --askeyarris flag to include weak MySpectrumWiFI / SpectrumSetup / MyCharterWiFI candidates in hcxpsktool 2020-06-19 · Jun 2020 · source · release history

example

  • Generate a list of likely weak passwords derived from the wpa-sec dataset. hcxpsktool --genpattern -o candidates.txt wpa_supplicant.conf 6.3.2 · Nov 2023 · source
  • Generate specialized wordlists from an input list to be used with hashcat rules on captured handshake data. $ hcxeiutool -i elist -d digitlist -x xdigitlist -c charlist -s sclist 2020-10-27 · Oct 2020 · source
  • Convert an ASCII network name (e.g., default) to its hex representation for hashcat lookup. whoismac -e default 2019-02-11 · Feb 2019 · source
Hash format conversion and compatibility shipped Converts hash files between different formats (e.g., John the Ripper, older/later hashcat versions) and captures PMKIDs in specific output formats for compatibility with external cracking tools. 14 releases · 2 other sources · first seen Feb 2019

release 14 total

  • The new hash file format is not backwards compatible with hashcat versions prior to commit 6847f7793f9cf76a5f01dde85894e5645800a30f — existing pipelines using older hashcat builds will break due to the new WPA*3 and WPA*4 hash lines and updated EAPOL limits. 8.0.0 · Oct 2026 · source · release history
  • Introduces new WPA*3 and WPA*4 hash line types with updated EAPOL limits, aligning with hashcat 8.0.0. 8.0.0 · Oct 2026 · source · release history
  • Adds --tabnhout flag to hcxpottool for tab-separated output with no hexification 2026-01-22 · Jan 2026 · source · release history
  • Renames the tab-separated output option to --tabspout, which hexifies characters below 0x20 or above 0x7e. 2026-01-22 · Jan 2026 · source · release history
  • Adds hcxpottool, a CLI tool for converting mixed-encoding hashcat output and pot files to ASCII-compatible pot or tab-separated output by hexifying non-printable characters. 2026-01-13 · Jan 2026 · source · release history
  • Changes the output options to --hccapx-out=<file> and --hccap-out=<file> for deprecated hccapx and ancient hccap formats. 2023-12-13 · Dec 2023 · source · release history

docs

  • Commits on Oct 9, 2026 removed debug printf fe29441 Commits on Oct 3, 2026 added information that the new 22000 hash file is not bacwards compatible with before commit https://github.com/hashcat/hashcat/commit/6847f7793f9cf76a5f01dde85894e5645800a30f 645bd5d added information that the new 22000 hash file is not… docs update · Oct 2026 · source
  • 169 workflow runs 169 workflow runs removed debug printf #472: fe29441 added information that the new 22000 hash file is not bacwards compat… #471: 645bd5d fixed parser bug #470: 397fd40 fixed parser bug #469: 16def48 finxed handling of jtr pot file #468: 8b52fbd refactored tabin #467: 106d3aa 30s 30s refactored… docs update · Oct 2026 · source
Offline capture processing and conversion shipped Provides standalone capabilities to process pcapng captures, convert them into hash formats compatible with external tools, and extract specific protocol data such as TACACS+ hashes. 8 releases · first seen Apr 2020

Also counts toward: Command-line interface, Offline mode

release 8 total

  • Adds support for WPA-FT-PSK (Fast BSS Transition Pre-Shared Key) hash capture and conversion.⁠︀︄︇︀︅︉︀︅︀︀︃︀︀︅︅︀︅︊︀︄︆︀︃︄⁠ 8.0.0 · Oct 2026 · source · release history
  • Sets a hard 512-byte EAPOL payload limit for hash mode 2200x in both hcxpcapngtool and hcxhastool 2026-10-03 · Oct 2026 · source · release history
  • Adds 2200x FT-PSK EAPOL hash mode support in hcxpcapngtool for generating hashcat-compatible output files 2026-10-03 · Oct 2026 · source · release history
  • Adds -f <file> flag to hcxpcapngtool for full conversion of FT-PSK PMKID and EAPOL hashes (hashcat mode 37100) 2026-03-25 · Mar 2026 · source · release history
  • hcxpcapngtool now detects RADIUS AUTHENTICATION (REQUEST), (CHALLENGE), and (ACCEPT) messages in PCAP files 2022-12-24 · Dec 2022 · source · release history
  • --eapleap flag in hcxpcapngtool now covers both EAP LEAP and MSCHAPv2 CHALLENGE outputs (format 5500 / john netntlm), merging the previous separate options. 2020-10-13 · Oct 2020 · source · release history
Hash file merging and grouping shipped Merges multiple hash files (PMKID or HCCAPX) from different captures and groups them by ESSID to consolidate crack sets. 4 releases · first seen Sep 2019

Also counts toward: Command-line interface

release

  • Adds --hccapxgroupout=<file> to hcxessidtool for outputting ESSID groups from ESSIDs present in HCCAPX1 2019-09-24 · Sep 2019 · source · release history
  • Adds --pmkid1, --pmkid2, --pmkidout12, --pmkidout1, --pmkidout2, and --pmkidout options for PMKID file merging and filtering in hcxessidtool 2019-09-12 · Sep 2019 · source · release history
  • Adds --hccapx1, --hccapx2, --hccapxout12, --hccapxout1, --hccapxout2, and --hccapxout options for HCCAPX file merging and filtering in hcxessidtool 2019-09-12 · Sep 2019 · source · release history
  • Adds hcxessidtool command-line utility to merge hash files by ESSID 2019-09-12 · Sep 2019 · source · release history
Packet filtering and validation shipped Filters captured packets by specific criteria such as MAC address, ESSID, replay count, frame validity (fake frames), or key type to ensure data quality during processing. 4 releases · first seen Jun 2019

release

  • Adds --replaycountcheck option to hcxpcaptool to convert only frames verified by replaycount check. 2019-08-09 · Aug 2019 · source · release history
  • Adds --ignore-zeroed-pmks flag to hcxpcaptool to skip frames using a zeroed plainmasterkey (PMK) 2019-06-23 · Jun 2019 · source · release history
  • hcxpcaptool gains the --ignore-fake-frames option to skip processing of detected fake frames during conversion. 2019-06-16 · Jun 2019 · source · release history
  • hcxpcaptool gains the --filtermac=<mac> option to filter packets by a specific MAC address (format: 112233445566). 2019-06-07 · Jun 2019 · source · release history
Capture data export and visualization shipped Exports access point and capture metadata into CSV format for external analysis. 3 releases · first seen Dec 2020

Also counts toward: Command-line interface

release

  • Adds the --lts=<file> option to hcxpcapngtool, allowing users to store a BSSID list formatted with Linux timestamp, AP MAC, and ESSID for synchronization with external GPS data 2024-01-26 · Jan 2024 · source · release history
  • Adds -D <file> option to hcxpcapngtool to output a tab-delimited list of access points including MAC, MANUFACTURER, MODELNAME, SERIALNUMBER, DEVICENAME, and UUID. 2021-09-01 · Sep 2021 · source · release history
  • hcxpcapngtool gains a new CSV export feature for access point data. 2020-12-31 · Dec 2020 · source · release history
MAC address filtering and exclusion shipped Filters or excludes capture data based on specific MAC addresses or vendor names for both access points and client devices. 3 releases · first seen Mar 2021

Also counts toward: Command-line interface

release

  • Adds --vendor-ap=<VENDOR> flag to hcxhashtool for filtering Access Points by vendor name. 2021-08-27 · Aug 2021 · source · release history
  • Adds --vendor-client=<VENDOR> flag to hcxhashtool for filtering Client devices by vendor name. 2021-08-27 · Aug 2021 · source · release history
  • Adds --mac-skiplist=<file> flag to hcxhashtool to exclude MAC addresses from a file containing formats like 001122334455, 00:11:22:33:44:55, or 00-11-22-33-44-55. 2021-03-17 · Mar 2021 · source · release history
Optional dependency build flags documented Build-time feature flags let users enable or disable support for libcurl, OpenSSL, and zlib when compiling the tool. 2 other sources · first seen Aug 2026

docs

  • 431 option('curl', type: 'feature', description: 'Build tools relying on libcurl', option('openssl', type: 'feature', description: 'Build tools relying on OpenSSL', option('zlib', type: 'feature', description: 'Build with zlib support for hcxpcapngtool', docs update · Aug 2026 · source
  • 430 option ( ' curl ' , type : ' feature ' , description : ' Build tools relying on libcurl ' , option ( ' openssl ' , type : ' feature ' , description : ' Build tools relying on OpenSSL ' , option ( ' zlib ' , type : ' feature ' , description : ' Build with zlib support for hcxpcapngtool ' , seen Aug 2026 · source
Wordlist generation from capture data shipped Generates specialized wordlists derived from captured probe requests or input lists for use with cracking tools. 2 releases · first seen Sep 2020

Also counts toward: Command-line interface

release

  • Adds the new hcxeiutool command-line tool to generate specialized wordlists (digit, xdigit, character) from an input list for use by hashcat. 2020-10-27 · Oct 2020 · source · release history
  • Adds -R <file> option to hcxpcapngtool to output an autohex-enabled wordlist derived from PROBEREQUEST frames. 2020-09-18 · Sep 2020 · source · release history
ESSID filtering and constraints shipped Filters hashes based on specific ESSID names, lengths, or other constraints to reduce the search space for cracking. 1 release · 1 other source · first seen Sep 2019

release

  • Adds -e, -E, and -l filters to hcxessidtool for ESSID name and length constraints 2019-09-12 · Sep 2019 · source · release history

example

  • Filter PMKID file for specific ESSID length to reduce crack space hcxessidtool --pmkid1=file1.16800 -l 10 --pmkidout=filtered.16800 2019-09-12 · Sep 2019 · source
Directed probe request generation shipped Sends directed probe requests to specific access points on channel change. 2 releases · first seen Oct 2017

Also counts toward: Command-line interface

release

  • Adds -C <digit> flag to hcxdumptool for comma-separated channel scanlists (e.g. 1,3,5,7) 2018-01-12 · Jan 2018 · source · release history
  • Adds -U flag to send undirected proberequest on channel change in wlandump-ng 2017-10-28 · Oct 2017 · source · release history
Enhanced hash file information output shipped Provides extended capabilities for retrieving and displaying metadata, vendor details, and specific access point information from hash files. 1 release · first seen Aug 2021

release

  • hcxhashtool output modes extended with stdout targets for --info and --info-vendor flags 2021-08-28 · Aug 2021 · source · release history
Hash file inspection and metadata retrieval shipped Allows users to view detailed internal information about the contents of a specified hash file. 1 release · first seen Jan 2020

release

  • Adds --info=<file> and --info=stdout flags to hcxhashtool to output detailed information about the content of a specified hash file 2020-01-05 · Jan 2020 · source · release history
Disassociation capability shipped Sends disassociation frames to drop the connection of connected clients. 1 release · first seen Oct 2017

Also counts toward: Command-line interface

release

  • Adds -d flag to enable disassociation in wlandump-ng 2017-10-28 · Oct 2017 · source · release history

Lines in monospace are the tool's own words: help text parsed from its source, or an endpoint from its API document. Under release, a line is our summary of a dated release. Under docs, it is quoted from the tool's own documentation or website. Each links back to the source it came from.

Score card

  1. Shipping velocity releases a month, last 12 months
  2. Documentation quality release-notes rubric, 0–100
  3. Breaking-change discipline how rarely a release breaks users, and notice given
  4. Maintenance risk quiet time against its own cadence, maintainers
  5. Innovation & surface new capabilities, API and MCP surface
  6. Community health
  7. Contributor trend distinct committers, this year against last
  8. Maintainer concentration bus factor now against a year ago
  9. Issue backlog trend issues closed per issue opened, 12 months
  10. Responsiveness median time to a maintainer’s first reply

Nine scores for hcxtools, each built from the releases, notes and API history this site tracks — and, on Researcher and Business, where it stands among every measured tool in its category and how that has moved.

Score cards are part of every paid plan.

See plans →

Each score is 0–100 on a published rubric, derived from data this site already shows. A dimension we cannot measure says so — it is never scored 0 and never enters a rank.

How this is scored
  • Shipping velocity — releases a month over the last 12 months, on a log scale where 16 a month scores 100. Needs 3 releases in the window.
  • Documentation quality — the release-notes rubric published on the analytics page, unchanged.
  • Breaking-change discipline — the share of releases carrying a breaking change (none scores 100, half or more scores 0). Only projects that label breaking changes are measured: a clean record cannot be told from an unlabelled one.
  • Maintenance risk — quiet time measured against the tool's own release cadence (quiet longer than 90 days and three typical gaps scores 0), plus the number of active maintainers and whether contributors are growing, where known. Higher is lower risk.
  • Innovation & surface — new capabilities in the feature ledger this year, API and MCP operations added, and the share of commits that are features: the mean of whichever we hold.
  • Community health (open-source tools only) — each is a direction, not a size: contributors this year against last, the bus factor now against a year ago, and issues closed per issue opened, where steady scores 50, doubled 100 and halved 0; plus the median time to a maintainer's first reply (an hour scores about 100, a month or more 0). A commercial card has no repository and carries none of the four.
  • Documented delivery (commercial tools) — when a vendor's documented new capabilities have slowed against its own baseline, that counts against the overall standing as heavily as two low dimensions. Steady delivery, or too little history to judge, leaves the standing alone; it is never a sixth score.
  • Open-source tools are scored on repository signals; commercial tools on their published changelog. Ranks compare tools within one category and one profile and need at least five measured peers; the overall standing needs three ranked dimensions. Best-in-breed or consolidator is a shape, not a quality, and is never scored.

Release-note detail over time

See how much detail hcxtools puts in its release notes, quarter by quarter, and compare it with tracked tools in the same category. This history uses up to ten retained, reviewed notes per tool; sparse or blank older quarters may reflect that limit.

Checking release-note history…

Explore the full chart →

Releases

Show

54 entries

  1. October 20264
  2. August 20261
  3. March 20261
  4. January 20262
  5. February 20251
  6. January 20241
  7. December 20231
  8. November 20231
  9. May 20231
  10. December 20221
  11. September 20211
  12. August 20212
  13. March 20211
  14. February 20211
  15. December 20201
  16. October 20202
  17. September 20201
  18. June 20201
  19. May 20201
  20. April 20201
  21. January 20201
  22. September 20193
  23. August 20191
  24. June 20193
  25. May 20192
  26. April 20191
  27. March 20191
  28. February 20192
  29. January 20191
  30. December 20182
  31. September 20181
  32. July 20181
  33. March 20181
  34. February 20181
  35. January 20184
  36. December 20172
  37. October 20171
    Show

    54 entries

    Project health

    Issue, contributor and maintainer activity in ZerBea/hcxtools, 2023-10 – 2026-09, as of 2026-09-25. Twelve-month figures first; the trend lines run the whole window.

    1. Contributors 9 +4 vs prior 12 months
    2. Maintainers 1 +0 joined · −0 left, last 12 months
    3. Bus factor 1 committers behind half the commits
    4. Community-filed 100% of issues opened, last 12 months
    5. Median time to close < 1 day first maintainer reply 3.1 hours
    6. Open backlog 1 of 185 issues ever filed
    1. Issues opened / month 0 · 0 communitymaintainers
    2. Open backlog 1
    3. Contributors / month 1
    4. Commits / month 3
    5. Stars 2,446
    Issue themes, last 12 months
    • other 100%

    Counts from the project's public repository and git history; no individuals are identified. Maintainers are the committers covering 80% of the last year's commits. how we measure this

    Libraries its release ships

    What its latest release locks, checked against known advisories.

    None of its release's images build from a lockfile we can read.

    Add the badge to your README

    Maintain this project? The badge links readers straight to this page, so they can follow every release here.

    Tracked by Cyber Toolchain Choose a badge style and copy the code →
    browse all tools → score card for your toolchain →