# wxypereira/linux-android architecture

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

- Interactive diagram: https://gitdiagram.com/wxypereira/linux-android
- Repository: https://github.com/wxypereira/linux-android

## Overview

Cyberdeck is a Termux-based installer for a rootless Linux desktop on Android. The documented workflow is to run an installer, choose a desktop, install the Linux environment, then launch it and display it through Termux X11. The README also describes hardware and GPU/driver detection. Source excerpts were unavailable, so relationships below rely on README statements; the documented start-linux.sh launcher is not present in the supplied tree and is not represented as a repository component.

Main entry points: [`script-termux.sh`](https://github.com/wxypereira/linux-android/blob/master/script-termux.sh) (Termux installer), [`script-installation.sh`](https://github.com/wxypereira/linux-android/blob/master/script-installation.sh) (Automatic installer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Installation entry points"]
  node_automatic_installer["Automatic installer"]
  node_termux_installer["Termux installer<br/>[script-termux.sh]"]
end

subgraph group_setup["Environment setup"]
  node_desktop_choice["Desktop selection<br/>[script-termux.sh]"]
  node_hardware_detection["Hardware detection<br/>[script-termux.sh]"]
  node_graphics_drivers["Graphics drivers<br/>[script-termux.sh]"]
  node_proot_linux["Rootless Linux<br/>[script-termux.sh]"]
end

subgraph group_runtime["Desktop runtime"]
  node_desktop_environment["Desktop environment<br/>[script-termux.sh]"]
  node_linux_session["Linux desktop session"]
end

node_user(("Android user"))
node_termux["Termux"]
node_termux_x11["Termux X11"]

node_user -->|"runs installer in"| node_termux
node_termux -->|"runs with desktop parameter"| node_automatic_installer
node_termux -->|"runs installer"| node_termux_installer
node_automatic_installer -->|"accepts or prompts for"| node_desktop_choice
node_termux_installer -->|"prompts for"| node_desktop_choice
node_termux_installer -->|"detects device hardware"| node_hardware_detection
node_termux_installer -->|"selects graphics drivers"| node_graphics_drivers
node_termux_installer -->|"installs rootless environment"| node_proot_linux
node_desktop_choice -->|"selects desktop"| node_desktop_environment
node_proot_linux -->|"hosts desktop"| node_desktop_environment
node_user -->|"starts Linux"| node_linux_session
node_linux_session -->|"displays through"| node_termux_x11

click node_automatic_installer "https://github.com/wxypereira/linux-android/blob/master/script-installation.sh"
click node_termux_installer "https://github.com/wxypereira/linux-android/blob/master/script-termux.sh"
click node_desktop_choice "https://github.com/wxypereira/linux-android/blob/master/script-termux.sh"
click node_hardware_detection "https://github.com/wxypereira/linux-android/blob/master/script-termux.sh"
click node_graphics_drivers "https://github.com/wxypereira/linux-android/blob/master/script-termux.sh"
click node_proot_linux "https://github.com/wxypereira/linux-android/blob/master/script-termux.sh"
click node_desktop_environment "https://github.com/wxypereira/linux-android/blob/master/script-termux.sh"

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_automatic_installer,node_termux_installer,node_user toneBlue
class node_desktop_choice,node_hardware_detection,node_graphics_drivers,node_proot_linux toneAmber
class node_desktop_environment,node_linux_session toneMint
class node_termux,node_termux_x11 toneIndigo
```

## Components

### Installation entry points

- [Automatic installer](https://github.com/wxypereira/linux-android/blob/master/script-installation.sh): `script-installation.sh`
- [Termux installer](https://github.com/wxypereira/linux-android/blob/master/script-termux.sh): `script-termux.sh`

### Environment setup

- [Desktop selection](https://github.com/wxypereira/linux-android/blob/master/script-termux.sh): `script-termux.sh`
- [Hardware detection](https://github.com/wxypereira/linux-android/blob/master/script-termux.sh): `script-termux.sh`
- [Graphics drivers](https://github.com/wxypereira/linux-android/blob/master/script-termux.sh): `script-termux.sh`
- [Rootless Linux](https://github.com/wxypereira/linux-android/blob/master/script-termux.sh): `script-termux.sh`

### Desktop runtime

- [Desktop environment](https://github.com/wxypereira/linux-android/blob/master/script-termux.sh): `script-termux.sh`
- **Linux desktop session**

### Other components

- **Android user**
- **Termux**
- **Termux X11**

## Connections

- Android user → Termux: runs installer in (evidence: `README.md`)
- Termux → Automatic installer: runs with desktop parameter (evidence: `README.md`)
- Termux → Termux installer: runs installer (evidence: `README.md`)
- Automatic installer → Desktop selection: accepts or prompts for (evidence: `README.md`)
- Termux installer → Desktop selection: prompts for (evidence: `README.md`)
- Termux installer → Hardware detection: detects device hardware (evidence: `README.md`)
- Termux installer → Graphics drivers: selects graphics drivers (evidence: `README.md`)
- Termux installer → Rootless Linux: installs rootless environment (evidence: `README.md`)
- Desktop selection → Desktop environment: selects desktop (evidence: `README.md`)
- Rootless Linux → Desktop environment: hosts desktop (evidence: `README.md`)
- Android user → Linux desktop session: starts Linux (evidence: `README.md`)
- Linux desktop session → Termux X11: displays through (evidence: `README.md`)
