# alltoolbox-sc/alltoolbox-python architecture

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

- Interactive diagram: https://gitdiagram.com/alltoolbox-sc/alltoolbox-python
- Repository: https://github.com/alltoolbox-sc/alltoolbox-python

## Overview

AndroidToolBox is a Windows-oriented Android device toolbox presented as an interactive TUI. The principal workflow is user → startup console → menu selection → a toolbox operation, with scripts under src/bats covering device tasks. The sampled startup file also references boot-image utilities, build metadata, and music playback. The README only identifies the product as a multifunction TUI; feature labels in start.py provide the evidence for the menu branches. Most batch-script internals were not sampled, so their internal calls are not mapped.

Main entry points: [`src/start.py`](https://github.com/alltoolbox-sc/alltoolbox-python/blob/main/src/start.py) (Startup console), [`src/menu.py`](https://github.com/alltoolbox-sc/alltoolbox-python/blob/main/src/menu.py) (Menu utilities), [`src/build_info.py`](https://github.com/alltoolbox-sc/alltoolbox-python/blob/main/src/build_info.py) (Build metadata), [`src/bats`](https://github.com/alltoolbox-sc/alltoolbox-python/tree/main/src/bats) (Device tasks)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_console["Interactive console"]
  node_startup["Startup console<br/>[start.py]"]
  node_menu["Menu utilities<br/>[menu.py]"]
  node_metadata["Build metadata<br/>[build_info.py]"]
end

subgraph group_operations["Android operations"]
  node_device_tasks["Device tasks"]
  node_rooting["Rooting tools"]
  node_app_modules["Apps and modules"]
  node_boot_images["Boot image patching<br/>[flash_ak3.py]"]
  node_xtc_download["XTC patch downloads<br/>[down_xtcpatch.py]"]
end

subgraph group_support["Supporting tools"]
  node_music["Music playback<br/>[musicplayer.py]"]
  node_repair["Repair utility<br/>[repair.py]"]
end

node_user(("User"))

node_user -->|"starts"| node_startup
node_startup -->|"uses menus"| node_menu
node_startup -->|"reads metadata"| node_metadata
node_startup -->|"uses patcher"| node_boot_images
node_startup -->|"uses player"| node_music
node_startup -->|"offers device tasks"| node_device_tasks
node_startup -->|"offers rooting"| node_rooting
node_startup -->|"offers management"| node_app_modules

click node_startup "https://github.com/alltoolbox-sc/alltoolbox-python/blob/main/src/start.py"
click node_menu "https://github.com/alltoolbox-sc/alltoolbox-python/blob/main/src/menu.py"
click node_metadata "https://github.com/alltoolbox-sc/alltoolbox-python/blob/main/src/build_info.py"
click node_device_tasks "https://github.com/alltoolbox-sc/alltoolbox-python/tree/main/src/bats"
click node_rooting "https://github.com/alltoolbox-sc/alltoolbox-python/tree/main/src/bats"
click node_app_modules "https://github.com/alltoolbox-sc/alltoolbox-python/tree/main/src/bats"
click node_boot_images "https://github.com/alltoolbox-sc/alltoolbox-python/blob/main/src/flash_ak3.py"
click node_xtc_download "https://github.com/alltoolbox-sc/alltoolbox-python/blob/main/src/down_xtcpatch.py"
click node_music "https://github.com/alltoolbox-sc/alltoolbox-python/blob/main/src/musicplayer.py"
click node_repair "https://github.com/alltoolbox-sc/alltoolbox-python/blob/main/src/repair.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_startup,node_menu,node_metadata,node_user toneBlue
class node_device_tasks,node_rooting,node_app_modules,node_boot_images,node_xtc_download toneAmber
class node_music,node_repair toneMint
```

## Components

### Interactive console

- [Startup console](https://github.com/alltoolbox-sc/alltoolbox-python/blob/main/src/start.py): `src/start.py`
- [Menu utilities](https://github.com/alltoolbox-sc/alltoolbox-python/blob/main/src/menu.py): `src/menu.py`
- [Build metadata](https://github.com/alltoolbox-sc/alltoolbox-python/blob/main/src/build_info.py): `src/build_info.py`

### Android operations

- [Device tasks](https://github.com/alltoolbox-sc/alltoolbox-python/tree/main/src/bats): `src/bats`
- [Rooting tools](https://github.com/alltoolbox-sc/alltoolbox-python/tree/main/src/bats): `src/bats`
- [Apps and modules](https://github.com/alltoolbox-sc/alltoolbox-python/tree/main/src/bats): `src/bats`
- [Boot image patching](https://github.com/alltoolbox-sc/alltoolbox-python/blob/main/src/flash_ak3.py): `src/flash_ak3.py`
- [XTC patch downloads](https://github.com/alltoolbox-sc/alltoolbox-python/blob/main/src/down_xtcpatch.py): `src/down_xtcpatch.py`

### Supporting tools

- [Music playback](https://github.com/alltoolbox-sc/alltoolbox-python/blob/main/src/musicplayer.py): `src/musicplayer.py`
- [Repair utility](https://github.com/alltoolbox-sc/alltoolbox-python/blob/main/src/repair.py): `src/repair.py`

### Other components

- **User**

## Connections

- User → Startup console: starts (evidence: `README.md`)
- Startup console → Menu utilities: uses menus (evidence: `src/start.py`)
- Startup console → Build metadata: reads metadata (evidence: `src/start.py`)
- Startup console → Boot image patching: uses patcher (evidence: `src/start.py`)
- Startup console → Music playback: uses player (evidence: `src/start.py`)
- Startup console → Device tasks: offers device tasks (evidence: `src/start.py`)
- Startup console → Rooting tools: offers rooting (evidence: `src/start.py`)
- Startup console → Apps and modules: offers management (evidence: `src/start.py`)
