# aradhyacp/wifi-dos architecture

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

- Interactive diagram: https://gitdiagram.com/aradhyacp/wifi-dos
- Repository: https://github.com/aradhyacp/wifi-dos

## Overview

WiFi-DoS is a single-script, authorized wireless security-testing CLI. The principal workflow detects an interface, enters monitor mode, scans and displays access points, accepts a target, then launches deauthentication; exit cleanup removes CSV files and stops monitor mode. The README documents these capabilities, and main.py shows their orchestration in one file rather than separate modules. Relationships below are evidenced by that script; external tools and the operator are modeled separately.

Main entry points: [`main.py`](https://github.com/aradhyacp/wifi-dos/blob/main/main.py) (CLI orchestrator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Attack workflow"]
  node_cli["CLI orchestrator<br/>[main.py]"]
  node_toolcheck["Tool validation<br/>[main.py]"]
  node_interface["Interface detection<br/>[main.py]"]
  node_monitor["Monitor setup<br/>[main.py]"]
  node_scan["AP scanning<br/>[main.py]"]
  node_csvparse["CSV parsing<br/>[main.py]"]
  node_display["Network display<br/>[main.py]"]
  node_selection["Target selection<br/>[main.py]"]
  node_attack["Deauthentication<br/>[main.py]"]
end

subgraph group_cleanup["Exit cleanup"]
  node_cleanuphandler["Exit handler<br/>[main.py]"]
  node_csvcleanup["CSV cleanup<br/>[main.py]"]
end

node_operator(("Operator"))
node_airtools["Aircrack tools"]
node_wireless["Wireless adapter"]

node_operator -->|"runs"| node_cli
node_cli -->|"validates"| node_toolcheck
node_toolcheck -->|"checks tools"| node_airtools
node_cli -->|"detects"| node_interface
node_interface -->|"queries"| node_wireless
node_cli -->|"enables"| node_monitor
node_monitor -->|"runs airmon"| node_airtools
node_cli -->|"starts"| node_scan
node_scan -->|"runs airodump"| node_airtools
node_scan -->|"writes CSV"| node_csvparse
node_csvparse -->|"supplies APs"| node_display
node_cli -->|"prompts target"| node_selection
node_display -->|"presents choices"| node_selection
node_cli -->|"launches"| node_attack
node_attack -->|"runs aireplay"| node_airtools
node_attack -->|"uses interface"| node_wireless
node_cli -->|"registers"| node_cleanuphandler
node_cleanuphandler -->|"invokes"| node_csvcleanup
node_cleanuphandler -->|"stops monitor"| node_airtools

click node_cli "https://github.com/aradhyacp/wifi-dos/blob/main/main.py"
click node_toolcheck "https://github.com/aradhyacp/wifi-dos/blob/main/main.py"
click node_interface "https://github.com/aradhyacp/wifi-dos/blob/main/main.py"
click node_monitor "https://github.com/aradhyacp/wifi-dos/blob/main/main.py"
click node_scan "https://github.com/aradhyacp/wifi-dos/blob/main/main.py"
click node_csvparse "https://github.com/aradhyacp/wifi-dos/blob/main/main.py"
click node_display "https://github.com/aradhyacp/wifi-dos/blob/main/main.py"
click node_selection "https://github.com/aradhyacp/wifi-dos/blob/main/main.py"
click node_attack "https://github.com/aradhyacp/wifi-dos/blob/main/main.py"
click node_cleanuphandler "https://github.com/aradhyacp/wifi-dos/blob/main/main.py"
click node_csvcleanup "https://github.com/aradhyacp/wifi-dos/blob/main/main.py"

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_cli,node_toolcheck,node_interface,node_monitor,node_scan,node_csvparse,node_display,node_selection,node_attack toneBlue
class node_cleanuphandler,node_csvcleanup toneAmber
class node_operator,node_airtools,node_wireless toneIndigo
```

## Components

### Attack workflow

- [CLI orchestrator](https://github.com/aradhyacp/wifi-dos/blob/main/main.py): `main.py`
- [Tool validation](https://github.com/aradhyacp/wifi-dos/blob/main/main.py): `main.py`
- [Interface detection](https://github.com/aradhyacp/wifi-dos/blob/main/main.py): `main.py`
- [Monitor setup](https://github.com/aradhyacp/wifi-dos/blob/main/main.py): `main.py`
- [AP scanning](https://github.com/aradhyacp/wifi-dos/blob/main/main.py): `main.py`
- [CSV parsing](https://github.com/aradhyacp/wifi-dos/blob/main/main.py): `main.py`
- [Network display](https://github.com/aradhyacp/wifi-dos/blob/main/main.py): `main.py`
- [Target selection](https://github.com/aradhyacp/wifi-dos/blob/main/main.py): `main.py`
- [Deauthentication](https://github.com/aradhyacp/wifi-dos/blob/main/main.py): `main.py`

### Exit cleanup

- [Exit handler](https://github.com/aradhyacp/wifi-dos/blob/main/main.py): `main.py`
- [CSV cleanup](https://github.com/aradhyacp/wifi-dos/blob/main/main.py): `main.py`

### Other components

- **Operator**
- **Aircrack tools**
- **Wireless adapter**

## Connections

- Operator → CLI orchestrator: runs (evidence: `Readme.md`)
- CLI orchestrator → Tool validation: validates (evidence: `main.py`)
- Tool validation → Aircrack tools: checks tools (evidence: `main.py`)
- CLI orchestrator → Interface detection: detects (evidence: `main.py`)
- Interface detection → Wireless adapter: queries (evidence: `main.py`)
- CLI orchestrator → Monitor setup: enables (evidence: `main.py`)
- Monitor setup → Aircrack tools: runs airmon (evidence: `main.py`)
- CLI orchestrator → AP scanning: starts (evidence: `main.py`)
- AP scanning → Aircrack tools: runs airodump (evidence: `main.py`)
- AP scanning → CSV parsing: writes CSV (evidence: `main.py`)
- CSV parsing → Network display: supplies APs (evidence: `main.py`)
- CLI orchestrator → Target selection: prompts target (evidence: `main.py`)
- Network display → Target selection: presents choices (evidence: `main.py`)
- CLI orchestrator → Deauthentication: launches (evidence: `main.py`)
- Deauthentication → Aircrack tools: runs aireplay (evidence: `main.py`)
- Deauthentication → Wireless adapter: uses interface (evidence: `main.py`)
- CLI orchestrator → Exit handler: registers (evidence: `main.py`)
- Exit handler → CSV cleanup: invokes (evidence: `main.py`)
- Exit handler → Aircrack tools: stops monitor (evidence: `main.py`)
