# justcallmekoko/esp32marauder architecture

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

- Interactive diagram: https://gitdiagram.com/justcallmekoko/esp32marauder
- Repository: https://github.com/justcallmekoko/esp32marauder

## Overview

ESP32 Marauder is ESP32 firmware for Wi-Fi and Bluetooth offensive and defensive tools. Users operate it through the command line or device menus; those interfaces expose scanning, attacks, reconnaissance, CSI motion monitoring, and related workflows. Scan and reconnaissance components maintain device state and can use GPS and SD support for tracking and saved output. Display, settings, and assets support the device experience. The README confirms the product’s broad purpose, but does not document detailed runtime flows; edges below are limited to relationships visible in sampled files or the source index.

Main entry points: [`esp32_marauder/WiFiScan.cpp`](https://github.com/justcallmekoko/esp32marauder/blob/master/esp32_marauder/WiFiScan.cpp) (Wi-Fi and Bluetooth), [`esp32_marauder/CommandLine.h`](https://github.com/justcallmekoko/esp32marauder/blob/master/esp32_marauder/CommandLine.h) (Command line), [`esp32_marauder/MenuFunctions.cpp`](https://github.com/justcallmekoko/esp32marauder/blob/master/esp32_marauder/MenuFunctions.cpp) (Device menus), [`esp32_marauder/CsiMotionMonitor.cpp`](https://github.com/justcallmekoko/esp32marauder/blob/master/esp32_marauder/CsiMotionMonitor.cpp) (CSI monitor)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["User Interfaces"]
  node_cli["Command line<br/>[CommandLine.h]"]
  node_menu["Device menus<br/>[MenuFunctions.cpp]"]
end

subgraph group_radio["Radio Features"]
  node_wifi["Wi-Fi and Bluetooth<br/>[WiFiScan.cpp]"]
  node_csi["CSI monitor"]
  node_csi_model["Motion model<br/>[CsiMotionModel.cpp]"]
  node_recon["Recon missions<br/>[ReconMission.cpp]"]
  node_remoteid["Remote ID<br/>[WiFiScanRemoteId.h]"]
  node_portal["Evil Portal<br/>[EvilPortal.h]"]
end

subgraph group_data["Tracking and Storage"]
  node_gps["GPS interface<br/>[GpsInterface.cpp]"]
  node_sd["SD interface<br/>[SDInterface.cpp]"]
end

subgraph group_platform["Device Platform"]
  node_display["Display<br/>[Display.cpp]"]
  node_assets["UI assets<br/>[Assets.h]"]
  node_webserver["Async web server"]
  node_webhandler["Web handlers<br/>[WebHandlerImpl.h]"]
  node_settings[("Settings<br/>[settings.cpp]")]
  node_config["Device configuration<br/>[configs.h]"]
  node_memory["Memory guard<br/>[MemoryGuard.h]"]
  node_buffer["Buffer<br/>[Buffer.h]"]
  node_language["Language strings<br/>[lang_var.h]"]
end

node_user(("Device user"))

node_user -->|"enters commands"| node_cli
node_user -->|"uses menus"| node_menu
node_cli -->|"calls"| node_menu
node_cli -->|"dispatches scans"| node_wifi
node_cli -->|"dispatches missions"| node_recon
node_cli -->|"dispatches monitor"| node_csi
node_menu -->|"calls"| node_cli
node_menu -->|"uses monitor"| node_csi
node_wifi -->|"uses monitor"| node_csi
node_wifi -->|"uses missions"| node_recon
node_wifi -->|"uses decoding"| node_remoteid
node_csi -->|"uses model"| node_csi_model
node_wifi -->|"uses portal"| node_portal
node_portal -->|"uses server"| node_webserver
node_webserver -->|"uses handlers"| node_webhandler
node_wifi -->|"uses GPS"| node_gps
node_wifi -->|"uses storage"| node_sd
node_cli -->|"uses storage"| node_sd
node_display -->|"uses assets"| node_assets
node_display -->|"uses guard"| node_memory
node_menu -->|"uses strings"| node_language
node_cli -->|"uses settings"| node_settings
node_wifi -->|"uses settings"| node_settings
node_assets -->|"uses config"| node_config
node_buffer -->|"uses settings"| node_settings

click node_cli "https://github.com/justcallmekoko/esp32marauder/blob/master/esp32_marauder/CommandLine.h"
click node_menu "https://github.com/justcallmekoko/esp32marauder/blob/master/esp32_marauder/MenuFunctions.cpp"
click node_display "https://github.com/justcallmekoko/esp32marauder/blob/master/esp32_marauder/Display.cpp"
click node_assets "https://github.com/justcallmekoko/esp32marauder/blob/master/esp32_marauder/Assets.h"
click node_wifi "https://github.com/justcallmekoko/esp32marauder/blob/master/esp32_marauder/WiFiScan.cpp"
click node_csi "https://github.com/justcallmekoko/esp32marauder/blob/master/esp32_marauder/CsiMotionMonitor.cpp"
click node_csi_model "https://github.com/justcallmekoko/esp32marauder/blob/master/esp32_marauder/CsiMotionModel.cpp"
click node_recon "https://github.com/justcallmekoko/esp32marauder/blob/master/esp32_marauder/ReconMission.cpp"
click node_remoteid "https://github.com/justcallmekoko/esp32marauder/blob/master/esp32_marauder/WiFiScanRemoteId.h"
click node_portal "https://github.com/justcallmekoko/esp32marauder/blob/master/esp32_marauder/EvilPortal.h"
click node_webserver "https://github.com/justcallmekoko/esp32marauder/blob/master/libraries/ESPAsyncWebServer/src/ESPAsyncWebServer.h"
click node_webhandler "https://github.com/justcallmekoko/esp32marauder/blob/master/libraries/ESPAsyncWebServer/src/WebHandlerImpl.h"
click node_gps "https://github.com/justcallmekoko/esp32marauder/blob/master/esp32_marauder/GpsInterface.cpp"
click node_sd "https://github.com/justcallmekoko/esp32marauder/blob/master/esp32_marauder/SDInterface.cpp"
click node_settings "https://github.com/justcallmekoko/esp32marauder/blob/master/esp32_marauder/settings.cpp"
click node_config "https://github.com/justcallmekoko/esp32marauder/blob/master/esp32_marauder/configs.h"
click node_memory "https://github.com/justcallmekoko/esp32marauder/blob/master/esp32_marauder/MemoryGuard.h"
click node_buffer "https://github.com/justcallmekoko/esp32marauder/blob/master/esp32_marauder/Buffer.h"
click node_language "https://github.com/justcallmekoko/esp32marauder/blob/master/esp32_marauder/lang_var.h"

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_menu,node_user toneBlue
class node_wifi,node_csi,node_csi_model,node_recon,node_remoteid,node_portal toneAmber
class node_gps,node_sd toneMint
class node_display,node_assets,node_webserver,node_webhandler,node_settings,node_config,node_memory,node_buffer,node_language toneRose
```

## Components

### User Interfaces

- [Command line](https://github.com/justcallmekoko/esp32marauder/blob/master/esp32_marauder/CommandLine.h): `esp32_marauder/CommandLine.h`
- [Device menus](https://github.com/justcallmekoko/esp32marauder/blob/master/esp32_marauder/MenuFunctions.cpp): `esp32_marauder/MenuFunctions.cpp`

### Radio Features

- [Wi-Fi and Bluetooth](https://github.com/justcallmekoko/esp32marauder/blob/master/esp32_marauder/WiFiScan.cpp): `esp32_marauder/WiFiScan.cpp`
- [CSI monitor](https://github.com/justcallmekoko/esp32marauder/blob/master/esp32_marauder/CsiMotionMonitor.cpp): `esp32_marauder/CsiMotionMonitor.cpp`
- [Motion model](https://github.com/justcallmekoko/esp32marauder/blob/master/esp32_marauder/CsiMotionModel.cpp): `esp32_marauder/CsiMotionModel.cpp`
- [Recon missions](https://github.com/justcallmekoko/esp32marauder/blob/master/esp32_marauder/ReconMission.cpp): `esp32_marauder/ReconMission.cpp`
- [Remote ID](https://github.com/justcallmekoko/esp32marauder/blob/master/esp32_marauder/WiFiScanRemoteId.h): `esp32_marauder/WiFiScanRemoteId.h`
- [Evil Portal](https://github.com/justcallmekoko/esp32marauder/blob/master/esp32_marauder/EvilPortal.h): `esp32_marauder/EvilPortal.h`

### Tracking and Storage

- [GPS interface](https://github.com/justcallmekoko/esp32marauder/blob/master/esp32_marauder/GpsInterface.cpp): `esp32_marauder/GpsInterface.cpp`
- [SD interface](https://github.com/justcallmekoko/esp32marauder/blob/master/esp32_marauder/SDInterface.cpp): `esp32_marauder/SDInterface.cpp`

### Device Platform

- [Display](https://github.com/justcallmekoko/esp32marauder/blob/master/esp32_marauder/Display.cpp): `esp32_marauder/Display.cpp`
- [UI assets](https://github.com/justcallmekoko/esp32marauder/blob/master/esp32_marauder/Assets.h): `esp32_marauder/Assets.h`
- [Async web server](https://github.com/justcallmekoko/esp32marauder/blob/master/libraries/ESPAsyncWebServer/src/ESPAsyncWebServer.h): `libraries/ESPAsyncWebServer/src/ESPAsyncWebServer.h`
- [Web handlers](https://github.com/justcallmekoko/esp32marauder/blob/master/libraries/ESPAsyncWebServer/src/WebHandlerImpl.h): `libraries/ESPAsyncWebServer/src/WebHandlerImpl.h`
- [Settings](https://github.com/justcallmekoko/esp32marauder/blob/master/esp32_marauder/settings.cpp): `esp32_marauder/settings.cpp`
- [Device configuration](https://github.com/justcallmekoko/esp32marauder/blob/master/esp32_marauder/configs.h): `esp32_marauder/configs.h`
- [Memory guard](https://github.com/justcallmekoko/esp32marauder/blob/master/esp32_marauder/MemoryGuard.h): `esp32_marauder/MemoryGuard.h`
- [Buffer](https://github.com/justcallmekoko/esp32marauder/blob/master/esp32_marauder/Buffer.h): `esp32_marauder/Buffer.h`
- [Language strings](https://github.com/justcallmekoko/esp32marauder/blob/master/esp32_marauder/lang_var.h): `esp32_marauder/lang_var.h`

### Other components

- **Device user**

## Connections

- Device user → Command line: enters commands
- Device user → Device menus: uses menus
- Command line → Device menus: calls (evidence: `esp32_marauder/CommandLine.h`)
- Command line → Wi-Fi and Bluetooth: dispatches scans (evidence: `esp32_marauder/CommandLine.h`)
- Command line → Recon missions: dispatches missions (evidence: `esp32_marauder/CommandLine.h`)
- Command line → CSI monitor: dispatches monitor (evidence: `esp32_marauder/CommandLine.h`)
- Device menus → Command line: calls (evidence: `esp32_marauder/MenuFunctions.cpp`)
- Device menus → CSI monitor: uses monitor (evidence: `esp32_marauder/MenuFunctions.cpp`)
- Wi-Fi and Bluetooth → CSI monitor: uses monitor (evidence: `esp32_marauder/WiFiScan.cpp`)
- Wi-Fi and Bluetooth → Recon missions: uses missions (evidence: `esp32_marauder/WiFiScan.cpp`)
- Wi-Fi and Bluetooth → Remote ID: uses decoding (evidence: `esp32_marauder/WiFiScan.cpp`)
- CSI monitor → Motion model: uses model
- Wi-Fi and Bluetooth → Evil Portal: uses portal
- Evil Portal → Async web server: uses server (evidence: `esp32_marauder/EvilPortal.h`)
- Async web server → Web handlers: uses handlers (evidence: `libraries/ESPAsyncWebServer/src/ESPAsyncWebServer.h`)
- Wi-Fi and Bluetooth → GPS interface: uses GPS
- Wi-Fi and Bluetooth → SD interface: uses storage
- Command line → SD interface: uses storage (evidence: `esp32_marauder/CommandLine.h`)
- Display → UI assets: uses assets
- Display → Memory guard: uses guard
- Device menus → Language strings: uses strings (evidence: `esp32_marauder/MenuFunctions.cpp`)
- Command line → Settings: uses settings (evidence: `esp32_marauder/CommandLine.h`)
- Wi-Fi and Bluetooth → Settings: uses settings
- UI assets → Device configuration: uses config (evidence: `esp32_marauder/Assets.h`)
- Buffer → Settings: uses settings (evidence: `esp32_marauder/Buffer.h`)
