# reverseclabs/drozer architecture

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

- Interactive diagram: https://gitdiagram.com/reverseclabs/drozer
- Repository: https://github.com/reverseclabs/drozer

## Overview

drozer is an Android security-testing framework: a console user connects to an Agent on a test device, runs modules that inspect or exercise Android app/device surfaces, and receives results in the console. Its runtime includes console/session management, a server and message protocol, module execution, and optional module-repository, exploit/payload, and TLS tools. The README establishes the user workflow and capabilities; edges below are limited to relationships supported by its statements or the supplied source index/excerpts, so some internal wiring is intentionally omitted.

Main entry points: [`src/drozer/modules/loader.py`](https://github.com/reverseclabs/drozer/blob/develop/src/drozer/modules/loader.py) (Module loader), [`src/drozer/server/server.py`](https://github.com/reverseclabs/drozer/blob/develop/src/drozer/server/server.py) (Drozer server), [`src/drozer/console/console.py`](https://github.com/reverseclabs/drozer/blob/develop/src/drozer/console/console.py) (Drozer console), [`src/drozer/device.py`](https://github.com/reverseclabs/drozer/blob/develop/src/drozer/device.py) (Device interface)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Console and session"]
  node_console["Drozer console<br/>[console.py]"]
  node_cli["CLI commands<br/>[cli.py]"]
  node_session["Session state<br/>[session.py]"]
  node_device["Device interface<br/>[device.py]"]
end

subgraph group_transport["Agent transport"]
  node_server["Drozer server<br/>[server.py]"]
  node_servercore["Agent session routing<br/>[dz.py]"]
  node_protocol["Message protocol<br/>[frame.py]"]
  node_requesthandler["System request dispatch"]
  node_agent["Android Agent"]
end

subgraph group_testing["Android testing"]
  node_android["Android runtime<br/>[android.py]"]
  node_modules["Module catalog<br/>[collection.py]"]
  node_moduleloader["Module loader<br/>[loader.py]"]
  node_appchecks["App surface checks"]
  node_scanners["Scanners"]
  node_info["Device information"]
  node_shell["Device shell"]
end

subgraph group_extensions["Modules and exploits"]
  node_exploits["Exploit modules"]
  node_payloads["Payload modules"]
  node_exploitmanager["Exploit builder<br/>[manager.py]"]
  node_payloadmanager["Payload builder<br/>[manager.py]"]
  node_repoman["Module repositories<br/>[manager.py]"]
  node_installer["Module installer<br/>[installer.py]"]
end

subgraph group_services["Supporting services"]
  node_ssl["TLS configuration<br/>[provider.py]"]
  node_agentbuild["Agent packaging<br/>[manager.py]"]
end

node_user(("Security tester"))
node_testerdevice(("Android test device"))

node_user -->|"runs commands"| node_console
node_console -->|"dispatches commands"| node_cli
node_console -.->|"manages session"| node_session
node_session -->|"uses device"| node_device
node_device -->|"interacts with runtime"| node_android
node_user -->|"connects console"| node_server
node_server -->|"starts server"| node_servercore
node_server -->|"configures TLS"| node_ssl
node_testerdevice -->|"runs agent"| node_agent
node_agent -->|"connects remotely"| node_server
node_servercore -.->|"routes sessions"| node_protocol
node_protocol -.->|"dispatches requests"| node_requesthandler
node_requesthandler -->|"handles device requests"| node_device
node_console -.->|"lists and runs"| node_modules
node_modules -.->|"loads modules"| node_moduleloader
node_moduleloader -.->|"loads checks"| node_appchecks
node_moduleloader -.->|"loads scans"| node_scanners
node_moduleloader -.->|"loads queries"| node_info
node_moduleloader -.->|"loads shell tools"| node_shell
node_repoman -->|"installs modules"| node_installer
node_exploitmanager -.->|"builds exploit"| node_exploits
node_exploitmanager -.->|"selects payload"| node_payloads
node_payloadmanager -.->|"builds payload"| node_payloads
node_agentbuild -.->|"packages agent"| node_agent
node_server -->|"routes agent sessions"| node_servercore

click node_console "https://github.com/reverseclabs/drozer/blob/develop/src/drozer/console/console.py"
click node_cli "https://github.com/reverseclabs/drozer/blob/develop/src/reversec/common/cli.py"
click node_session "https://github.com/reverseclabs/drozer/blob/develop/src/drozer/session.py"
click node_device "https://github.com/reverseclabs/drozer/blob/develop/src/drozer/device.py"
click node_android "https://github.com/reverseclabs/drozer/blob/develop/src/drozer/android.py"
click node_modules "https://github.com/reverseclabs/drozer/blob/develop/src/drozer/modules/collection.py"
click node_moduleloader "https://github.com/reverseclabs/drozer/blob/develop/src/drozer/modules/loader.py"
click node_appchecks "https://github.com/reverseclabs/drozer/tree/develop/src/drozer/modules/app"
click node_scanners "https://github.com/reverseclabs/drozer/tree/develop/src/drozer/modules/scanner"
click node_info "https://github.com/reverseclabs/drozer/tree/develop/src/drozer/modules/information"
click node_shell "https://github.com/reverseclabs/drozer/tree/develop/src/drozer/modules/shell"
click node_exploits "https://github.com/reverseclabs/drozer/tree/develop/src/drozer/modules/exploit"
click node_payloads "https://github.com/reverseclabs/drozer/tree/develop/src/drozer/modules/payloads"
click node_exploitmanager "https://github.com/reverseclabs/drozer/blob/develop/src/drozer/exploit/manager.py"
click node_payloadmanager "https://github.com/reverseclabs/drozer/blob/develop/src/drozer/payload/manager.py"
click node_repoman "https://github.com/reverseclabs/drozer/blob/develop/src/drozer/repoman/manager.py"
click node_installer "https://github.com/reverseclabs/drozer/blob/develop/src/drozer/repoman/installer.py"
click node_server "https://github.com/reverseclabs/drozer/blob/develop/src/drozer/server/server.py"
click node_servercore "https://github.com/reverseclabs/drozer/blob/develop/src/drozer/server/dz.py"
click node_protocol "https://github.com/reverseclabs/drozer/blob/develop/src/pysolar/api/frame.py"
click node_requesthandler "https://github.com/reverseclabs/drozer/blob/develop/src/pysolar/api/handlers/system_request_handler.py"
click node_ssl "https://github.com/reverseclabs/drozer/blob/develop/src/drozer/ssl/provider.py"
click node_agentbuild "https://github.com/reverseclabs/drozer/blob/develop/src/drozer/agent/manager.py"

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_console,node_cli,node_session,node_device toneBlue
class node_server,node_servercore,node_protocol,node_requesthandler,node_agent toneAmber
class node_android,node_modules,node_moduleloader,node_appchecks,node_scanners,node_info,node_shell toneMint
class node_exploits,node_payloads,node_exploitmanager,node_payloadmanager,node_repoman,node_installer toneRose
class node_ssl,node_agentbuild,node_user,node_testerdevice toneIndigo
```

## Components

### Console and session

- [Drozer console](https://github.com/reverseclabs/drozer/blob/develop/src/drozer/console/console.py): `src/drozer/console/console.py`
- [CLI commands](https://github.com/reverseclabs/drozer/blob/develop/src/reversec/common/cli.py): `src/reversec/common/cli.py`
- [Session state](https://github.com/reverseclabs/drozer/blob/develop/src/drozer/session.py): `src/drozer/session.py`
- [Device interface](https://github.com/reverseclabs/drozer/blob/develop/src/drozer/device.py): `src/drozer/device.py`

### Agent transport

- [Drozer server](https://github.com/reverseclabs/drozer/blob/develop/src/drozer/server/server.py): `src/drozer/server/server.py`
- [Agent session routing](https://github.com/reverseclabs/drozer/blob/develop/src/drozer/server/dz.py): `src/drozer/server/dz.py`
- [Message protocol](https://github.com/reverseclabs/drozer/blob/develop/src/pysolar/api/frame.py): `src/pysolar/api/frame.py`
- [System request dispatch](https://github.com/reverseclabs/drozer/blob/develop/src/pysolar/api/handlers/system_request_handler.py): `src/pysolar/api/handlers/system_request_handler.py`
- **Android Agent**

### Android testing

- [Android runtime](https://github.com/reverseclabs/drozer/blob/develop/src/drozer/android.py): `src/drozer/android.py`
- [Module catalog](https://github.com/reverseclabs/drozer/blob/develop/src/drozer/modules/collection.py): `src/drozer/modules/collection.py`
- [Module loader](https://github.com/reverseclabs/drozer/blob/develop/src/drozer/modules/loader.py): `src/drozer/modules/loader.py`
- [App surface checks](https://github.com/reverseclabs/drozer/tree/develop/src/drozer/modules/app): `src/drozer/modules/app`
- [Scanners](https://github.com/reverseclabs/drozer/tree/develop/src/drozer/modules/scanner): `src/drozer/modules/scanner`
- [Device information](https://github.com/reverseclabs/drozer/tree/develop/src/drozer/modules/information): `src/drozer/modules/information`
- [Device shell](https://github.com/reverseclabs/drozer/tree/develop/src/drozer/modules/shell): `src/drozer/modules/shell`

### Modules and exploits

- [Exploit modules](https://github.com/reverseclabs/drozer/tree/develop/src/drozer/modules/exploit): `src/drozer/modules/exploit`
- [Payload modules](https://github.com/reverseclabs/drozer/tree/develop/src/drozer/modules/payloads): `src/drozer/modules/payloads`
- [Exploit builder](https://github.com/reverseclabs/drozer/blob/develop/src/drozer/exploit/manager.py): `src/drozer/exploit/manager.py`
- [Payload builder](https://github.com/reverseclabs/drozer/blob/develop/src/drozer/payload/manager.py): `src/drozer/payload/manager.py`
- [Module repositories](https://github.com/reverseclabs/drozer/blob/develop/src/drozer/repoman/manager.py): `src/drozer/repoman/manager.py`
- [Module installer](https://github.com/reverseclabs/drozer/blob/develop/src/drozer/repoman/installer.py): `src/drozer/repoman/installer.py`

### Supporting services

- [TLS configuration](https://github.com/reverseclabs/drozer/blob/develop/src/drozer/ssl/provider.py): `src/drozer/ssl/provider.py`
- [Agent packaging](https://github.com/reverseclabs/drozer/blob/develop/src/drozer/agent/manager.py): `src/drozer/agent/manager.py`

### Other components

- **Security tester**
- **Android test device**

## Connections

- Security tester → Drozer console: runs commands (evidence: `README.md`)
- Drozer console → CLI commands: dispatches commands (evidence: `src/reversec/common/cli.py`)
- Drozer console → Session state: manages session
- Session state → Device interface: uses device (evidence: `src/drozer/device.py`)
- Device interface → Android runtime: interacts with runtime (evidence: `src/drozer/device.py`)
- Security tester → Drozer server: connects console (evidence: `README.md`)
- Drozer server → Agent session routing: starts server (evidence: `src/drozer/server/server.py`)
- Drozer server → TLS configuration: configures TLS (evidence: `src/drozer/server/server.py`)
- Android test device → Android Agent: runs agent (evidence: `README.md`)
- Android Agent → Drozer server: connects remotely (evidence: `README.md`)
- Agent session routing → Message protocol: routes sessions
- Message protocol → System request dispatch: dispatches requests
- System request dispatch → Device interface: handles device requests
- Drozer console → Module catalog: lists and runs
- Module catalog → Module loader: loads modules
- Module loader → App surface checks: loads checks
- Module loader → Scanners: loads scans
- Module loader → Device information: loads queries
- Module loader → Device shell: loads shell tools
- Module repositories → Module installer: installs modules (evidence: `src/drozer/repoman/manager.py`)
- Exploit builder → Exploit modules: builds exploit
- Exploit builder → Payload modules: selects payload
- Payload builder → Payload modules: builds payload
- Agent packaging → Android Agent: packages agent
- Drozer server → Agent session routing: routes agent sessions (evidence: `src/drozer/server/server.py`)
