# konpep-dev/aether-rt architecture

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

- Interactive diagram: https://gitdiagram.com/konpep-dev/aether-rt
- Repository: https://github.com/konpep-dev/aether-rt

## Overview

Aether-RT is a Windows remote-administration system with a Controller, an Executor on managed machines, MQTT coordination, and a WebSocket relay for remote desktop and file operations. The principal workflow is operator command → Controller → MQTT → Executor → command result; desktop and file-management sessions use the relay. The graph also preserves README-documented analytics, security/elevation, persistence, screenshot, and proxy capabilities. Some capabilities are documented but not demonstrated in the excerpts, so their links are attributed to the README; unsampled implementation details are not inferred.

Main entry points: [`relay_server.py`](https://github.com/konpep-dev/aether-rt/blob/main/relay_server.py) (WebSocket Relay), [`Executor/Program.cs`](https://github.com/konpep-dev/aether-rt/blob/main/Executor/Program.cs) (Executor), [`Controller/Program.cs`](https://github.com/konpep-dev/aether-rt/blob/main/Controller/Program.cs) (Controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_operator["Operator Interface"]
  node_stats["Live Analytics<br/>[Program.cs]"]
end

subgraph group_coordination["Command Coordination"]
  node_controller["Controller<br/>[Program.cs]"]
  node_mqtt(("MQTT Broker"))
end

subgraph group_remote["Remote Sessions"]
  node_relay["WebSocket Relay<br/>[relay_server.py]"]
  node_vnc["Hidden VNC<br/>[Program.cs]"]
  node_vncviewer["VNC Viewer<br/>[Program.cs]"]
  node_fileops["File Operations<br/>[Program.cs]"]
  node_fileui["File Manager UI<br/>[Program.cs]"]
end

subgraph group_endpoint["Endpoint Capabilities"]
  node_executor["Executor<br/>[Program.cs]"]
  node_discovery["Machine Discovery<br/>[Program.cs]"]
  node_remotecommands["Remote Commands<br/>[Program.cs]"]
  node_stealth["Stealth and Evasion<br/>[Program.cs]"]
  node_privilege["Privilege Elevation<br/>[Program.cs]"]
  node_persistence["Persistence<br/>[Program.cs]"]
  node_screenshots["Remote Screenshots<br/>[Program.cs]"]
  node_proxy["Network Proxy<br/>[Program.cs]"]
end

node_user(("Operator"))
node_discord(("Discord Webhook"))

node_user -->|"issues commands"| node_controller
node_controller -->|"publishes commands"| node_mqtt
node_mqtt -->|"delivers commands"| node_executor
node_executor -->|"publishes discovery"| node_mqtt
node_controller -->|"opens analytics"| node_stats
node_controller -->|"opens viewer"| node_vncviewer
node_vncviewer -->|"exchanges session data"| node_relay
node_executor -->|"starts desktop session"| node_vnc
node_vnc -->|"sends frames"| node_relay
node_relay -->|"forwards frames"| node_vncviewer
node_vncviewer -->|"sends input"| node_relay
node_relay -->|"forwards input"| node_vnc
node_user -->|"requests file access"| node_fileui
node_fileui -->|"sends file commands"| node_relay
node_relay -->|"forwards commands"| node_fileops
node_fileops -->|"returns file data"| node_relay
node_relay -->|"forwards responses"| node_fileui
node_executor -->|"executes requests"| node_remotecommands
node_executor -->|"applies protections"| node_stealth
node_executor -->|"offers elevation"| node_privilege
node_executor -->|"maintains access"| node_persistence
node_user -->|"requests capture"| node_screenshots
node_screenshots -->|"sends captures"| node_discord
node_executor -->|"handles proxy requests"| node_proxy

click node_controller "https://github.com/konpep-dev/aether-rt/blob/main/Controller/Program.cs"
click node_executor "https://github.com/konpep-dev/aether-rt/blob/main/Executor/Program.cs"
click node_relay "https://github.com/konpep-dev/aether-rt/blob/main/relay_server.py"
click node_vnc "https://github.com/konpep-dev/aether-rt/blob/main/Executor/Program.cs"
click node_vncviewer "https://github.com/konpep-dev/aether-rt/blob/main/Controller/Program.cs"
click node_fileops "https://github.com/konpep-dev/aether-rt/blob/main/Executor/Program.cs"
click node_fileui "https://github.com/konpep-dev/aether-rt/blob/main/Controller/Program.cs"
click node_stats "https://github.com/konpep-dev/aether-rt/blob/main/Controller/Program.cs"
click node_discovery "https://github.com/konpep-dev/aether-rt/blob/main/Executor/Program.cs"
click node_remotecommands "https://github.com/konpep-dev/aether-rt/blob/main/Executor/Program.cs"
click node_stealth "https://github.com/konpep-dev/aether-rt/blob/main/Executor/Program.cs"
click node_privilege "https://github.com/konpep-dev/aether-rt/blob/main/Executor/Program.cs"
click node_persistence "https://github.com/konpep-dev/aether-rt/blob/main/Executor/Program.cs"
click node_screenshots "https://github.com/konpep-dev/aether-rt/blob/main/Executor/Program.cs"
click node_proxy "https://github.com/konpep-dev/aether-rt/blob/main/Executor/Program.cs"

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_stats toneBlue
class node_controller,node_mqtt toneAmber
class node_relay,node_vnc,node_vncviewer,node_fileops,node_fileui,node_discord toneMint
class node_executor,node_discovery,node_remotecommands,node_stealth,node_privilege,node_persistence,node_screenshots,node_proxy toneRose
class node_user toneIndigo
```

## Components

### Operator Interface

- [Live Analytics](https://github.com/konpep-dev/aether-rt/blob/main/Controller/Program.cs): `Controller/Program.cs`

### Command Coordination

- [Controller](https://github.com/konpep-dev/aether-rt/blob/main/Controller/Program.cs): `Controller/Program.cs`
- **MQTT Broker**

### Remote Sessions

- [WebSocket Relay](https://github.com/konpep-dev/aether-rt/blob/main/relay_server.py): `relay_server.py`
- [Hidden VNC](https://github.com/konpep-dev/aether-rt/blob/main/Executor/Program.cs): `Executor/Program.cs`
- [VNC Viewer](https://github.com/konpep-dev/aether-rt/blob/main/Controller/Program.cs): `Controller/Program.cs`
- [File Operations](https://github.com/konpep-dev/aether-rt/blob/main/Executor/Program.cs): `Executor/Program.cs`
- [File Manager UI](https://github.com/konpep-dev/aether-rt/blob/main/Controller/Program.cs): `Controller/Program.cs`

### Endpoint Capabilities

- [Executor](https://github.com/konpep-dev/aether-rt/blob/main/Executor/Program.cs): `Executor/Program.cs`
- [Machine Discovery](https://github.com/konpep-dev/aether-rt/blob/main/Executor/Program.cs): `Executor/Program.cs`
- [Remote Commands](https://github.com/konpep-dev/aether-rt/blob/main/Executor/Program.cs): `Executor/Program.cs`
- [Stealth and Evasion](https://github.com/konpep-dev/aether-rt/blob/main/Executor/Program.cs): `Executor/Program.cs`
- [Privilege Elevation](https://github.com/konpep-dev/aether-rt/blob/main/Executor/Program.cs): `Executor/Program.cs`
- [Persistence](https://github.com/konpep-dev/aether-rt/blob/main/Executor/Program.cs): `Executor/Program.cs`
- [Remote Screenshots](https://github.com/konpep-dev/aether-rt/blob/main/Executor/Program.cs): `Executor/Program.cs`
- [Network Proxy](https://github.com/konpep-dev/aether-rt/blob/main/Executor/Program.cs): `Executor/Program.cs`

### Other components

- **Operator**
- **Discord Webhook**

## Connections

- Operator → Controller: issues commands (evidence: `README.md`)
- Controller → MQTT Broker: publishes commands (evidence: `Controller/Program.cs`)
- MQTT Broker → Executor: delivers commands (evidence: `README.md`)
- Executor → MQTT Broker: publishes discovery (evidence: `Executor/Program.cs`)
- Controller → Live Analytics: opens analytics (evidence: `Controller/Program.cs`)
- Controller → VNC Viewer: opens viewer (evidence: `Controller/Program.cs`)
- VNC Viewer → WebSocket Relay: exchanges session data (evidence: `README.md`)
- Executor → Hidden VNC: starts desktop session (evidence: `Executor/Program.cs`)
- Hidden VNC → WebSocket Relay: sends frames (evidence: `README.md`)
- WebSocket Relay → VNC Viewer: forwards frames (evidence: `relay_server.py`)
- VNC Viewer → WebSocket Relay: sends input (evidence: `Controller/Program.cs`)
- WebSocket Relay → Hidden VNC: forwards input (evidence: `relay_server.py`)
- Operator → File Manager UI: requests file access (evidence: `README.md`)
- File Manager UI → WebSocket Relay: sends file commands (evidence: `README.md`)
- WebSocket Relay → File Operations: forwards commands (evidence: `relay_server.py`)
- File Operations → WebSocket Relay: returns file data (evidence: `relay_server.py`)
- WebSocket Relay → File Manager UI: forwards responses (evidence: `relay_server.py`)
- Executor → Remote Commands: executes requests (evidence: `README.md`)
- Executor → Stealth and Evasion: applies protections (evidence: `Executor/Program.cs`)
- Executor → Privilege Elevation: offers elevation (evidence: `README.md`)
- Executor → Persistence: maintains access (evidence: `README.md`)
- Operator → Remote Screenshots: requests capture (evidence: `README.md`)
- Remote Screenshots → Discord Webhook: sends captures (evidence: `README.md`)
- Executor → Network Proxy: handles proxy requests (evidence: `Executor/Program.cs`)
