# brut-security/brutdroid architecture

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

- Interactive diagram: https://gitdiagram.com/brut-security/brutdroid
- Repository: https://github.com/brut-security/brutdroid

## Overview

BrutDroid is a Windows-oriented CLI for preparing an Android Studio emulator for mobile penetration testing, then configuring interception and running Frida instrumentation. The README documents the main menu workflows; the sampled Python excerpts confirm certificate download/conversion and emulator transfer, Frida-server download and transfer, and parts of rooting and script handling. The Python application is a monolith, so several distinct responsibilities point to BrutDroid.py. Other feature links reflect README documentation rather than inspected implementations.

Main entry points: [`BrutDroid.py`](https://github.com/brut-security/brutdroid/blob/main/BrutDroid.py) (Interactive CLI), [`Fripts`](https://github.com/brut-security/brutdroid/tree/main/Fripts) (Custom Scripts), [`Fripts/SSL-BYE.js`](https://github.com/brut-security/brutdroid/blob/main/Fripts/SSL-BYE.js) (SSL Pinning Bypass), [`Fripts/ROOTER.js`](https://github.com/brut-security/brutdroid/blob/main/Fripts/ROOTER.js) (Root Detection Bypass)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI and Setup"]
  node_cli["Interactive CLI<br/>[BrutDroid.py]"]
  node_env["Environment Checks<br/>[BrutDroid.py]"]
  node_toolinstall["Tool Installation<br/>[BrutDroid.py]"]
end

subgraph group_emulator["Emulator Preparation"]
  node_emulator["Android Emulator"]
  node_rooting["Emulator Rooting<br/>[BrutDroid.py]"]
  node_magisk["Magisk and rootAVD"]
end

subgraph group_intercept["Traffic Interception"]
  node_cert["Burp CA Setup<br/>[BrutDroid.py]"]
  node_burp["Burp Suite"]
  node_trustmodule["System CA Module"]
end

subgraph group_instrumentation["Frida Instrumentation"]
  node_frida_setup["Frida Server Setup<br/>[BrutDroid.py]"]
  node_frida_server["Frida Server"]
  node_frida_ops["Frida Operations<br/>[BrutDroid.py]"]
  node_script_catalog["Script Management<br/>[BrutDroid.py]"]
  node_custom_scripts["Custom Scripts"]
  node_ssl_bypass["SSL Pinning Bypass<br/>[SSL-BYE.js]"]
  node_root_bypass["Root Detection Bypass<br/>[ROOTER.js]"]
  node_pintoor["PintooR Bypass<br/>[PintooR.js]"]
end

node_researcher(("Security Researcher"))

node_researcher -->|"uses"| node_cli
node_cli -->|"checks setup"| node_env
node_cli -->|"offers installation"| node_toolinstall
node_cli -->|"offers rooting"| node_rooting
node_rooting -->|"installs and patches"| node_magisk
node_rooting -->|"prepares"| node_emulator
node_cli -->|"offers configuration"| node_cert
node_cert -->|"downloads certificate from"| node_burp
node_cert -->|"installs trust support"| node_trustmodule
node_cert -->|"transfers certificate to"| node_emulator
node_cli -->|"offers setup"| node_frida_setup
node_frida_setup -->|"downloads and transfers"| node_frida_server
node_frida_setup -->|"installs on"| node_emulator
node_cli -->|"offers operations"| node_frida_ops
node_frida_ops -->|"queries apps on"| node_emulator
node_frida_ops -.->|"starts or uses"| node_frida_server
node_cli -->|"offers script management"| node_script_catalog
node_script_catalog -->|"saves scripts in"| node_custom_scripts
node_frida_ops -.->|"runs scripts from"| node_custom_scripts
node_frida_ops -.->|"runs built-in script"| node_ssl_bypass
node_frida_ops -.->|"runs built-in script"| node_root_bypass
node_frida_ops -.->|"runs built-in script"| node_pintoor

click node_cli "https://github.com/brut-security/brutdroid/blob/main/BrutDroid.py"
click node_env "https://github.com/brut-security/brutdroid/blob/main/BrutDroid.py"
click node_toolinstall "https://github.com/brut-security/brutdroid/blob/main/BrutDroid.py"
click node_rooting "https://github.com/brut-security/brutdroid/blob/main/BrutDroid.py"
click node_cert "https://github.com/brut-security/brutdroid/blob/main/BrutDroid.py"
click node_frida_setup "https://github.com/brut-security/brutdroid/blob/main/BrutDroid.py"
click node_frida_ops "https://github.com/brut-security/brutdroid/blob/main/BrutDroid.py"
click node_script_catalog "https://github.com/brut-security/brutdroid/blob/main/BrutDroid.py"
click node_custom_scripts "https://github.com/brut-security/brutdroid/tree/main/Fripts"
click node_ssl_bypass "https://github.com/brut-security/brutdroid/blob/main/Fripts/SSL-BYE.js"
click node_root_bypass "https://github.com/brut-security/brutdroid/blob/main/Fripts/ROOTER.js"
click node_pintoor "https://github.com/brut-security/brutdroid/blob/main/Fripts/PintooR.js"

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_env,node_toolinstall toneBlue
class node_emulator,node_rooting,node_magisk toneAmber
class node_cert,node_burp,node_trustmodule toneMint
class node_frida_setup,node_frida_server,node_frida_ops,node_script_catalog,node_custom_scripts,node_ssl_bypass,node_root_bypass,node_pintoor toneRose
class node_researcher toneIndigo
```

## Components

### CLI and Setup

- [Interactive CLI](https://github.com/brut-security/brutdroid/blob/main/BrutDroid.py): `BrutDroid.py`
- [Environment Checks](https://github.com/brut-security/brutdroid/blob/main/BrutDroid.py): `BrutDroid.py`
- [Tool Installation](https://github.com/brut-security/brutdroid/blob/main/BrutDroid.py): `BrutDroid.py`

### Emulator Preparation

- **Android Emulator**
- [Emulator Rooting](https://github.com/brut-security/brutdroid/blob/main/BrutDroid.py): `BrutDroid.py`
- **Magisk and rootAVD**

### Traffic Interception

- [Burp CA Setup](https://github.com/brut-security/brutdroid/blob/main/BrutDroid.py): `BrutDroid.py`
- **Burp Suite**
- **System CA Module**

### Frida Instrumentation

- [Frida Server Setup](https://github.com/brut-security/brutdroid/blob/main/BrutDroid.py): `BrutDroid.py`
- **Frida Server**
- [Frida Operations](https://github.com/brut-security/brutdroid/blob/main/BrutDroid.py): `BrutDroid.py`
- [Script Management](https://github.com/brut-security/brutdroid/blob/main/BrutDroid.py): `BrutDroid.py`
- [Custom Scripts](https://github.com/brut-security/brutdroid/tree/main/Fripts): `Fripts`
- [SSL Pinning Bypass](https://github.com/brut-security/brutdroid/blob/main/Fripts/SSL-BYE.js): `Fripts/SSL-BYE.js`
- [Root Detection Bypass](https://github.com/brut-security/brutdroid/blob/main/Fripts/ROOTER.js): `Fripts/ROOTER.js`
- [PintooR Bypass](https://github.com/brut-security/brutdroid/blob/main/Fripts/PintooR.js): `Fripts/PintooR.js`

### Other components

- **Security Researcher**

## Connections

- Security Researcher → Interactive CLI: uses (evidence: `README.md`)
- Interactive CLI → Environment Checks: checks setup (evidence: `README.md`)
- Interactive CLI → Tool Installation: offers installation (evidence: `README.md`)
- Interactive CLI → Emulator Rooting: offers rooting (evidence: `README.md`)
- Emulator Rooting → Magisk and rootAVD: installs and patches (evidence: `README.md`)
- Emulator Rooting → Android Emulator: prepares (evidence: `README.md`)
- Interactive CLI → Burp CA Setup: offers configuration (evidence: `README.md`)
- Burp CA Setup → Burp Suite: downloads certificate from (evidence: `BrutDroid.py`)
- Burp CA Setup → System CA Module: installs trust support (evidence: `README.md`)
- Burp CA Setup → Android Emulator: transfers certificate to (evidence: `BrutDroid.py`)
- Interactive CLI → Frida Server Setup: offers setup (evidence: `README.md`)
- Frida Server Setup → Frida Server: downloads and transfers (evidence: `BrutDroid.py`)
- Frida Server Setup → Android Emulator: installs on (evidence: `README.md`)
- Interactive CLI → Frida Operations: offers operations (evidence: `README.md`)
- Frida Operations → Android Emulator: queries apps on (evidence: `BrutDroid.py`)
- Frida Operations → Frida Server: starts or uses (evidence: `README.md`)
- Interactive CLI → Script Management: offers script management (evidence: `README.md`)
- Script Management → Custom Scripts: saves scripts in (evidence: `README.md`)
- Frida Operations → Custom Scripts: runs scripts from (evidence: `README.md`)
- Frida Operations → SSL Pinning Bypass: runs built-in script (evidence: `README.md`)
- Frida Operations → Root Detection Bypass: runs built-in script (evidence: `README.md`)
- Frida Operations → PintooR Bypass: runs built-in script (evidence: `README.md`)
