# kimocoder/wifite2 architecture

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

- Interactive diagram: https://gitdiagram.com/kimocoder/wifite2
- Repository: https://github.com/kimocoder/wifite2

## Overview

##### Project type and purpose
- Wifite2 is an open-source Python command-line tool (“CLI orchestrator”) for automated wireless network auditing. It wraps and sequences calls to existing packet-capture and cracking tools (aircrack-ng suite, hashcat, reaver, bully, etc.).
- The README describes its role: scanning interfaces, enumerating targets, selecting attack methods (WPS, WPA, PMKID, WEP), invoking external tools, and collecting results.

##### File structure
- Top-level files:
- Dockerfile, setup.py/pyproject.toml/requirements.txt → packaging and build
- bin/wifite → thin wrapper to launch the main script
- wifite.py and wifite/ directory → application code
- tools/ and docs/ → helper scripts and documentation
- tests/ → unit tests and test fixtures
- .github/workflows → CI configuration
- In wifite/:
- args.py → argument parsing
- config.py → static configuration defaults
- attack/ → modules implementing each attack strategy
- tools/ → wrappers for each external system tool (airmon, airodump, etc.)
- model/ → data classes for targets, results, handshakes
- This layout shows a clear separation of concerns: CLI entry, core engine (argument parsing + orchestration), business logic (attack), external integrations (tool wrappers), domain model, and utilities.

##### README for additional insights
- Technical stack: Python 3.8+ (3.11+ recommended), setuptools, requirements.txt
- Dependencies: external wireless-audit tools (aircrack-ng suite, hashcat, reaver/bully, etc.)
- Features hint at architecture: modular attack methods, multi-tool validation, result management, verbose logging.

##### Detail
- Break out subcomponents where needed (e.g., separate the scanner wrapper from the cracker wrapper).
- Utility modules feeding into multiple components (shared logging, process manager).
- Configuration module as a central reference for defaults and user-supplied options.
- Test directory and CI workflows to illustrate the development pipeline.

## Diagram (Mermaid)

