<commit_before>hcxtools
==============

Small set of tools to capture (active and passive) and convert packets from WLAN devices
for the use with hashcat. The tools are 100% compatible with hashcat
and recommended by hashcat.

Brief description
--------------

Multiple stand-alone binaries.

All of these utils are designed to execute only one specific function.


Detailed description
--------------

| Tool          | Description                                                                                         |
| ------------- | --------------------------------------------------------------------------------------------------- |
| wlandump      | Small, fast and simple but powerfull active WLAN scanner (no status output)                         |
| wlanscan      | Small, fast and simple passive WLAN scanner (status output)                                         |
| pioff         | Turns Raspberry Pi off via GPIO switch                                                              |
| wlancap2hcx   | Converts cap to hccapx (recommended for use with wlandump - like cap2hccapx, but different options) |
| wlanhcx2cap   | Converts hccapx to cap                                                                              |
| wlanhc2hcx    | Converts hccap to hccapx                                                                            |
| wlanhcx2essid | Merges hccapx containing the same ESSID                                                             |
| wlanhcx2ssid  | Strips BSSID, ESSID, OUI                                                                            |
| wlanhcx2john  | Converts hccapx to format expected by John the Ripper                                               |
| wlanhcxinfo   | Shows detailed info from contents of hccapxfile                                                     |
| wlanhcxmnc    | Manually do nonce correction on byte number xx of a nonce                                           |
| whoismac      | Show vendor information                                                                             |
| pwhash        | Generate hash of a word by using a given charset                                                    |


Compile
--------------

Simply run:

```
make
make install
```

Use Makefile.pi to compile (wlandump) on Raspberry Pi

Use Makefile.pi.gpio to compile (wlandump and pioff) on Raspberry Pi (hardware mods required (gpiowait.odg))


Requirements
--------------

* Linux (recommended Arch, but other distros should work, too). Don't use Kernel 4.4 (rt2x00 driver regression)

* libpcap and pcap-dev installed

* libopenssl and openssl-dev installed

* libcurl and curl-dev installed (used by whoismac)

* Raspberry Pi: additionally libwiringpi and wiringpi dev installed (Raspberry Pi GPIO support)

* Chipset must be able to run in monitor mode. Recommended: RALINK chipset (good receiver sensitivity), rt2x00 driver (stable and fast)

* Raspberry Pi (Recommended: A, A+, B, B+ - A & A+ = very low power consumption)


Useful scripts
--------------

| Script       | Description                                              |
| ------------ | -------------------------------------------------------- |
| bash_profile | Autostart for Raspberry Pi (copy to /root/.bash_profile) |
| pireadcard   | Back up a Pi SD card                                     |
| piwritecard  | Restore a Pi SD card                                     |


Notice
--------------

Most output files will be appended to existing files (with the exception of .cap files).

<commit_msg>added missing dependency<commit_after>hcxtools
==============

Small set of tools to capture (active and passive) and convert packets from WLAN devices
for the use with hashcat. The tools are 100% compatible with hashcat
and recommended by hashcat.

Brief description
--------------

Multiple stand-alone binaries.

All of these utils are designed to execute only one specific function.


Detailed description
--------------

| Tool          | Description                                                                                         |
| ------------- | --------------------------------------------------------------------------------------------------- |
| wlandump      | Small, fast and simple but powerfull active WLAN scanner (no status output)                         |
| wlanscan      | Small, fast and simple passive WLAN scanner (status output)                                         |
| pioff         | Turns Raspberry Pi off via GPIO switch                                                              |
| wlancap2hcx   | Converts cap to hccapx (recommended for use with wlandump - like cap2hccapx, but different options) |
| wlanhcx2cap   | Converts hccapx to cap                                                                              |
| wlanhc2hcx    | Converts hccap to hccapx                                                                            |
| wlanhcx2essid | Merges hccapx containing the same ESSID                                                             |
| wlanhcx2ssid  | Strips BSSID, ESSID, OUI                                                                            |
| wlanhcx2john  | Converts hccapx to format expected by <NAME>                                               |
| wlanhcxinfo   | Shows detailed info from contents of hccapxfile                                                     |
| wlanhcxmnc    | Manually do nonce correction on byte number xx of a nonce                                           |
| whoismac      | Show vendor information                                                                             |
| pwhash        | Generate hash of a word by using a given charset                                                    |


Compile
--------------

Simply run:

```
make
make install
```

Use Makefile.pi to compile (wlandump) on Raspberry Pi

Use Makefile.pi.gpio to compile (wlandump and pioff) on Raspberry Pi (hardware mods required (gpiowait.odg))


Requirements
--------------

* Linux (recommended Arch, but other distros should work, too). Don't use Kernel 4.4 (rt2x00 driver regression)

* libpcap and pcap-dev installed

* libopenssl and openssl-dev installed

* libgcrypt and gcrypt-dev installed

* libcurl and curl-dev installed (used by whoismac)

* Raspberry Pi: additionally libwiringpi and wiringpi dev installed (Raspberry Pi GPIO support)

* Chipset must be able to run in monitor mode. Recommended: RALINK chipset (good receiver sensitivity), rt2x00 driver (stable and fast)

* Raspberry Pi (Recommended: A, A+, B, B+ - A & A+ = very low power consumption)


Useful scripts
--------------

| Script       | Description                                              |
| ------------ | -------------------------------------------------------- |
| bash_profile | Autostart for Raspberry Pi (copy to /root/.bash_profile) |
| pireadcard   | Back up a Pi SD card                                     |
| piwritecard  | Restore a Pi SD card                                     |


Notice
--------------

Most output files will be appended to existing files (with the exception of .cap files).


{'fraction_non_alphanumeric': 0.12126292260407935, 'fraction_numerical': 0.005029337803855826, 'mean_word_length': 1.1550270921131849, 'pattern_counts': {'":': 0, '<': 4, '<?xml version=': 0, '>': 4, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 64, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '1806335', 'n_tokens_mistral': 1621, 'n_tokens_neox': 1528, 'n_words': 628}