# the404hacking/androrat architecture

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

- Interactive diagram: https://gitdiagram.com/the404hacking/androrat
- Repository: https://github.com/the404hacking/androrat

## Overview

AndroRAT is an Android remote-administration client paired with a Java/Swing server. The principal workflow is an operator action in the server GUI, sent over the shared protocol to the Android client, dispatched to a device capability, and returned as data for server handlers and GUI panels. The README documents the product capabilities and boot/trigger behavior; the excerpts and source index establish selected runtime links. Several capability-specific implementations and server routes are unsampled, so those branches are shown at subsystem level and their connections cite the README rather than presumed call chains.

Main entry points: [`src/Androrat/src/my/app/client/ClientListener.java`](https://github.com/the404hacking/androrat/blob/master/src/Androrat/src/my/app/client/ClientListener.java) (Client command dispatch), [`src/AndroratServer/src/server/Server.java`](https://github.com/the404hacking/androrat/blob/master/src/AndroratServer/src/server/Server.java) (Server listener), [`src/AndroratServer/src/gui/GUI.java`](https://github.com/the404hacking/androrat/blob/master/src/AndroratServer/src/gui/GUI.java) (Server GUI), [`src/Androrat/src/my/app/client/Client.java`](https://github.com/the404hacking/androrat/blob/master/src/Androrat/src/my/app/client/Client.java) (Client service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_android["Android client"]
  node_launcher["Client launcher"]
  node_client["Client service<br/>[Client.java]"]
  node_triggers["Boot and triggers"]
  node_dispatch["Client command dispatch"]
  node_deviceinfo["Device information"]
  node_contacts["Contacts and call logs"]
  node_messages["SMS collection and monitor<br/>[SMSLister.java]"]
  node_callmonitor["Call monitoring<br/>[CallMonitor.java]"]
  node_location["GPS location<br/>[GPSListener.java]"]
  node_media["Camera and media streams<br/>[AudioStreamer.java]"]
  node_filesystem["Files and directories<br/>[DirLister.java]"]
end

subgraph group_protocol["Shared transport"]
  node_protocol["Protocol definitions<br/>[Protocol.java]"]
  node_packets["Packet formats<br/>[Packet.java]"]
  node_connection["Socket connection<br/>[Connection.java]"]
end

subgraph group_server["Server processing"]
  node_server["Server listener<br/>[Server.java]"]
  node_routing["Packet routing<br/>[PacketHandler.java]"]
  node_commandhandler["Command handling"]
  node_filehandler["File reception<br/>[FileHandler.java]"]
end

subgraph group_console["Operator console"]
  node_gui["Server GUI<br/>[GUI.java]"]
  node_panels["Client panels<br/>[HomePanel.java]"]
end

node_operator(("Operator"))

node_operator -->|"selects actions"| node_gui
node_gui -.->|"issues commands"| node_server
node_server -->|"dispatches packets"| node_commandhandler
node_commandhandler -->|"registers clients"| node_server
node_server -->|"routes packets"| node_routing
node_server -->|"reports status"| node_gui
node_gui -->|"opens client views"| node_panels
node_gui -.->|"requests capabilities"| node_server
node_server -->|"exchanges data"| node_connection
node_client -->|"connects and listens"| node_connection
node_launcher -->|"starts service"| node_client
node_triggers -->|"starts on events"| node_client
node_client -->|"receives instructions"| node_dispatch
node_dispatch -->|"runs capabilities"| node_deviceinfo
node_dispatch -->|"runs capabilities"| node_contacts
node_dispatch -->|"runs capabilities"| node_messages
node_dispatch -->|"runs capabilities"| node_callmonitor
node_callmonitor -->|"sends call events"| node_client
node_dispatch -->|"runs capabilities"| node_location
node_dispatch -->|"runs capabilities"| node_media
node_dispatch -->|"runs capabilities"| node_filesystem
node_connection -->|"uses framing"| node_protocol
node_protocol -->|"defines packet protocol"| node_packets
node_routing -.->|"routes file data"| node_filehandler
node_server -.->|"updates results"| node_panels
node_dispatch -->|"encodes responses"| node_protocol

click node_launcher "https://github.com/the404hacking/androrat/blob/master/src/Androrat/src/my/app/client/LauncherActivity.java"
click node_client "https://github.com/the404hacking/androrat/blob/master/src/Androrat/src/my/app/client/Client.java"
click node_triggers "https://github.com/the404hacking/androrat/blob/master/src/Androrat/src/my/app/client/ClientListener.java"
click node_dispatch "https://github.com/the404hacking/androrat/blob/master/src/Androrat/src/my/app/client/ClientListener.java"
click node_deviceinfo "https://github.com/the404hacking/androrat/blob/master/src/Androrat/src/my/app/Library/AdvancedSystemInfo.java"
click node_contacts "https://github.com/the404hacking/androrat/blob/master/src/Androrat/src/my/app/Library/ContactsLister.java"
click node_messages "https://github.com/the404hacking/androrat/blob/master/src/Androrat/src/my/app/Library/SMSLister.java"
click node_callmonitor "https://github.com/the404hacking/androrat/blob/master/src/Androrat/src/my/app/Library/CallMonitor.java"
click node_location "https://github.com/the404hacking/androrat/blob/master/src/Androrat/src/my/app/Library/GPSListener.java"
click node_media "https://github.com/the404hacking/androrat/blob/master/src/Androrat/src/my/app/Library/AudioStreamer.java"
click node_filesystem "https://github.com/the404hacking/androrat/blob/master/src/Androrat/src/my/app/Library/DirLister.java"
click node_protocol "https://github.com/the404hacking/androrat/blob/master/src/InOut/inout/Protocol.java"
click node_packets "https://github.com/the404hacking/androrat/blob/master/src/InOut/Packet/Packet.java"
click node_connection "https://github.com/the404hacking/androrat/blob/master/src/InOut/out/Connection.java"
click node_server "https://github.com/the404hacking/androrat/blob/master/src/AndroratServer/src/server/Server.java"
click node_routing "https://github.com/the404hacking/androrat/blob/master/src/AndroratServer/src/handler/PacketHandler.java"
click node_commandhandler "https://github.com/the404hacking/androrat/blob/master/src/AndroratServer/src/handler/CommandHandler.java"
click node_filehandler "https://github.com/the404hacking/androrat/blob/master/src/AndroratServer/src/handler/FileHandler.java"
click node_gui "https://github.com/the404hacking/androrat/blob/master/src/AndroratServer/src/gui/GUI.java"
click node_panels "https://github.com/the404hacking/androrat/blob/master/src/AndroratServer/src/gui/panel/HomePanel.java"

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_launcher,node_client,node_triggers,node_dispatch,node_deviceinfo,node_contacts,node_messages,node_callmonitor,node_location,node_media,node_filesystem toneBlue
class node_protocol,node_packets,node_connection toneAmber
class node_server,node_routing,node_commandhandler,node_filehandler toneMint
class node_gui,node_panels toneRose
class node_operator toneIndigo
```

## Components

### Android client

- [Client launcher](https://github.com/the404hacking/androrat/blob/master/src/Androrat/src/my/app/client/LauncherActivity.java): `src/Androrat/src/my/app/client/LauncherActivity.java`
- [Client service](https://github.com/the404hacking/androrat/blob/master/src/Androrat/src/my/app/client/Client.java): `src/Androrat/src/my/app/client/Client.java`
- [Boot and triggers](https://github.com/the404hacking/androrat/blob/master/src/Androrat/src/my/app/client/ClientListener.java): `src/Androrat/src/my/app/client/ClientListener.java`
- [Client command dispatch](https://github.com/the404hacking/androrat/blob/master/src/Androrat/src/my/app/client/ClientListener.java): `src/Androrat/src/my/app/client/ClientListener.java`
- [Device information](https://github.com/the404hacking/androrat/blob/master/src/Androrat/src/my/app/Library/AdvancedSystemInfo.java): `src/Androrat/src/my/app/Library/AdvancedSystemInfo.java`
- [Contacts and call logs](https://github.com/the404hacking/androrat/blob/master/src/Androrat/src/my/app/Library/ContactsLister.java): `src/Androrat/src/my/app/Library/ContactsLister.java`
- [SMS collection and monitor](https://github.com/the404hacking/androrat/blob/master/src/Androrat/src/my/app/Library/SMSLister.java): `src/Androrat/src/my/app/Library/SMSLister.java`
- [Call monitoring](https://github.com/the404hacking/androrat/blob/master/src/Androrat/src/my/app/Library/CallMonitor.java): `src/Androrat/src/my/app/Library/CallMonitor.java`
- [GPS location](https://github.com/the404hacking/androrat/blob/master/src/Androrat/src/my/app/Library/GPSListener.java): `src/Androrat/src/my/app/Library/GPSListener.java`
- [Camera and media streams](https://github.com/the404hacking/androrat/blob/master/src/Androrat/src/my/app/Library/AudioStreamer.java): `src/Androrat/src/my/app/Library/AudioStreamer.java`
- [Files and directories](https://github.com/the404hacking/androrat/blob/master/src/Androrat/src/my/app/Library/DirLister.java): `src/Androrat/src/my/app/Library/DirLister.java`

### Shared transport

- [Protocol definitions](https://github.com/the404hacking/androrat/blob/master/src/InOut/inout/Protocol.java): `src/InOut/inout/Protocol.java`
- [Packet formats](https://github.com/the404hacking/androrat/blob/master/src/InOut/Packet/Packet.java): `src/InOut/Packet/Packet.java`
- [Socket connection](https://github.com/the404hacking/androrat/blob/master/src/InOut/out/Connection.java): `src/InOut/out/Connection.java`

### Server processing

- [Server listener](https://github.com/the404hacking/androrat/blob/master/src/AndroratServer/src/server/Server.java): `src/AndroratServer/src/server/Server.java`
- [Packet routing](https://github.com/the404hacking/androrat/blob/master/src/AndroratServer/src/handler/PacketHandler.java): `src/AndroratServer/src/handler/PacketHandler.java`
- [Command handling](https://github.com/the404hacking/androrat/blob/master/src/AndroratServer/src/handler/CommandHandler.java): `src/AndroratServer/src/handler/CommandHandler.java`
- [File reception](https://github.com/the404hacking/androrat/blob/master/src/AndroratServer/src/handler/FileHandler.java): `src/AndroratServer/src/handler/FileHandler.java`

### Operator console

- [Server GUI](https://github.com/the404hacking/androrat/blob/master/src/AndroratServer/src/gui/GUI.java): `src/AndroratServer/src/gui/GUI.java`
- [Client panels](https://github.com/the404hacking/androrat/blob/master/src/AndroratServer/src/gui/panel/HomePanel.java): `src/AndroratServer/src/gui/panel/HomePanel.java`

### Other components

- **Operator**

## Connections

- Operator → Server GUI: selects actions
- Server GUI → Server listener: issues commands (evidence: `src/AndroratServer/src/server/Server.java`)
- Server listener → Command handling: dispatches packets (evidence: `src/AndroratServer/src/server/Server.java`)
- Command handling → Server listener: registers clients (evidence: `src/AndroratServer/src/handler/CommandHandler.java`)
- Server listener → Packet routing: routes packets (evidence: `src/AndroratServer/src/server/Server.java`)
- Server listener → Server GUI: reports status (evidence: `src/AndroratServer/src/server/Server.java`)
- Server GUI → Client panels: opens client views
- Server GUI → Server listener: requests capabilities (evidence: `src/AndroratServer/src/server/Server.java`)
- Server listener → Socket connection: exchanges data (evidence: `src/AndroratServer/src/server/Server.java`)
- Client service → Socket connection: connects and listens (evidence: `src/Androrat/src/my/app/client/Client.java`)
- Client launcher → Client service: starts service (evidence: `src/Androrat/src/my/app/client/LauncherActivity.java`)
- Boot and triggers → Client service: starts on events (evidence: `src/Androrat/src/my/app/client/ClientListener.java`)
- Client service → Client command dispatch: receives instructions (evidence: `src/Androrat/src/my/app/client/Client.java`)
- Client command dispatch → Device information: runs capabilities (evidence: `src/Androrat/src/my/app/client/ClientListener.java`)
- Client command dispatch → Contacts and call logs: runs capabilities (evidence: `src/Androrat/src/my/app/client/ClientListener.java`)
- Client command dispatch → SMS collection and monitor: runs capabilities (evidence: `src/Androrat/src/my/app/client/ClientListener.java`)
- Client command dispatch → Call monitoring: runs capabilities (evidence: `src/Androrat/src/my/app/client/ClientListener.java`)
- Call monitoring → Client service: sends call events (evidence: `src/Androrat/src/my/app/Library/CallMonitor.java`)
- Client command dispatch → GPS location: runs capabilities (evidence: `src/Androrat/src/my/app/client/ClientListener.java`)
- Client command dispatch → Camera and media streams: runs capabilities (evidence: `src/Androrat/src/my/app/client/ClientListener.java`)
- Client command dispatch → Files and directories: runs capabilities (evidence: `src/Androrat/src/my/app/client/ClientListener.java`)
- Socket connection → Protocol definitions: uses framing (evidence: `src/Androrat/src/my/app/client/Client.java`)
- Protocol definitions → Packet formats: defines packet protocol (evidence: `src/InOut/inout/Protocol.java`)
- Packet routing → File reception: routes file data (evidence: `src/AndroratServer/src/handler/FileHandler.java`)
- Server listener → Client panels: updates results
- Client command dispatch → Protocol definitions: encodes responses (evidence: `src/Androrat/src/my/app/client/ClientListener.java`)