```mermaid
flowchart TD
  subgraph "CLI Layer"
    CLI_BIN["bin/wifite"]:::internal
    CLI_ROOT["wifite.py"]:::internal
    CLI_APP["wifite/wifite.py"]:::internal
  end

  subgraph "Argument Parsing"
    ARGS["args.py"]:::internal
  end

  subgraph "Configuration"
    CONFIG["config.py"]:::internal
  end

  subgraph "Core Engine"
    CONTROLLER["wifite/wifite.py"]:::internal
    ATTACK_MANAGER["attack/all.py"]:::internal
  end

  subgraph "Attack Modules"
    WPS["wps.py"]:::internal
    WPA["wpa.py"]:::internal
    PMKID["pmkid.py"]:::internal
    WEP["wep.py"]:::internal
  end

  subgraph "Tool Wrappers"
    AIRMON["airmon.py"]:::external
    AIRODUMP["airodump.py"]:::external
    AIRCRACK["aircrack.py"]:::external
    AIREPLAY["aireplay.py"]:::external
    REAVER["reaver.py"]:::external
    BULLY["bully.py"]:::external
    HASHCAT["hashcat.py"]:::external
    JOHN["john.py"]:::external
    COW["cowpatty.py"]:::external
    TSHARK["tshark.py"]:::external
    WASH["wash.py"]:::external
    MACCHANGER["macchanger.py"]:::external
    IPTOOL["ip.py"]:::external
    IW["iw.py"]:::external
    HOSTAPD["hostapd.py"]:::external
    DEP["dependency.py"]:::external
  end

  subgraph "Domain Models"
    TARGET["target.py"]:::internal
    CLIENT["client.py"]:::internal
    HANDSHAKE["handshake.py"]:::internal
    PMK_RES["pmkid_result.py"]:::internal
    WPA_RES["wpa_result.py"]:::internal
    WPS_RES["wps_result.py"]:::internal
    WEP_RES["wep_result.py"]:::internal
    RESULT["result.py"]:::internal
    IGNORE["ignored_result.py"]:::internal
    ATTACK_MODEL["attack.py"]:::internal
  end

  subgraph "Utilities"
    COLOR["color.py"]:::internal
    PROCESS["process.py"]:::internal
    SCANNER_UTIL["scanner.py"]:::internal
    TIMER["timer.py"]:::internal
    MEMORY["memory.py"]:::internal
    CRACK_UTIL["crack.py"]:::internal
    DBUP["dbupdater.py"]:::internal
    INPUT["input.py"]:::internal
  end

  subgraph "Data Stores"
    OUI(("ieee-oui.txt")):::datastore
    WORDLIST(("wordlist-probable.txt")):::datastore
    DOCS["docs/"]:::datastore
    FIXTURES["tests/files/"]:::datastore
  end

  subgraph "CI/CD"
    CIYML[".github/workflows/"]:::ci
  end

  CLI_BIN --> CLI_ROOT --> CLI_APP --> ARGS
  ARGS --> CONTROLLER
  CONFIG --> CONTROLLER
  CONTROLLER --> ATTACK_MANAGER
  ATTACK_MANAGER -->|"selects"| WPS
  ATTACK_MANAGER -->|"selects"| WPA
  ATTACK_MANAGER -->|"selects"| PMKID
  ATTACK_MANAGER -->|"selects"| WEP
  WPS -->|"uses"| AIRMON
  WPS -->|"uses"| AIRODUMP
  WPA -->|"uses"| AIRCRACK
  WPA -->|"uses"| HASHCAT
  PMKID -->|"uses"| COW
  WEP -->|"uses"| AIRCRACK
  WPS --> TARGET
  WPA --> HANDSHAKE
  PMKID --> PMK_RES
  WEP --> WEP_RES
  ATTACK_MANAGER --> ATTACK_MODEL
  CONTROLLER --> TARGET
  CONTROLLER --> RESULT
  CONTROLLER --> UTILITIES
  AIRMON --> PROCESS
  AIRODUMP --> PROCESS
  AIRCRACK --> PROCESS
  AIREPLAY --> PROCESS
  REAVER --> PROCESS
  BULLY --> PROCESS
  HASHCAT --> PROCESS
  JOHN --> PROCESS
  COW --> PROCESS
  TSHARK --> PROCESS
  WASH --> PROCESS
  MACCHANGER --> PROCESS
  IPTOOL --> PROCESS
  IW --> PROCESS
  HOSTAPD --> PROCESS
  DEP --> PROCESS
  CONTROLLER --> CONFIG
  ARGS --> INPUT
  CONTROLLER --> TIMER
  FIXTURES --> CIYML
  DOCS --> CIYML
  CIYML -->|"runs tests"| FIXTURES

  classDef internal fill:#D0E6FF,stroke:#0366d6
  classDef external fill:#D5E8D4,stroke:#22863a
  classDef datastore fill:#FFF2CC,stroke:#bf8c00
  classDef ci fill:#E1BEE7,stroke:#6f42c1

  click CLI_BIN "https://github.com/kimocoder/wifite2/tree/master/bin/wifite"
  click CLI_ROOT "https://github.com/kimocoder/wifite2/blob/master/wifite.py"
  click CLI_APP "https://github.com/kimocoder/wifite2/blob/master/wifite/wifite.py"
  click ARGS "https://github.com/kimocoder/wifite2/blob/master/wifite/args.py"
  click CONFIG "https://github.com/kimocoder/wifite2/blob/master/wifite/config.py"
  click CONTROLLER "https://github.com/kimocoder/wifite2/blob/master/wifite/wifite.py"
  click ATTACK_MANAGER "https://github.com/kimocoder/wifite2/blob/master/wifite/attack/all.py"
  click WPS "https://github.com/kimocoder/wifite2/blob/master/wifite/attack/wps.py"
  click WPA "https://github.com/kimocoder/wifite2/blob/master/wifite/attack/wpa.py"
  click PMKID "https://github.com/kimocoder/wifite2/blob/master/wifite/attack/pmkid.py"
  click WEP "https://github.com/kimocoder/wifite2/blob/master/wifite/attack/wep.py"
  click AIRMON "https://github.com/kimocoder/wifite2/blob/master/wifite/tools/airmon.py"
  click AIRODUMP "https://github.com/kimocoder/wifite2/blob/master/wifite/tools/airodump.py"
  click AIRCRACK "https://github.com/kimocoder/wifite2/blob/master/wifite/tools/aircrack.py"
  click AIREPLAY "https://github.com/kimocoder/wifite2/blob/master/wifite/tools/aireplay.py"
  click REAVER "https://github.com/kimocoder/wifite2/blob/master/wifite/tools/reaver.py"
  click BULLY "https://github.com/kimocoder/wifite2/blob/master/wifite/tools/bully.py"
  click HASHCAT "https://github.com/kimocoder/wifite2/blob/master/wifite/tools/hashcat.py"
  click JOHN "https://github.com/kimocoder/wifite2/blob/master/wifite/tools/john.py"
  click COW "https://github.com/kimocoder/wifite2/blob/master/wifite/tools/cowpatty.py"
  click TSHARK "https://github.com/kimocoder/wifite2/blob/master/wifite/tools/tshark.py"
  click WASH "https://github.com/kimocoder/wifite2/blob/master/wifite/tools/wash.py"
  click MACCHANGER "https://github.com/kimocoder/wifite2/blob/master/wifite/tools/macchanger.py"
  click IPTOOL "https://github.com/kimocoder/wifite2/blob/master/wifite/tools/ip.py"
  click IW "https://github.com/kimocoder/wifite2/blob/master/wifite/tools/iw.py"
  click HOSTAPD "https://github.com/kimocoder/wifite2/blob/master/wifite/tools/hostapd.py"
  click DEP "https://github.com/kimocoder/wifite2/blob/master/wifite/tools/dependency.py"
  click TARGET "https://github.com/kimocoder/wifite2/blob/master/wifite/model/target.py"
  click CLIENT "https://github.com/kimocoder/wifite2/blob/master/wifite/model/client.py"
  click HANDSHAKE "https://github.com/kimocoder/wifite2/blob/master/wifite/model/handshake.py"
  click PMK_RES "https://github.com/kimocoder/wifite2/blob/master/wifite/model/pmkid_result.py"
  click WPA_RES "https://github.com/kimocoder/wifite2/blob/master/wifite/model/wpa_result.py"
  click WPS_RES "https://github.com/kimocoder/wifite2/blob/master/wifite/model/wps_result.py"
  click WEP_RES "https://github.com/kimocoder/wifite2/blob/master/wifite/model/wep_result.py"
  click RESULT "https://github.com/kimocoder/wifite2/blob/master/wifite/model/result.py"
  click IGNORE "https://github.com/kimocoder/wifite2/blob/master/wifite/model/ignored_result.py"
  click ATTACK_MODEL "https://github.com/kimocoder/wifite2/blob/master/wifite/model/attack.py"
  click COLOR "https://github.com/kimocoder/wifite2/blob/master/wifite/util/color.py"
  click PROCESS "https://github.com/kimocoder/wifite2/blob/master/wifite/util/process.py"
  click SCANNER_UTIL "https://github.com/kimocoder/wifite2/blob/master/wifite/util/scanner.py"
  click TIMER "https://github.com/kimocoder/wifite2/blob/master/wifite/util/timer.py"
  click MEMORY "https://github.com/kimocoder/wifite2/blob/master/wifite/util/memory.py"
  click CRACK_UTIL "https://github.com/kimocoder/wifite2/blob/master/wifite/util/crack.py"
  click DBUP "https://github.com/kimocoder/wifite2/blob/master/wifite/util/dbupdater.py"
  click INPUT "https://github.com/kimocoder/wifite2/blob/master/wifite/util/input.py"
  click OUI "https://github.com/kimocoder/wifite2/blob/master/ieee-oui.txt"
  click WORDLIST "https://github.com/kimocoder/wifite2/blob/master/wordlist-probable.txt"
  click DOCS "https://github.com/kimocoder/wifite2/tree/master/docs/"
  click FIXTURES "https://github.com/kimocoder/wifite2/tree/master/tests/files/"
  click CIYML "https://github.com/kimocoder/wifite2/tree/master/.github/workflows/"
```
