# codeblin/pindroid architecture

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

- Interactive diagram: https://gitdiagram.com/codeblin/pindroid
- Repository: https://github.com/codeblin/pindroid

## Overview

PinDroid is an Android penetration-testing environment manager, not an analysis suite: its CLI provisions a repo-local, version-locked toolchain, checks and repairs workstation/device readiness, then supports interactive rooted-device testing. The README documents console workflows for selecting devices and targets, starting Frida, applying bypasses, and using proxy/logging tools. The graph preserves those major capabilities and the central runtime modules; some implementation links are omitted or marked unverified because the supplied excerpts do not show their call sites.

Main entry points: [`pindroid/cli.py`](https://github.com/codeblin/pindroid/blob/master/pindroid/cli.py) (CLI commands), [`pindroid/installer.py`](https://github.com/codeblin/pindroid/blob/master/pindroid/installer.py) (Tool installer), [`pindroid/device.py`](https://github.com/codeblin/pindroid/blob/master/pindroid/device.py) (ADB and device readiness), [`pindroid/console.py`](https://github.com/codeblin/pindroid/blob/master/pindroid/console.py) (Interactive console)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["CLI and session"]
  node_cli["CLI commands<br/>[cli.py]"]
  node_console["Interactive console<br/>[console.py]"]
  node_banner["CLI banner<br/>[banner.py]"]
  node_help["Help formatting<br/>[help_fmt.py]"]
end

subgraph group_environment["Environment setup"]
  node_workspace["Workspace setup<br/>[workspace.py]"]
  node_config["Config and pins<br/>[config.py]"]
  node_profiles["Tool profiles<br/>[profiles.py]"]
  node_registry["Tool registry<br/>[registry.py]"]
  node_installer["Tool installer<br/>[installer.py]"]
  node_lockfile["Version lockfile<br/>[lockfile.py]"]
  node_versions["Frida version manager<br/>[versions.py]"]
end

subgraph group_health["Health and repair"]
  node_doctor["Environment diagnosis<br/>[doctor.py]"]
  node_fix["Repair planner<br/>[fix.py]"]
end

subgraph group_device["Device testing"]
  node_device["ADB and device readiness<br/>[device.py]"]
  node_bypass["SSL and root bypass<br/>[bypass.py]"]
  node_medusa["Medusa modules<br/>[medusa_modules.py]"]
end

subgraph group_core["Shared runtime"]
  node_runtime["Managed tool runtime<br/>[runtime.py]"]
  node_utils["Network and process helpers<br/>[utils.py]"]
  node_progress["Progress reporting<br/>[progress.py]"]
end

node_operator(("Pentester"))
node_device_ext(("Android device"))
node_tool_sources(("Tool and release sources"))
node_frida_server["Frida server"]

node_operator -->|"runs commands"| node_cli
node_cli -.->|"opens console"| node_console
node_operator -->|"initializes workspace"| node_workspace
node_workspace -.->|"creates config"| node_config
node_cli -->|"resolves profile"| node_profiles
node_profiles -->|"selects tools"| node_registry
node_cli -.->|"installs tools"| node_installer
node_installer -->|"uses tool definitions"| node_registry
node_cli -->|"syncs Frida stack"| node_versions
node_cli -.->|"manages lockfile"| node_lockfile
node_operator -->|"checks readiness"| node_doctor
node_doctor -->|"checks connected devices"| node_device
node_operator -->|"repairs drift"| node_fix
node_fix -->|"uses findings"| node_doctor
node_fix -->|"requests installs"| node_installer
node_operator -->|"starts session"| node_console
node_console -->|"selects and readies device"| node_device
node_device -->|"uses ADB"| node_device_ext
node_device -->|"pushes and starts"| node_frida_server
node_console -->|"runs bypass"| node_bypass
node_cli -->|"runs bypass"| node_bypass
node_bypass -->|"resolves device target"| node_device
node_bypass -->|"checks root modules"| node_medusa
node_bypass -->|"checks managed tools"| node_runtime
node_console -->|"runs managed commands"| node_runtime
node_runtime -->|"reads settings"| node_config
node_runtime -->|"resolves tools"| node_registry
node_installer -->|"downloads releases"| node_tool_sources
node_device -->|"downloads server"| node_tool_sources
node_cli -->|"reports scan progress"| node_progress
node_installer -->|"reports install progress"| node_progress
node_doctor -.->|"reports check progress"| node_progress
node_cli -.->|"prints banner"| node_banner
node_cli -.->|"formats help"| node_help
node_lockfile -->|"reads configuration"| node_config
node_versions -->|"reads pins"| node_config
node_installer -->|"reads install settings"| node_config
node_cli -.->|"queries tool versions"| node_utils

click node_cli "https://github.com/codeblin/pindroid/blob/master/pindroid/cli.py"
click node_console "https://github.com/codeblin/pindroid/blob/master/pindroid/console.py"
click node_banner "https://github.com/codeblin/pindroid/blob/master/pindroid/banner.py"
click node_help "https://github.com/codeblin/pindroid/blob/master/pindroid/help_fmt.py"
click node_workspace "https://github.com/codeblin/pindroid/blob/master/pindroid/workspace.py"
click node_config "https://github.com/codeblin/pindroid/blob/master/pindroid/config.py"
click node_profiles "https://github.com/codeblin/pindroid/blob/master/pindroid/profiles.py"
click node_registry "https://github.com/codeblin/pindroid/blob/master/pindroid/registry.py"
click node_installer "https://github.com/codeblin/pindroid/blob/master/pindroid/installer.py"
click node_lockfile "https://github.com/codeblin/pindroid/blob/master/pindroid/lockfile.py"
click node_versions "https://github.com/codeblin/pindroid/blob/master/pindroid/versions.py"
click node_doctor "https://github.com/codeblin/pindroid/blob/master/pindroid/doctor.py"
click node_fix "https://github.com/codeblin/pindroid/blob/master/pindroid/fix.py"
click node_device "https://github.com/codeblin/pindroid/blob/master/pindroid/device.py"
click node_bypass "https://github.com/codeblin/pindroid/blob/master/pindroid/bypass.py"
click node_medusa "https://github.com/codeblin/pindroid/blob/master/pindroid/medusa_modules.py"
click node_runtime "https://github.com/codeblin/pindroid/blob/master/pindroid/runtime.py"
click node_utils "https://github.com/codeblin/pindroid/blob/master/pindroid/utils.py"
click node_progress "https://github.com/codeblin/pindroid/blob/master/pindroid/progress.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_cli,node_console,node_banner,node_help toneBlue
class node_workspace,node_config,node_profiles,node_registry,node_installer,node_lockfile,node_versions toneAmber
class node_doctor,node_fix,node_frida_server toneMint
class node_device,node_bypass,node_medusa toneRose
class node_runtime,node_utils,node_progress,node_operator,node_device_ext,node_tool_sources toneIndigo
```

## Components

### CLI and session

- [CLI commands](https://github.com/codeblin/pindroid/blob/master/pindroid/cli.py): `pindroid/cli.py`
- [Interactive console](https://github.com/codeblin/pindroid/blob/master/pindroid/console.py): `pindroid/console.py`
- [CLI banner](https://github.com/codeblin/pindroid/blob/master/pindroid/banner.py): `pindroid/banner.py`
- [Help formatting](https://github.com/codeblin/pindroid/blob/master/pindroid/help_fmt.py): `pindroid/help_fmt.py`

### Environment setup

- [Workspace setup](https://github.com/codeblin/pindroid/blob/master/pindroid/workspace.py): `pindroid/workspace.py`
- [Config and pins](https://github.com/codeblin/pindroid/blob/master/pindroid/config.py): `pindroid/config.py`
- [Tool profiles](https://github.com/codeblin/pindroid/blob/master/pindroid/profiles.py): `pindroid/profiles.py`
- [Tool registry](https://github.com/codeblin/pindroid/blob/master/pindroid/registry.py): `pindroid/registry.py`
- [Tool installer](https://github.com/codeblin/pindroid/blob/master/pindroid/installer.py): `pindroid/installer.py`
- [Version lockfile](https://github.com/codeblin/pindroid/blob/master/pindroid/lockfile.py): `pindroid/lockfile.py`
- [Frida version manager](https://github.com/codeblin/pindroid/blob/master/pindroid/versions.py): `pindroid/versions.py`

### Health and repair

- [Environment diagnosis](https://github.com/codeblin/pindroid/blob/master/pindroid/doctor.py): `pindroid/doctor.py`
- [Repair planner](https://github.com/codeblin/pindroid/blob/master/pindroid/fix.py): `pindroid/fix.py`

### Device testing

- [ADB and device readiness](https://github.com/codeblin/pindroid/blob/master/pindroid/device.py): `pindroid/device.py`
- [SSL and root bypass](https://github.com/codeblin/pindroid/blob/master/pindroid/bypass.py): `pindroid/bypass.py`
- [Medusa modules](https://github.com/codeblin/pindroid/blob/master/pindroid/medusa_modules.py): `pindroid/medusa_modules.py`

### Shared runtime

- [Managed tool runtime](https://github.com/codeblin/pindroid/blob/master/pindroid/runtime.py): `pindroid/runtime.py`
- [Network and process helpers](https://github.com/codeblin/pindroid/blob/master/pindroid/utils.py): `pindroid/utils.py`
- [Progress reporting](https://github.com/codeblin/pindroid/blob/master/pindroid/progress.py): `pindroid/progress.py`

### Other components

- **Pentester**
- **Android device**
- **Tool and release sources**
- **Frida server**

## Connections

- Pentester → CLI commands: runs commands (evidence: `README.md`)
- CLI commands → Interactive console: opens console (evidence: `pindroid/cli.py`)
- Pentester → Workspace setup: initializes workspace (evidence: `README.md`)
- Workspace setup → Config and pins: creates config (evidence: `pindroid/workspace.py`)
- CLI commands → Tool profiles: resolves profile (evidence: `pindroid/cli.py`)
- Tool profiles → Tool registry: selects tools (evidence: `pindroid/profiles.py`)
- CLI commands → Tool installer: installs tools (evidence: `pindroid/cli.py`)
- Tool installer → Tool registry: uses tool definitions (evidence: `pindroid/installer.py`)
- CLI commands → Frida version manager: syncs Frida stack (evidence: `pindroid/cli.py`)
- CLI commands → Version lockfile: manages lockfile (evidence: `pindroid/cli.py`)
- Pentester → Environment diagnosis: checks readiness (evidence: `README.md`)
- Environment diagnosis → ADB and device readiness: checks connected devices (evidence: `pindroid/doctor.py`)
- Pentester → Repair planner: repairs drift (evidence: `README.md`)
- Repair planner → Environment diagnosis: uses findings (evidence: `pindroid/fix.py`)
- Repair planner → Tool installer: requests installs (evidence: `pindroid/fix.py`)
- Pentester → Interactive console: starts session (evidence: `README.md`)
- Interactive console → ADB and device readiness: selects and readies device (evidence: `README.md`)
- ADB and device readiness → Android device: uses ADB (evidence: `pindroid/device.py`)
- ADB and device readiness → Frida server: pushes and starts (evidence: `README.md`)
- Interactive console → SSL and root bypass: runs bypass (evidence: `README.md`)
- CLI commands → SSL and root bypass: runs bypass (evidence: `pindroid/cli.py`)
- SSL and root bypass → ADB and device readiness: resolves device target (evidence: `pindroid/bypass.py`)
- SSL and root bypass → Medusa modules: checks root modules (evidence: `pindroid/bypass.py`)
- SSL and root bypass → Managed tool runtime: checks managed tools (evidence: `pindroid/bypass.py`)
- Interactive console → Managed tool runtime: runs managed commands (evidence: `pindroid/console.py`)
- Managed tool runtime → Config and pins: reads settings (evidence: `pindroid/runtime.py`)
- Managed tool runtime → Tool registry: resolves tools (evidence: `pindroid/runtime.py`)
- Tool installer → Tool and release sources: downloads releases (evidence: `pindroid/installer.py`)
- ADB and device readiness → Tool and release sources: downloads server (evidence: `pindroid/device.py`)
- CLI commands → Progress reporting: reports scan progress (evidence: `pindroid/cli.py`)
- Tool installer → Progress reporting: reports install progress (evidence: `pindroid/installer.py`)
- Environment diagnosis → Progress reporting: reports check progress (evidence: `pindroid/doctor.py`)
- CLI commands → CLI banner: prints banner (evidence: `pindroid/cli.py`)
- CLI commands → Help formatting: formats help (evidence: `pindroid/cli.py`)
- Version lockfile → Config and pins: reads configuration (evidence: `pindroid/lockfile.py`)
- Frida version manager → Config and pins: reads pins (evidence: `pindroid/versions.py`)
- Tool installer → Config and pins: reads install settings (evidence: `pindroid/installer.py`)
- CLI commands → Network and process helpers: queries tool versions (evidence: `pindroid/cli.py`)
