{"id":15132807,"url":"https://github.com/0000xffff/hcx-scripts","last_synced_at":"2025-10-26T23:43:15.925Z","repository":{"id":256075472,"uuid":"854245228","full_name":"0000xFFFF/hcx-scripts","owner":"0000xFFFF","description":"useful python scripts for cracking/processing WPA-PBKDF2-PMKID+EAPOL hashes and passwords.","archived":false,"fork":false,"pushed_at":"2025-02-08T01:53:30.000Z","size":404,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-26T08:51:38.102Z","etag":null,"topics":["cybersecurity","handshake","hashcat","hcxdumptool","hcxtools","password","password-recovery","pcap","pcapng","penetration-testing","python","python3","raspberry-pi","scapy","wifi-security","wlan","wordlist-generator","wpa","wpa2"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/0000xFFFF.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-09-08T18:52:29.000Z","updated_at":"2025-02-08T01:53:33.000Z","dependencies_parsed_at":"2024-09-17T04:21:04.954Z","dependency_job_id":"0e11d85b-cd78-4b5b-b40b-2aa2aed27ecc","html_url":"https://github.com/0000xFFFF/hcx-scripts","commit_stats":null,"previous_names":["0000xffff/hcx-scripts"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0000xFFFF%2Fhcx-scripts","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0000xFFFF%2Fhcx-scripts/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0000xFFFF%2Fhcx-scripts/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0000xFFFF%2Fhcx-scripts/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/0000xFFFF","download_url":"https://codeload.github.com/0000xFFFF/hcx-scripts/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246096779,"owners_count":20723017,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cybersecurity","handshake","hashcat","hcxdumptool","hcxtools","password","password-recovery","pcap","pcapng","penetration-testing","python","python3","raspberry-pi","scapy","wifi-security","wlan","wordlist-generator","wpa","wpa2"],"created_at":"2024-09-26T04:40:28.649Z","updated_at":"2025-10-26T23:43:15.918Z","avatar_url":"https://github.com/0000xFFFF.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# hcx-scripts\n\n[![Python 3.12.5](https://img.shields.io/badge/Python-3.12.5-yellow.svg)](http://www.python.org/download/)\n\nUseful python scripts for cracking/processing WPA-PBKDF2-PMKID+EAPOL hashes and passwords.\n\n## Installation\n\n### Requirements\n* python\n* [hashcat](https://github.com/hashcat/hashcat)\n* [hcxtools](https://github.com/ZerBea/hcxtools)\n* [hcxdumptool](https://github.com/ZerBea/hcxdumptool)\n* [hcx-fastgenlst](https://github.com/0000xFFFF/hcx-fastgenlst)\n\n### Requirements - pip\n* psutil\n* colorama\n* tabulate\n* scapy\n* getkey\n\n### Run before usage\n```sh\n./install.sh\n```\nThis will just `ln -sfr \u003cscripts\u003e /usr/local/bin/.`, some scripts depend on each other...\n\n## Processing hashes\n```sh\nhcx-info \u003chashes.txt\u003e    # display a nice table for hashes in file\n                         # (MACs, BSSIDs, ESSIDs, passwords, vendor info, ...)\n                         # fetches passwords from hashcat if any cracked hashes detected,\n                         # display vendor info with -v for all macs...\nhcx-cracker \u003chashes.txt\u003e # crack wifi passwords by using their essids\nhcx-potfile              # display a nice table for all hashcat passwords in potfile\n```\n\n#### Examples:\n```sh\n./hcx-info \u003chashes.txt\u003e\n```\n```\n#  TYPE   HASH             MAC AP        MAC CLIENT    ESSID             PASSWORD   \n-  -----  ------...------  ------------  ------------  ----------------  -----------\n1  EAPOL  195bf3...fb1ec7  4c72b90f32c6  f04f7cb94dfd  MyFast-Wifi       test1234     ...\n2  PMKID  d74192...6c0580  78f29ef71570  b8e4dfd8c840  Galaxy Internet   testing123   ...\n...\n```\n\n##### crack wifi passwords by using their essids\n```sh\n./hcx-cracker \u003chashes.txt\u003e -ab    # generates gen and run scripts\n./gen.sh                          # generates wordlists by network ESSID for each network\n./run.sh                          # runs hashcat with generated wordlists\n```\n\n## Capturing hashes with raspberry pi and hcxdumptool\n```sh\nhcx-rpidump                   # small script that starts hcxdumptool when wlan1\n                              # device is connected to raspberry pi\nhcx-rpidump-install           # make systemd service and start it\nhcx-rpidump-filtergen \u003cBSSID\u003e # filter your own network from attack\nhcx-rpidump-wmenu             # rasberry pi waveshare menu for starting hcxdumptool\n```\n\n## Generate password wordlists for cracking\nUse the newer version: [hcx-fastgenlst](https://github.com/0000xFFFF/hcx-fastgenlst)\n\n```sh\nhcx-genlst           # name + numer, number + name, number + name + number\nhcx-genlst-num8      # numbers from 00000000 to 99999999\nhcx-genlst-numcommon # common numbers (dates, etc.)\nhcx-genlst-upper8    # generate upper ascii with length 8\n```\n\n#### Examples:\n```sh\nhcx-genlst -lut123 -s steve\n# will generate a wordlist that has passwords like: steve66, 123Steve, 69STEVE69, ...\n# -l -- lower word variation\n# -u -- UPPER word variation\n# -t -- Title word variation\n# -1 -- word + int\n# -2 -- int + word\n# -3 -- int + word + int\n# ..... use -h to show other options...\n```\n\n## Reacon after cracking\n\n### Nearby\n```sh\nhcx-wifi            # airodump-ng clone written in python that shows you passwords of\n                    # nearby networks you have cracked with hashcat\nhcx-wifi-genpasslst # generate password csv list for hcx-wifi\n```\n\n#### Examples:\n```sh\n./hcx-wifi-genpasslst \u003chashes.txt\u003e \u003e \u003cpasslst.csv\u003e\n./hcx-wifi wlan1mon \u003cpasslst.csv\u003e\n```\n```\nCH  4 | 2024-09-07 22:46:13.812907 | COUNT: 21 | PASS: 10 (3) | SORT BY: ↓ PWR\n\u003e RESUMED CHANNEL HOPPER\n\nBSSID              ESSID             PASSWORD      PWR  LAST SEEN              #    CH\n-----------------  ----------------  ----------  -----  -------------------  ---  ----\n48:8E:EF:E6:55:22  My Home Network   password1     -37  2024-09-07 22:46:13    6     1   ...\n96:9A:4A:7E:7E:7E  Network Test 1    123456789     -51  2024-09-07 22:46:13   18     4   ...\n90:9A:4A:97:77:66  Super Fast AP     ...           -63  2024-09-07 22:46:13   20     4   ...\n...\n```\n\n### Bulk GeoLocate BSSIDs in hashes\nFirst install this tool: [abgl](https://github.com/0000xFFFF/apple-bssid-geoloc)\n```sh\nhcx-hashesabgl \u003chashes.txt\u003e | tee \u003cout.txt\u003e # get bssid locations in bulk from Apple's\n                                            # servers and output to stdout \u0026 out.txt file\n```\nUse the **leaflet_bulk_geolocator.html** from [abgl](https://github.com/0000xFFFF/apple-bssid-geoloc) to show **out.txt** locations on a map.\n\n\n## Scripts for maindb.txt\nCreate a **maindb.txt** file that stores the full path of your file that contains all your hashes.\n```sh\nhcx-cap   # extract info from newly captured cap/pcapng files\nhcx-new   # get newly captured hashes that are not in main hashes db\nhcx-fetch # grep hcx-info for main hashes db\n```\n\n## Disclaimer\nThe hcx-scripts are intended for educational purposes only.\nThe author is not responsible or liable for any misuse, illegal activity, or damage caused by the use of these scripts.\nUsers are solely responsible for ensuring compliance with applicable laws and regulations.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0000xffff%2Fhcx-scripts","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F0000xffff%2Fhcx-scripts","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0000xffff%2Fhcx-scripts/lists"}