# ericpd/mr.wifibrute architecture

> Architecture diagram of the GitHub repository ericpd/mr.wifibrute, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ericpd/mr.wifibrute
- Repository: https://github.com/ericpd/mr.wifibrute

## Overview

This repository’s runtime product is a C utility that converts captured 802.11 PCAP files into Hashcat-compatible HCCAPX data. The README documents the surrounding workflow: Aircrack-ng captures a handshake, Hashcat tests it with a wordlist or mask and reports a recovered password. The source excerpt shows packet parsing and handshake-related data structures, but not all implementation details; the broader capture and cracking links are documented in the README.

Main entry points: [`mr.wifibrute.c`](https://github.com/ericpd/mr.wifibrute/blob/main/mr.wifibrute.c) (PCAP converter)

## Diagram (Mermaid)

```mermaid
flowchart TD

node_operator(("Operator"))
node_aircrack["Aircrack-ng tools"]
node_capture["Handshake capture"]
node_converter["PCAP converter<br/>[mr.wifibrute.c]"]
node_hccapx["HCCAPX file"]
node_pmkidtool["hcxpcaptool"]
node_pmkid["PMKID hash"]
node_hashcat["Hashcat"]
node_wordlist["Wordlist"]
node_password["Recovered password"]

node_operator -->|"runs capture"| node_aircrack
node_aircrack -->|"writes capture"| node_capture
node_operator -->|"runs conversion"| node_converter
node_capture -->|"reads PCAP"| node_converter
node_converter -->|"writes HCCAPX"| node_hccapx
node_operator -->|"runs conversion"| node_pmkidtool
node_capture -->|"reads capture"| node_pmkidtool
node_pmkidtool -->|"writes hash"| node_pmkid
node_operator -->|"runs cracking"| node_hashcat
node_hccapx -->|"supplies handshake"| node_hashcat
node_pmkid -->|"supplies hash"| node_hashcat
node_wordlist -->|"supplies candidates"| node_hashcat
node_hashcat -->|"reports match"| node_password

click node_converter "https://github.com/ericpd/mr.wifibrute/blob/main/mr.wifibrute.c"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_operator,node_aircrack,node_capture,node_hccapx,node_pmkidtool,node_pmkid,node_hashcat,node_wordlist,node_password toneIndigo
class node_converter toneTeal
```

## Components

### Other components

- **Operator**
- **Aircrack-ng tools**
- **Handshake capture**
- [PCAP converter](https://github.com/ericpd/mr.wifibrute/blob/main/mr.wifibrute.c): `mr.wifibrute.c`
- **HCCAPX file**
- **hcxpcaptool**
- **PMKID hash**
- **Hashcat**
- **Wordlist**
- **Recovered password**

## Connections

- Operator → Aircrack-ng tools: runs capture (evidence: `README.md`)
- Aircrack-ng tools → Handshake capture: writes capture (evidence: `README.md`)
- Operator → PCAP converter: runs conversion (evidence: `README.md`)
- Handshake capture → PCAP converter: reads PCAP (evidence: `README.md`)
- PCAP converter → HCCAPX file: writes HCCAPX (evidence: `README.md`)
- Operator → hcxpcaptool: runs conversion (evidence: `README.md`)
- Handshake capture → hcxpcaptool: reads capture (evidence: `README.md`)
- hcxpcaptool → PMKID hash: writes hash (evidence: `README.md`)
- Operator → Hashcat: runs cracking (evidence: `README.md`)
- HCCAPX file → Hashcat: supplies handshake (evidence: `README.md`)
- PMKID hash → Hashcat: supplies hash (evidence: `README.md`)
- Wordlist → Hashcat: supplies candidates (evidence: `README.md`)
- Hashcat → Recovered password: reports match (evidence: `README.md`)
