# unknownx007/evilhack architecture

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

- Interactive diagram: https://gitdiagram.com/unknownx007/evilhack
- Repository: https://github.com/unknownx007/evilhack

## Overview

EVILHack is a local web-panel and browser-automation tool that the README describes as demonstrating QR-login jacking against WhatsApp and TikTok. Its principal workflow starts a local server and a platform-specific browser session, then presents a synchronized panel; TikTok also has a phone-mode branch. The graph focuses on component boundaries and documented relationships, not operational instructions. The templates’ internals and portions of main.py were not sampled, so their detailed behavior is not inferred.

Main entry points: [`main.py`](https://github.com/unknownx007/evilhack/blob/main/main.py) (Control menu), [`server.py`](https://github.com/unknownx007/evilhack/blob/main/server.py) (HTTP server), [`templates/index.html`](https://github.com/unknownx007/evilhack/blob/main/templates/index.html) (WhatsApp panel), [`templates/tiktok.html`](https://github.com/unknownx007/evilhack/blob/main/templates/tiktok.html) (TikTok panel)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_control["Operator control"]
  node_menu["Control menu<br/>[main.py]"]
end

subgraph group_automation["Browser automation"]
  node_wa_flow["WhatsApp flow<br/>[main.py]"]
  node_tt_flow["TikTok flow<br/>[main.py]"]
  node_chrome["Chrome browser"]
end

subgraph group_panel["Local panels"]
  node_http_server["HTTP server<br/>[server.py]"]
  node_shared_state["Automation state<br/>[server.py]"]
  node_wa_panel["WhatsApp panel<br/>[index.html]"]
  node_tt_panel["TikTok panel<br/>[tiktok.html]"]
end

node_operator(("Operator"))
node_wa_site["WhatsApp Web"]
node_tt_site["TikTok login"]

node_operator -->|"selects mode"| node_menu
node_menu -->|"starts server"| node_http_server
node_menu -->|"starts flow"| node_wa_flow
node_menu -->|"starts flow"| node_tt_flow
node_wa_flow -->|"drives browser"| node_chrome
node_tt_flow -->|"drives browser"| node_chrome
node_wa_flow -->|"opens site"| node_wa_site
node_tt_flow -->|"opens site"| node_tt_site
node_wa_flow -->|"reads mode"| node_shared_state
node_tt_flow -->|"reads mode"| node_shared_state
node_http_server -->|"updates state"| node_shared_state
node_http_server -->|"serves panel"| node_wa_panel
node_http_server -->|"serves panel"| node_tt_panel

click node_menu "https://github.com/unknownx007/evilhack/blob/main/main.py"
click node_wa_flow "https://github.com/unknownx007/evilhack/blob/main/main.py"
click node_tt_flow "https://github.com/unknownx007/evilhack/blob/main/main.py"
click node_http_server "https://github.com/unknownx007/evilhack/blob/main/server.py"
click node_shared_state "https://github.com/unknownx007/evilhack/blob/main/server.py"
click node_wa_panel "https://github.com/unknownx007/evilhack/blob/main/templates/index.html"
click node_tt_panel "https://github.com/unknownx007/evilhack/blob/main/templates/tiktok.html"

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_menu toneBlue
class node_wa_flow,node_tt_flow,node_chrome toneAmber
class node_http_server,node_shared_state,node_wa_panel,node_tt_panel toneMint
class node_operator,node_wa_site,node_tt_site toneIndigo
```

## Components

### Operator control

- [Control menu](https://github.com/unknownx007/evilhack/blob/main/main.py): `main.py`

### Browser automation

- [WhatsApp flow](https://github.com/unknownx007/evilhack/blob/main/main.py): `main.py`
- [TikTok flow](https://github.com/unknownx007/evilhack/blob/main/main.py): `main.py`
- **Chrome browser**

### Local panels

- [HTTP server](https://github.com/unknownx007/evilhack/blob/main/server.py): `server.py`
- [Automation state](https://github.com/unknownx007/evilhack/blob/main/server.py): `server.py`
- [WhatsApp panel](https://github.com/unknownx007/evilhack/blob/main/templates/index.html): `templates/index.html`
- [TikTok panel](https://github.com/unknownx007/evilhack/blob/main/templates/tiktok.html): `templates/tiktok.html`

### Other components

- **Operator**
- **WhatsApp Web**
- **TikTok login**

## Connections

- Operator → Control menu: selects mode (evidence: `README.md`)
- Control menu → HTTP server: starts server (evidence: `main.py`)
- Control menu → WhatsApp flow: starts flow (evidence: `main.py`)
- Control menu → TikTok flow: starts flow (evidence: `main.py`)
- WhatsApp flow → Chrome browser: drives browser (evidence: `main.py`)
- TikTok flow → Chrome browser: drives browser (evidence: `main.py`)
- WhatsApp flow → WhatsApp Web: opens site (evidence: `main.py`)
- TikTok flow → TikTok login: opens site (evidence: `main.py`)
- WhatsApp flow → Automation state: reads mode (evidence: `main.py`)
- TikTok flow → Automation state: reads mode (evidence: `main.py`)
- HTTP server → Automation state: updates state (evidence: `server.py`)
- HTTP server → WhatsApp panel: serves panel (evidence: `README.md`)
- HTTP server → TikTok panel: serves panel (evidence: `README.md`)
