# termux/termux-app architecture

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

- Interactive diagram: https://gitdiagram.com/termux/termux-app
- Repository: https://github.com/termux/termux-app

## Overview

Termux is an Android terminal application with a Linux shell environment; packages are installed inside the app but maintained by a separate repository. The principal workflow is to open the terminal, start or select a shell session, run a process, and display its output in the terminal view. The app also exposes command and file-sharing entry points, settings, and optional plugin integration. Several links below are documented by the README or SOURCE INDEX; dashed links mark relationships not verified in the sampled excerpts.

Main entry points: [`app/src/main/java/com/termux/app/TermuxService.java`](https://github.com/termux/termux-app/blob/master/app/src/main/java/com/termux/app/TermuxService.java) (Terminal service), [`app/src/main/java/com/termux/app/TermuxActivity.java`](https://github.com/termux/termux-app/blob/master/app/src/main/java/com/termux/app/TermuxActivity.java) (Terminal activity), [`terminal-emulator/src/main/java/com/termux/terminal/TerminalSession.java`](https://github.com/termux/termux-app/blob/master/terminal-emulator/src/main/java/com/termux/terminal/TerminalSession.java) (PTY session), [`terminal-view/src/main/java/com/termux/view/TerminalView.java`](https://github.com/termux/termux-app/blob/master/terminal-view/src/main/java/com/termux/view/TerminalView.java) (Terminal view)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Terminal interface"]
  node_activity["Terminal activity"]
  node_session_ui["Session client"]
  node_sessions_list["Session list"]
  node_terminal_view["Terminal view<br/>[TerminalView.java]"]
  node_renderer["Text renderer"]
end

subgraph group_runtime["Shell runtime"]
  node_service["Terminal service<br/>[TermuxService.java]"]
  node_shell_manager["Shell manager"]
  node_termux_session["Shell session<br/>[TermuxSession.java]"]
  node_terminal_session["PTY session"]
  node_emulator["Terminal emulator"]
end

subgraph group_integration["App integrations"]
  node_command_service["Command service"]
  node_file_receiver["File receiver"]
  node_open_receiver["Open receiver"]
  node_settings["Settings UI"]
end

subgraph group_shared["Shared services"]
  node_preferences["App preferences"]
  node_constants["App contracts"]
  node_file_utils["File utilities<br/>[FileUtils.java]"]
  node_local_sockets["Local sockets"]
end

node_user(("Android user"))
node_linux_env["Linux environment"]

node_user -.->|"opens"| node_activity
node_activity -.->|"manages UI"| node_session_ui
node_activity -.->|"binds service"| node_service
node_session_ui -.->|"selects sessions"| node_service
node_sessions_list -->|"updates selection"| node_activity
node_terminal_view -->|"renders text"| node_renderer
node_activity -.->|"displays terminal"| node_terminal_view
node_service -->|"manages shells"| node_shell_manager
node_shell_manager -->|"creates sessions"| node_termux_session
node_termux_session -->|"starts PTY"| node_terminal_session
node_terminal_session -->|"updates state"| node_emulator
node_terminal_session -.->|"sends output"| node_terminal_view
node_linux_env -.->|"runs shell"| node_terminal_session
node_command_service -->|"dispatches commands"| node_service
node_file_receiver -.->|"passes files"| node_service
node_open_receiver -.->|"opens app"| node_activity
node_user -.->|"configures"| node_settings
node_settings -.->|"edits preferences"| node_preferences
node_command_service -->|"uses contracts"| node_constants
node_file_receiver -.->|"handles files"| node_file_utils
node_service -->|"reads settings"| node_preferences
node_user -.->|"runs commands"| node_linux_env
node_service -.->|"uses sockets"| node_local_sockets

click node_activity "https://github.com/termux/termux-app/blob/master/app/src/main/java/com/termux/app/TermuxActivity.java"
click node_session_ui "https://github.com/termux/termux-app/blob/master/app/src/main/java/com/termux/app/terminal/TermuxTerminalSessionActivityClient.java"
click node_sessions_list "https://github.com/termux/termux-app/blob/master/app/src/main/java/com/termux/app/terminal/TermuxSessionsListViewController.java"
click node_terminal_view "https://github.com/termux/termux-app/blob/master/terminal-view/src/main/java/com/termux/view/TerminalView.java"
click node_renderer "https://github.com/termux/termux-app/blob/master/terminal-view/src/main/java/com/termux/view/TerminalRenderer.java"
click node_service "https://github.com/termux/termux-app/blob/master/app/src/main/java/com/termux/app/TermuxService.java"
click node_shell_manager "https://github.com/termux/termux-app/blob/master/termux-shared/src/main/java/com/termux/shared/termux/shell/TermuxShellManager.java"
click node_termux_session "https://github.com/termux/termux-app/blob/master/termux-shared/src/main/java/com/termux/shared/termux/shell/command/runner/terminal/TermuxSession.java"
click node_terminal_session "https://github.com/termux/termux-app/blob/master/terminal-emulator/src/main/java/com/termux/terminal/TerminalSession.java"
click node_emulator "https://github.com/termux/termux-app/blob/master/terminal-emulator/src/main/java/com/termux/terminal/TerminalEmulator.java"
click node_command_service "https://github.com/termux/termux-app/blob/master/app/src/main/java/com/termux/app/RunCommandService.java"
click node_file_receiver "https://github.com/termux/termux-app/blob/master/app/src/main/java/com/termux/app/api/file/FileReceiverActivity.java"
click node_open_receiver "https://github.com/termux/termux-app/blob/master/app/src/main/java/com/termux/app/TermuxOpenReceiver.java"
click node_settings "https://github.com/termux/termux-app/blob/master/app/src/main/java/com/termux/app/activities/SettingsActivity.java"
click node_preferences "https://github.com/termux/termux-app/blob/master/termux-shared/src/main/java/com/termux/shared/termux/settings/preferences/TermuxAppSharedPreferences.java"
click node_constants "https://github.com/termux/termux-app/blob/master/termux-shared/src/main/java/com/termux/shared/termux/TermuxConstants.java"
click node_file_utils "https://github.com/termux/termux-app/blob/master/termux-shared/src/main/java/com/termux/shared/file/FileUtils.java"
click node_local_sockets "https://github.com/termux/termux-app/blob/master/termux-shared/src/main/java/com/termux/shared/net/socket/local/LocalSocketManager.java"

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_activity,node_session_ui,node_sessions_list,node_terminal_view,node_renderer,node_user toneBlue
class node_service,node_shell_manager,node_termux_session,node_terminal_session,node_emulator toneAmber
class node_command_service,node_file_receiver,node_open_receiver,node_settings toneMint
class node_preferences,node_constants,node_file_utils,node_local_sockets toneRose
class node_linux_env toneIndigo
```

## Components

### Terminal interface

- [Terminal activity](https://github.com/termux/termux-app/blob/master/app/src/main/java/com/termux/app/TermuxActivity.java): `app/src/main/java/com/termux/app/TermuxActivity.java`
- [Session client](https://github.com/termux/termux-app/blob/master/app/src/main/java/com/termux/app/terminal/TermuxTerminalSessionActivityClient.java): `app/src/main/java/com/termux/app/terminal/TermuxTerminalSessionActivityClient.java`
- [Session list](https://github.com/termux/termux-app/blob/master/app/src/main/java/com/termux/app/terminal/TermuxSessionsListViewController.java): `app/src/main/java/com/termux/app/terminal/TermuxSessionsListViewController.java`
- [Terminal view](https://github.com/termux/termux-app/blob/master/terminal-view/src/main/java/com/termux/view/TerminalView.java): `terminal-view/src/main/java/com/termux/view/TerminalView.java`
- [Text renderer](https://github.com/termux/termux-app/blob/master/terminal-view/src/main/java/com/termux/view/TerminalRenderer.java): `terminal-view/src/main/java/com/termux/view/TerminalRenderer.java`

### Shell runtime

- [Terminal service](https://github.com/termux/termux-app/blob/master/app/src/main/java/com/termux/app/TermuxService.java): `app/src/main/java/com/termux/app/TermuxService.java`
- [Shell manager](https://github.com/termux/termux-app/blob/master/termux-shared/src/main/java/com/termux/shared/termux/shell/TermuxShellManager.java): `termux-shared/src/main/java/com/termux/shared/termux/shell/TermuxShellManager.java`
- [Shell session](https://github.com/termux/termux-app/blob/master/termux-shared/src/main/java/com/termux/shared/termux/shell/command/runner/terminal/TermuxSession.java): `termux-shared/src/main/java/com/termux/shared/termux/shell/command/runner/terminal/TermuxSession.java`
- [PTY session](https://github.com/termux/termux-app/blob/master/terminal-emulator/src/main/java/com/termux/terminal/TerminalSession.java): `terminal-emulator/src/main/java/com/termux/terminal/TerminalSession.java`
- [Terminal emulator](https://github.com/termux/termux-app/blob/master/terminal-emulator/src/main/java/com/termux/terminal/TerminalEmulator.java): `terminal-emulator/src/main/java/com/termux/terminal/TerminalEmulator.java`

### App integrations

- [Command service](https://github.com/termux/termux-app/blob/master/app/src/main/java/com/termux/app/RunCommandService.java): `app/src/main/java/com/termux/app/RunCommandService.java`
- [File receiver](https://github.com/termux/termux-app/blob/master/app/src/main/java/com/termux/app/api/file/FileReceiverActivity.java): `app/src/main/java/com/termux/app/api/file/FileReceiverActivity.java`
- [Open receiver](https://github.com/termux/termux-app/blob/master/app/src/main/java/com/termux/app/TermuxOpenReceiver.java): `app/src/main/java/com/termux/app/TermuxOpenReceiver.java`
- [Settings UI](https://github.com/termux/termux-app/blob/master/app/src/main/java/com/termux/app/activities/SettingsActivity.java): `app/src/main/java/com/termux/app/activities/SettingsActivity.java`

### Shared services

- [App preferences](https://github.com/termux/termux-app/blob/master/termux-shared/src/main/java/com/termux/shared/termux/settings/preferences/TermuxAppSharedPreferences.java): `termux-shared/src/main/java/com/termux/shared/termux/settings/preferences/TermuxAppSharedPreferences.java`
- [App contracts](https://github.com/termux/termux-app/blob/master/termux-shared/src/main/java/com/termux/shared/termux/TermuxConstants.java): `termux-shared/src/main/java/com/termux/shared/termux/TermuxConstants.java`
- [File utilities](https://github.com/termux/termux-app/blob/master/termux-shared/src/main/java/com/termux/shared/file/FileUtils.java): `termux-shared/src/main/java/com/termux/shared/file/FileUtils.java`
- [Local sockets](https://github.com/termux/termux-app/blob/master/termux-shared/src/main/java/com/termux/shared/net/socket/local/LocalSocketManager.java): `termux-shared/src/main/java/com/termux/shared/net/socket/local/LocalSocketManager.java`

### Other components

- **Android user**
- **Linux environment**

## Connections

- Android user → Terminal activity: opens (evidence: `README.md`)
- Terminal activity → Session client: manages UI (evidence: `app/src/main/java/com/termux/app/TermuxActivity.java`)
- Terminal activity → Terminal service: binds service (evidence: `app/src/main/java/com/termux/app/TermuxActivity.java`)
- Session client → Terminal service: selects sessions (evidence: `app/src/main/java/com/termux/app/terminal/TermuxTerminalSessionActivityClient.java`)
- Session list → Terminal activity: updates selection (evidence: `app/src/main/java/com/termux/app/terminal/TermuxSessionsListViewController.java`)
- Terminal view → Text renderer: renders text (evidence: `terminal-view/src/main/java/com/termux/view/TerminalView.java`)
- Terminal activity → Terminal view: displays terminal (evidence: `app/src/main/java/com/termux/app/TermuxActivity.java`)
- Terminal service → Shell manager: manages shells (evidence: `app/src/main/java/com/termux/app/TermuxService.java`)
- Shell manager → Shell session: creates sessions (evidence: `termux-shared/src/main/java/com/termux/shared/termux/shell/TermuxShellManager.java`)
- Shell session → PTY session: starts PTY (evidence: `termux-shared/src/main/java/com/termux/shared/termux/shell/command/runner/terminal/TermuxSession.java`)
- PTY session → Terminal emulator: updates state (evidence: `terminal-emulator/src/main/java/com/termux/terminal/TerminalSession.java`)
- PTY session → Terminal view: sends output (evidence: `terminal-view/src/main/java/com/termux/view/TerminalView.java`)
- Linux environment → PTY session: runs shell (evidence: `README.md`)
- Command service → Terminal service: dispatches commands (evidence: `app/src/main/java/com/termux/app/RunCommandService.java`)
- File receiver → Terminal service: passes files (evidence: `app/src/main/java/com/termux/app/api/file/FileReceiverActivity.java`)
- Open receiver → Terminal activity: opens app
- Android user → Settings UI: configures
- Settings UI → App preferences: edits preferences
- Command service → App contracts: uses contracts (evidence: `app/src/main/java/com/termux/app/RunCommandService.java`)
- File receiver → File utilities: handles files
- Terminal service → App preferences: reads settings (evidence: `app/src/main/java/com/termux/app/TermuxService.java`)
- Android user → Linux environment: runs commands (evidence: `README.md`)
- Terminal service → Local sockets: uses sockets
