# ezhil56x/wifi-deauthentication-tool architecture

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

- Interactive diagram: https://gitdiagram.com/ezhil56x/wifi-deauthentication-tool
- Repository: https://github.com/ezhil56x/wifi-deauthentication-tool

## Overview

##### Project type and purpose
- This is a small, single-script, command-line Wi-Fi deauthentication tool written in Bash.
- Purpose: Provide an interactive menu to scan for networks and perform deauth attacks (via airodump-ng/aireplay-ng) on clients or entire networks for educational/authorized penetration testing.

##### File structure
- Top-level files only:
- wifideauth.sh – the main Bash script implementing all functionality
- README.md – project overview and usage
- LICENSE – MIT license
- No subdirectories or modules; the script itself orchestrates:
- User input (menu)
- External tool invocation (aircrack-ng suite)
- Adapter management

##### README for additional insights
- Clearly lists features: network scan, select network, deauth single/all clients, adapter status/change.
- Prerequisites highlight external dependencies: airodump-ng and aireplay-ng on Linux.
- No built-in service layers or databases—purely procedural script.

##### Main components
a. Components
- User (CLI)
- wifideauth.sh (Bash Script – “Application Layer”)
- Aircrack-ng tools (airodump-ng, aireplay-ng – “Utility Layer”)
- Wireless Adapter & Driver (“Hardware/OS Layer”)
- Target Wi-Fi Network & Clients (“External Entities”)
b. Relationships & interactions
– User invokes wifideauth.sh
– Script parses user menu selection
– Script calls airodump-ng to scan networks → results parsed by script → user selects target
– Script calls aireplay-ng with appropriate flags to deauth selected client(s)
– Commands flow to the wireless adapter driver → over-the-air packets → target network/clients
c. Architectural patterns / design principles
– Single-responsibility: script handles menu, parsing, and orchestration
– Layered integration: CLI layer → orchestration layer (script) → utility/external tool layer → hardware layer → network
– Procedural flow, no concurrency or long-running services
d. Key technologies
– Bash shell scripting
– aircrack-ng suite (airodump-ng, aireplay-ng)
– Linux networking stack and wireless drivers

## Diagram (Mermaid)

```mermaid
graph TD
    %% Entities and Layers
    User["User (CLI)"]:::external

    subgraph "Application Layer"
        Script["wifideauth.sh"]:::app
    end

    subgraph "Utility Layer"
        Airo["airodump-ng"]:::tool
        Aire["aireplay-ng"]:::tool
    end

    subgraph "Hardware/OS Layer"
        Adapter["Wireless Adapter & Driver"]:::hardware
    end

    External["Wi-Fi Network & Clients"]:::external

    subgraph "Documentation"
        Readme["README.md"]:::doc
        License["LICENSE"]:::doc
    end

    %% Relationships
    User -->|"invoke_script"| Script
    Script -->|"calls_scan"| Airo
    Airo -->|"returns_results"| Script
    Script -->|"calls_deauth"| Aire
    Aire -->|"injects_packets"| Adapter
    Adapter -->|"over_the_air"| External
    Script -->|"shows_overview"| Readme
    Script -->|"shows_license"| License

    %% Click Events
    click Script "https://github.com/ezhil56x/wifi-deauthentication-tool/blob/main/./wifideauth.sh"
    click Readme "https://github.com/ezhil56x/wifi-deauthentication-tool/blob/main/./README.md"
    click License "https://github.com/ezhil56x/wifi-deauthentication-tool/tree/main/./LICENSE"

    %% Styles
    classDef app fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef tool fill:#90EE90,stroke:#333,stroke-width:1px
    classDef hardware fill:#D3D3D3,stroke:#333,stroke-width:1px
    classDef external fill:#FFA500,stroke:#333,stroke-width:1px
    classDef doc fill:#FFFFE0,stroke:#333,stroke-width:1px
```
