# tig-kira/termux-ultra architecture

> Architecture diagram of the GitHub repository tig-kira/termux-ultra, 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/tig-kira/termux-ultra
- Repository: https://github.com/tig-kira/termux-ultra

## Overview

Termux Ultra is an Android terminal and Linux-environment app, extending Termux with remote access, file tools, AI, plugins, and deployment resources. The main user flow is opening the app, creating or selecting a terminal session, and interacting with a shell; documented extensions branch into AI-assisted actions, file operations, remote connections, and plugin-provided features. The graph combines the sampled session/service code with README-documented capabilities. Several feature implementations are not in the supplied tree or excerpts, so their links are documented rather than inferred from unsampled code.

Main entry points: [`app/src/main/java/com/gaurav/avnc/App.kt`](https://github.com/tig-kira/termux-ultra/blob/main/app/src/main/java/com/gaurav/avnc/App.kt) (App interface), [`app/src/main/java/com/termux/app/compose/AiTermuxEngine.kt`](https://github.com/tig-kira/termux-ultra/blob/main/app/src/main/java/com/termux/app/compose/AiTermuxEngine.kt) (AI assistant), [`termux-shared/src/main/java/com/termux/terminal/TerminalSession.java`](https://github.com/tig-kira/termux-ultra/blob/main/termux-shared/src/main/java/com/termux/terminal/TerminalSession.java) (Terminal session), [`app/src/main/java/com/termux/app/TermuxService.java`](https://github.com/tig-kira/termux-ultra/blob/main/app/src/main/java/com/termux/app/TermuxService.java) (Termux service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App experience"]
  node_appui["App interface<br/>[App.kt]"]
  node_filemanager["File manager"]
  node_storage["Storage management<br/>[StorageActivity.kt]"]
end

subgraph group_terminal["Terminal runtime"]
  node_service["Termux service<br/>[TermuxService.java]"]
  node_sessions["Session manager"]
  node_terminalsession["Terminal session"]
  node_termclient["Terminal callbacks"]
  node_shellenv["Shell environment"]
end

subgraph group_tools["Product tools"]
  node_ai["AI assistant<br/>[AiTermuxEngine.kt]"]
  node_risk["Risk confirmation"]
  node_ftp["FTP server"]
  node_resources["Deployment resources"]
end

subgraph group_extensions["Extensions and access"]
  node_plugins["Plugin manager<br/>[PluginManager.kt]"]
  node_ssh["SSH connections"]
  node_vnc["VNC connections"]
  node_avnc["AVNC client<br/>[LayoutManager.kt]"]
  node_vncserver["VNC server library<br/>[main.c]"]
  node_libjpeg["JPEG support<br/>[turbojpeg.c]"]
end

node_user(("Android user"))

node_user -->|"opens"| node_appui
node_appui -.->|"manages sessions"| node_sessions
node_sessions -->|"uses service"| node_service
node_service -->|"manages sessions"| node_terminalsession
node_terminalsession -->|"calls callbacks"| node_termclient
node_service -->|"configures shell"| node_shellenv
node_appui -->|"opens"| node_filemanager
node_appui -.->|"opens"| node_storage
node_appui -->|"opens assistant"| node_ai
node_ai -->|"confirms risky actions"| node_risk
node_ai -->|"executes commands"| node_terminalsession
node_ai -->|"starts connections"| node_ssh
node_ai -->|"starts connections"| node_vnc
node_appui -->|"offers transfers"| node_ftp
node_appui -->|"opens deployments"| node_resources
node_resources -.->|"installs via shell"| node_terminalsession
node_appui -->|"opens plugin center"| node_plugins
node_plugins -->|"runs persistent shell"| node_terminalsession
node_appui -->|"manages connections"| node_ssh
node_appui -->|"manages connections"| node_vnc
node_vnc -->|"uses client"| node_avnc
node_avnc -.->|"connects remotely"| node_vncserver
node_vncserver -.->|"uses JPEG"| node_libjpeg

click node_appui "https://github.com/tig-kira/termux-ultra/blob/main/app/src/main/java/com/gaurav/avnc/App.kt"
click node_filemanager "https://github.com/tig-kira/termux-ultra/blob/main/app/src/main/java/com/termux/app/compose/FileManagerScreen.kt"
click node_storage "https://github.com/tig-kira/termux-ultra/blob/main/app/src/main/java/com/termux/app/activities/StorageActivity.kt"
click node_service "https://github.com/tig-kira/termux-ultra/blob/main/app/src/main/java/com/termux/app/TermuxService.java"
click node_sessions "https://github.com/tig-kira/termux-ultra/blob/main/app/src/main/java/com/termux/app/terminal/shell/ComposeSessionManager.kt"
click node_terminalsession "https://github.com/tig-kira/termux-ultra/blob/main/termux-shared/src/main/java/com/termux/terminal/TerminalSession.java"
click node_termclient "https://github.com/tig-kira/termux-ultra/blob/main/termux-shared/src/main/java/com/termux/terminal/TerminalSessionClient.java"
click node_shellenv "https://github.com/tig-kira/termux-ultra/blob/main/termux-shared/src/main/java/com/termux/shared/termux/shell/command/environment/TermuxShellEnvironment.java"
click node_ai "https://github.com/tig-kira/termux-ultra/blob/main/app/src/main/java/com/termux/app/compose/AiTermuxEngine.kt"
click node_risk "https://github.com/tig-kira/termux-ultra/blob/main/app/src/main/java/com/termux/app/compose/RiskConfirmManager.kt"
click node_ftp "https://github.com/tig-kira/termux-ultra/blob/main/app/src/main/java/com/termux/app/ftp/FtpServiceManager.kt"
click node_resources "https://github.com/tig-kira/termux-ultra/tree/main/app/src/main/java/com/termux/app"
click node_plugins "https://github.com/tig-kira/termux-ultra/blob/main/app/src/main/java/com/termux/app/plugin/PluginManager.kt"
click node_ssh "https://github.com/tig-kira/termux-ultra/blob/main/app/src/main/java/com/termux/app/ssh/SshConnectionManager.java"
click node_vnc "https://github.com/tig-kira/termux-ultra/blob/main/app/src/main/java/com/termux/app/vnc/VncConnectionManager.java"
click node_avnc "https://github.com/tig-kira/termux-ultra/blob/main/app/src/main/java/com/gaurav/avnc/ui/vnc/LayoutManager.kt"
click node_vncserver "https://github.com/tig-kira/termux-ultra/blob/main/app/extern/libvncserver/src/libvncserver/main.c"
click node_libjpeg "https://github.com/tig-kira/termux-ultra/blob/main/app/extern/libjpeg-turbo/turbojpeg.c"

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_appui,node_filemanager,node_storage,node_user toneBlue
class node_service,node_sessions,node_terminalsession,node_termclient,node_shellenv toneAmber
class node_ai,node_risk,node_ftp,node_resources toneMint
class node_plugins,node_ssh,node_vnc,node_avnc,node_vncserver,node_libjpeg toneRose
```

## Components

### App experience

- [App interface](https://github.com/tig-kira/termux-ultra/blob/main/app/src/main/java/com/gaurav/avnc/App.kt): `app/src/main/java/com/gaurav/avnc/App.kt`
- [File manager](https://github.com/tig-kira/termux-ultra/blob/main/app/src/main/java/com/termux/app/compose/FileManagerScreen.kt): `app/src/main/java/com/termux/app/compose/FileManagerScreen.kt`
- [Storage management](https://github.com/tig-kira/termux-ultra/blob/main/app/src/main/java/com/termux/app/activities/StorageActivity.kt): `app/src/main/java/com/termux/app/activities/StorageActivity.kt`

### Terminal runtime

- [Termux service](https://github.com/tig-kira/termux-ultra/blob/main/app/src/main/java/com/termux/app/TermuxService.java): `app/src/main/java/com/termux/app/TermuxService.java`
- [Session manager](https://github.com/tig-kira/termux-ultra/blob/main/app/src/main/java/com/termux/app/terminal/shell/ComposeSessionManager.kt): `app/src/main/java/com/termux/app/terminal/shell/ComposeSessionManager.kt`
- [Terminal session](https://github.com/tig-kira/termux-ultra/blob/main/termux-shared/src/main/java/com/termux/terminal/TerminalSession.java): `termux-shared/src/main/java/com/termux/terminal/TerminalSession.java`
- [Terminal callbacks](https://github.com/tig-kira/termux-ultra/blob/main/termux-shared/src/main/java/com/termux/terminal/TerminalSessionClient.java): `termux-shared/src/main/java/com/termux/terminal/TerminalSessionClient.java`
- [Shell environment](https://github.com/tig-kira/termux-ultra/blob/main/termux-shared/src/main/java/com/termux/shared/termux/shell/command/environment/TermuxShellEnvironment.java): `termux-shared/src/main/java/com/termux/shared/termux/shell/command/environment/TermuxShellEnvironment.java`

### Product tools

- [AI assistant](https://github.com/tig-kira/termux-ultra/blob/main/app/src/main/java/com/termux/app/compose/AiTermuxEngine.kt): `app/src/main/java/com/termux/app/compose/AiTermuxEngine.kt`
- [Risk confirmation](https://github.com/tig-kira/termux-ultra/blob/main/app/src/main/java/com/termux/app/compose/RiskConfirmManager.kt): `app/src/main/java/com/termux/app/compose/RiskConfirmManager.kt`
- [FTP server](https://github.com/tig-kira/termux-ultra/blob/main/app/src/main/java/com/termux/app/ftp/FtpServiceManager.kt): `app/src/main/java/com/termux/app/ftp/FtpServiceManager.kt`
- [Deployment resources](https://github.com/tig-kira/termux-ultra/tree/main/app/src/main/java/com/termux/app): `app/src/main/java/com/termux/app`

### Extensions and access

- [Plugin manager](https://github.com/tig-kira/termux-ultra/blob/main/app/src/main/java/com/termux/app/plugin/PluginManager.kt): `app/src/main/java/com/termux/app/plugin/PluginManager.kt`
- [SSH connections](https://github.com/tig-kira/termux-ultra/blob/main/app/src/main/java/com/termux/app/ssh/SshConnectionManager.java): `app/src/main/java/com/termux/app/ssh/SshConnectionManager.java`
- [VNC connections](https://github.com/tig-kira/termux-ultra/blob/main/app/src/main/java/com/termux/app/vnc/VncConnectionManager.java): `app/src/main/java/com/termux/app/vnc/VncConnectionManager.java`
- [AVNC client](https://github.com/tig-kira/termux-ultra/blob/main/app/src/main/java/com/gaurav/avnc/ui/vnc/LayoutManager.kt): `app/src/main/java/com/gaurav/avnc/ui/vnc/LayoutManager.kt`
- [VNC server library](https://github.com/tig-kira/termux-ultra/blob/main/app/extern/libvncserver/src/libvncserver/main.c): `app/extern/libvncserver/src/libvncserver/main.c`
- [JPEG support](https://github.com/tig-kira/termux-ultra/blob/main/app/extern/libjpeg-turbo/turbojpeg.c): `app/extern/libjpeg-turbo/turbojpeg.c`

### Other components

- **Android user**

## Connections

- Android user → App interface: opens (evidence: `README.md`)
- App interface → Session manager: manages sessions
- Session manager → Termux service: uses service (evidence: `app/src/main/java/com/termux/app/TermuxService.java`)
- Termux service → Terminal session: manages sessions (evidence: `app/src/main/java/com/termux/app/TermuxService.java`)
- Terminal session → Terminal callbacks: calls callbacks (evidence: `termux-shared/src/main/java/com/termux/terminal/TerminalSessionClient.java`)
- Termux service → Shell environment: configures shell (evidence: `app/src/main/java/com/termux/app/TermuxService.java`)
- App interface → File manager: opens (evidence: `README.md`)
- App interface → Storage management: opens
- App interface → AI assistant: opens assistant (evidence: `README.md`)
- AI assistant → Risk confirmation: confirms risky actions (evidence: `app/src/main/java/com/termux/app/compose/AiTermuxEngine.kt`)
- AI assistant → Terminal session: executes commands (evidence: `README.md`)
- AI assistant → SSH connections: starts connections (evidence: `README.md`)
- AI assistant → VNC connections: starts connections (evidence: `app/src/main/java/com/termux/app/compose/AiTermuxEngine.kt`)
- App interface → FTP server: offers transfers (evidence: `README.md`)
- App interface → Deployment resources: opens deployments (evidence: `README.md`)
- Deployment resources → Terminal session: installs via shell (evidence: `app/src/main/java/com/termux/app/TermuxService.java`)
- App interface → Plugin manager: opens plugin center (evidence: `README.md`)
- Plugin manager → Terminal session: runs persistent shell (evidence: `README.md`)
- App interface → SSH connections: manages connections (evidence: `README.md`)
- App interface → VNC connections: manages connections (evidence: `README.md`)
- VNC connections → AVNC client: uses client (evidence: `README.md`)
- AVNC client → VNC server library: connects remotely
- VNC server library → JPEG support: uses JPEG
