# xen1123/android-help architecture

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

- Interactive diagram: https://gitdiagram.com/xen1123/android-help
- Repository: https://github.com/xen1123/android-help

## Overview

Android-Help is a collection of host-side Android tweaking tools and reference guides. The main workflow is to prepare ADB/Fastboot on the host, connect a device, then use the multi-device CLI or standalone scripts to debloat apps or flash firmware. The repository also documents rooting and stock-firmware discovery. Edges reflect README statements or shown subprocess calls; the main CLI excerpt is partial, so unsampled behavior is not expanded.

Main entry points: [`Scripts/master.py`](https://github.com/xen1123/android-help/blob/main/Scripts/master.py) (Multi-device CLI), [`Scripts/genericFlasher.py`](https://github.com/xen1123/android-help/blob/main/Scripts/genericFlasher.py) (Generic Flasher), [`Scripts/Android-Tools.py`](https://github.com/xen1123/android-help/blob/main/Scripts/Android-Tools.py) (Platform Tools Setup), [`Scripts/genericDebloater.py`](https://github.com/xen1123/android-help/blob/main/Scripts/genericDebloater.py) (Interactive Debloater)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ops["Device Operations"]
  node_master["Multi-device CLI<br/>[master.py]"]
  node_master_debloat["Integrated Debloating<br/>[master.py]"]
  node_master_flash["Integrated Flashing<br/>[master.py]"]
  node_app_installs["App Install Options<br/>[master.py]"]
  node_generic_debloat["Interactive Debloater"]
  node_generic_flash["Generic Flasher<br/>[genericFlasher.py]"]
end

subgraph group_setup["Host Setup"]
  node_tools["Platform Tools Setup<br/>[Android-Tools.py]"]
end

subgraph group_guides["Reference Guides"]
  node_help["Help Guide<br/>[Help.md]"]
  node_root_guide["Root Guide<br/>[Root-Guide.md]"]
  node_stock_firmware["Stock Firmware Finder<br/>[Stock-Firmware.md]"]
end

node_user(("Host User"))
node_device["Android Device"]
node_adb["ADB Executable"]
node_fastboot["Fastboot Executable"]
node_host_packages["Host Package Manager"]
node_download["Tool Archive Download"]

node_user -->|"runs"| node_master
node_master -->|"selects"| node_master_debloat
node_master -->|"selects"| node_master_flash
node_master -->|"runs commands"| node_adb
node_master -->|"runs commands"| node_fastboot
node_master -->|"offers installs"| node_app_installs
node_master_debloat -->|"queries and changes apps"| node_adb
node_master_flash -->|"flashes images"| node_fastboot
node_user -->|"runs"| node_generic_debloat
node_generic_debloat -->|"queries and changes apps"| node_adb
node_user -->|"runs"| node_generic_flash
node_generic_flash -->|"reboots device"| node_adb
node_generic_flash -->|"flashes images"| node_fastboot
node_adb -->|"communicates with"| node_device
node_fastboot -->|"flashes device"| node_device
node_user -->|"runs"| node_tools
node_tools -->|"installs tools"| node_host_packages
node_tools -->|"retrieves archive"| node_download
node_user -->|"consults"| node_help
node_user -->|"consults"| node_root_guide
node_user -->|"consults"| node_stock_firmware

click node_master "https://github.com/xen1123/android-help/blob/main/Scripts/master.py"
click node_master_debloat "https://github.com/xen1123/android-help/blob/main/Scripts/master.py"
click node_master_flash "https://github.com/xen1123/android-help/blob/main/Scripts/master.py"
click node_app_installs "https://github.com/xen1123/android-help/blob/main/Scripts/master.py"
click node_generic_debloat "https://github.com/xen1123/android-help/blob/main/Scripts/genericDebloater.py"
click node_generic_flash "https://github.com/xen1123/android-help/blob/main/Scripts/genericFlasher.py"
click node_tools "https://github.com/xen1123/android-help/blob/main/Scripts/Android-Tools.py"
click node_help "https://github.com/xen1123/android-help/blob/main/Documents/Help.md"
click node_root_guide "https://github.com/xen1123/android-help/blob/main/Documents/Root-Guide.md"
click node_stock_firmware "https://github.com/xen1123/android-help/blob/main/Documents/Stock-Firmware.md"

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_master,node_master_debloat,node_master_flash,node_app_installs,node_generic_debloat,node_generic_flash,node_user toneBlue
class node_tools toneAmber
class node_help,node_root_guide,node_stock_firmware toneMint
class node_device,node_adb,node_fastboot,node_host_packages,node_download toneIndigo
```

## Components

### Device Operations

- [Multi-device CLI](https://github.com/xen1123/android-help/blob/main/Scripts/master.py): `Scripts/master.py`
- [Integrated Debloating](https://github.com/xen1123/android-help/blob/main/Scripts/master.py): `Scripts/master.py`
- [Integrated Flashing](https://github.com/xen1123/android-help/blob/main/Scripts/master.py): `Scripts/master.py`
- [App Install Options](https://github.com/xen1123/android-help/blob/main/Scripts/master.py): `Scripts/master.py`
- [Interactive Debloater](https://github.com/xen1123/android-help/blob/main/Scripts/genericDebloater.py): `Scripts/genericDebloater.py`
- [Generic Flasher](https://github.com/xen1123/android-help/blob/main/Scripts/genericFlasher.py): `Scripts/genericFlasher.py`

### Host Setup

- [Platform Tools Setup](https://github.com/xen1123/android-help/blob/main/Scripts/Android-Tools.py): `Scripts/Android-Tools.py`

### Reference Guides

- [Help Guide](https://github.com/xen1123/android-help/blob/main/Documents/Help.md): `Documents/Help.md`
- [Root Guide](https://github.com/xen1123/android-help/blob/main/Documents/Root-Guide.md): `Documents/Root-Guide.md`
- [Stock Firmware Finder](https://github.com/xen1123/android-help/blob/main/Documents/Stock-Firmware.md): `Documents/Stock-Firmware.md`

### Other components

- **Host User**
- **Android Device**
- **ADB Executable**
- **Fastboot Executable**
- **Host Package Manager**
- **Tool Archive Download**

## Connections

- Host User → Multi-device CLI: runs (evidence: `Scripts/master.py`)
- Multi-device CLI → Integrated Debloating: selects (evidence: `Scripts/master.py`)
- Multi-device CLI → Integrated Flashing: selects (evidence: `Scripts/master.py`)
- Multi-device CLI → ADB Executable: runs commands (evidence: `Scripts/master.py`)
- Multi-device CLI → Fastboot Executable: runs commands (evidence: `Scripts/master.py`)
- Multi-device CLI → App Install Options: offers installs (evidence: `Scripts/master.py`)
- Integrated Debloating → ADB Executable: queries and changes apps (evidence: `Scripts/master.py`)
- Integrated Flashing → Fastboot Executable: flashes images (evidence: `Scripts/master.py`)
- Host User → Interactive Debloater: runs (evidence: `Scripts/genericDebloater.py`)
- Interactive Debloater → ADB Executable: queries and changes apps (evidence: `Scripts/genericDebloater.py`)
- Host User → Generic Flasher: runs (evidence: `Scripts/genericFlasher.py`)
- Generic Flasher → ADB Executable: reboots device (evidence: `Scripts/genericFlasher.py`)
- Generic Flasher → Fastboot Executable: flashes images (evidence: `Scripts/genericFlasher.py`)
- ADB Executable → Android Device: communicates with (evidence: `README.md`)
- Fastboot Executable → Android Device: flashes device (evidence: `README.md`)
- Host User → Platform Tools Setup: runs (evidence: `README.md`)
- Platform Tools Setup → Host Package Manager: installs tools (evidence: `Scripts/Android-Tools.py`)
- Platform Tools Setup → Tool Archive Download: retrieves archive (evidence: `Scripts/Android-Tools.py`)
- Host User → Help Guide: consults (evidence: `README.md`)
- Host User → Root Guide: consults (evidence: `README.md`)
- Host User → Stock Firmware Finder: consults (evidence: `README.md`)