# awkox/androidterminal architecture

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

- Interactive diagram: https://gitdiagram.com/awkox/androidterminal
- Repository: https://github.com/awkox/androidterminal

## Overview

AndroidTerminal is an Android terminal app built around the reusable libterminal emulator, with separate PTY and SSH process modules. The principal workflow is choosing a local or SSH session, creating and running its process-backed terminal session, then using the terminal view for display and interaction. The README establishes the major library capabilities; source excerpts and the SOURCE INDEX support the central session, connection, emulator, and UI links. Unsampled parser, rendering, and settings internals are represented by their exact source directories where appropriate; uncertain links are omitted.

Main entry points: [`app/src/main/kotlin/com/awkoo/terminal/ui/compose/SessionListDrawer.kt`](https://github.com/awkox/androidterminal/blob/main/app/src/main/kotlin/com/awkoo/terminal/ui/compose/SessionListDrawer.kt) (Terminal workspace), [`libterminal/src/main/kotlin/com/awkoo/libterminal/view/TerminalView.kt`](https://github.com/awkox/androidterminal/blob/main/libterminal/src/main/kotlin/com/awkoo/libterminal/view/TerminalView.kt) (Terminal view), [`app/src/main/kotlin/com/awkoo/terminal/core/SessionManager.kt`](https://github.com/awkox/androidterminal/blob/main/app/src/main/kotlin/com/awkoo/terminal/core/SessionManager.kt) (Session manager), [`app/src/main/kotlin/com/awkoo/terminal/ui/compose/SessionListScreen.kt`](https://github.com/awkox/androidterminal/blob/main/app/src/main/kotlin/com/awkoo/terminal/ui/compose/SessionListScreen.kt) (Session and SSH UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Android app"]
  node_activity["Main activity<br/>[MainActivity.kt]"]
  node_drawer["Terminal workspace"]
  node_sessionlist["Session and SSH UI"]
  node_settings["Terminal settings"]
  node_preferences["App preferences<br/>[AppPreferences.kt]"]
  node_extrakeys["Extra keys"]
end

subgraph group_session["Sessions and connections"]
  node_manager["Session manager<br/>[SessionManager.kt]"]
  node_trust["SSH trust and keys"]
end

subgraph group_terminal["Terminal library"]
  node_tsession["Terminal session<br/>[TerminalSession.kt]"]
  node_emulator["Terminal emulator"]
  node_protocol["VT and ANSI protocol"]
  node_buffer["Screen buffer"]
  node_view["Terminal view<br/>[TerminalView.kt]"]
  node_input["Terminal input"]
  node_selection["Text selection"]
  node_colors["Color schemes"]
end

subgraph group_process["Process backends"]
  node_sshprobe["SSH fingerprint probe<br/>[SshPreConnector.kt]"]
  node_pty["Local PTY backend<br/>[PtyFactory.kt]"]
  node_ssh["SSH backend<br/>[SshFactory.kt]"]
  node_nativepty["Native PTY<br/>[pty.cpp]"]
  node_nativessh["Native SSH<br/>[sshterm.cpp]"]
end

node_user(("User"))
node_shell(("Local shell"))
node_host(("SSH host"))

node_user -->|"opens"| node_activity
node_activity -->|"hosts"| node_drawer
node_drawer -->|"shows"| node_sessionlist
node_drawer -->|"embeds"| node_view
node_drawer -->|"dispatches"| node_extrakeys
node_drawer -->|"navigates"| node_settings
node_sessionlist -->|"checks fingerprint"| node_sshprobe
node_sessionlist -->|"checks trust"| node_trust
node_manager -->|"creates and runs"| node_tsession
node_manager -->|"creates local process"| node_pty
node_manager -->|"creates SSH process"| node_ssh
node_tsession -->|"feeds output"| node_emulator
node_view -->|"displays current session"| node_tsession
node_view -->|"handles interaction"| node_input
node_view -->|"supports selection"| node_selection
node_emulator -.->|"parses terminal protocol"| node_protocol
node_emulator -.->|"maintains screen"| node_buffer
node_pty -.->|"uses JNI backend"| node_nativepty
node_ssh -.->|"uses JNI backend"| node_nativessh
node_nativepty -.->|"runs"| node_shell
node_nativessh -.->|"connects"| node_host

click node_activity "https://github.com/awkox/androidterminal/blob/main/app/src/main/kotlin/com/awkoo/terminal/ui/MainActivity.kt"
click node_drawer "https://github.com/awkox/androidterminal/blob/main/app/src/main/kotlin/com/awkoo/terminal/ui/compose/SessionListDrawer.kt"
click node_sessionlist "https://github.com/awkox/androidterminal/blob/main/app/src/main/kotlin/com/awkoo/terminal/ui/compose/SessionListScreen.kt"
click node_settings "https://github.com/awkox/androidterminal/tree/main/app/src/main/kotlin/com/awkoo/terminal/ui/settings"
click node_preferences "https://github.com/awkox/androidterminal/blob/main/app/src/main/kotlin/com/awkoo/terminal/AppPreferences.kt"
click node_extrakeys "https://github.com/awkox/androidterminal/tree/main/app/src/main/kotlin/com/awkoo/terminal/extrakeys"
click node_manager "https://github.com/awkox/androidterminal/blob/main/app/src/main/kotlin/com/awkoo/terminal/core/SessionManager.kt"
click node_trust "https://github.com/awkox/androidterminal/tree/main/app/src/main/kotlin/com/awkoo/terminal/core"
click node_sshprobe "https://github.com/awkox/androidterminal/blob/main/libterminal-ssh/src/main/kotlin/com/awkoo/libterminal/ssh/SshPreConnector.kt"
click node_tsession "https://github.com/awkox/androidterminal/blob/main/libterminal/src/main/kotlin/com/awkoo/libterminal/engine/TerminalSession.kt"
click node_emulator "https://github.com/awkox/androidterminal/blob/main/libterminal/src/main/kotlin/com/awkoo/libterminal/engine/TerminalEmulator.kt"
click node_protocol "https://github.com/awkox/androidterminal/tree/main/libterminal/src/main/kotlin/com/awkoo/libterminal/engine/protocol"
click node_buffer "https://github.com/awkox/androidterminal/tree/main/libterminal/src/main/kotlin/com/awkoo/libterminal/engine/buffer"
click node_view "https://github.com/awkox/androidterminal/blob/main/libterminal/src/main/kotlin/com/awkoo/libterminal/view/TerminalView.kt"
click node_input "https://github.com/awkox/androidterminal/tree/main/libterminal/src/main/kotlin/com/awkoo/libterminal/view/input"
click node_selection "https://github.com/awkox/androidterminal/blob/main/libterminal/src/main/kotlin/com/awkoo/libterminal/view/textselection/TextSelectionCursorController.kt"
click node_colors "https://github.com/awkox/androidterminal/blob/main/libterminal/src/main/kotlin/com/awkoo/libterminal/color/TerminalColorScheme.kt"
click node_pty "https://github.com/awkox/androidterminal/blob/main/libterminal-pty/src/main/kotlin/com/awkoo/libterminal/pty/PtyFactory.kt"
click node_ssh "https://github.com/awkox/androidterminal/blob/main/libterminal-ssh/src/main/kotlin/com/awkoo/libterminal/ssh/SshFactory.kt"
click node_nativepty "https://github.com/awkox/androidterminal/blob/main/libterminal-pty/src/main/cpp/pty.cpp"
click node_nativessh "https://github.com/awkox/androidterminal/blob/main/libterminal-ssh/src/main/cpp/sshterm.cpp"

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_drawer,node_sessionlist,node_settings,node_preferences,node_extrakeys,node_user toneBlue
class node_manager,node_trust toneAmber
class node_tsession,node_emulator,node_protocol,node_buffer,node_view,node_input,node_selection,node_colors toneMint
class node_sshprobe,node_pty,node_ssh,node_nativepty,node_nativessh toneRose
class node_shell,node_host toneIndigo
```

## Components

### Android app

- [Main activity](https://github.com/awkox/androidterminal/blob/main/app/src/main/kotlin/com/awkoo/terminal/ui/MainActivity.kt): `app/src/main/kotlin/com/awkoo/terminal/ui/MainActivity.kt`
- [Terminal workspace](https://github.com/awkox/androidterminal/blob/main/app/src/main/kotlin/com/awkoo/terminal/ui/compose/SessionListDrawer.kt): `app/src/main/kotlin/com/awkoo/terminal/ui/compose/SessionListDrawer.kt`
- [Session and SSH UI](https://github.com/awkox/androidterminal/blob/main/app/src/main/kotlin/com/awkoo/terminal/ui/compose/SessionListScreen.kt): `app/src/main/kotlin/com/awkoo/terminal/ui/compose/SessionListScreen.kt`
- [Terminal settings](https://github.com/awkox/androidterminal/tree/main/app/src/main/kotlin/com/awkoo/terminal/ui/settings): `app/src/main/kotlin/com/awkoo/terminal/ui/settings`
- [App preferences](https://github.com/awkox/androidterminal/blob/main/app/src/main/kotlin/com/awkoo/terminal/AppPreferences.kt): `app/src/main/kotlin/com/awkoo/terminal/AppPreferences.kt`
- [Extra keys](https://github.com/awkox/androidterminal/tree/main/app/src/main/kotlin/com/awkoo/terminal/extrakeys): `app/src/main/kotlin/com/awkoo/terminal/extrakeys`

### Sessions and connections

- [Session manager](https://github.com/awkox/androidterminal/blob/main/app/src/main/kotlin/com/awkoo/terminal/core/SessionManager.kt): `app/src/main/kotlin/com/awkoo/terminal/core/SessionManager.kt`
- [SSH trust and keys](https://github.com/awkox/androidterminal/tree/main/app/src/main/kotlin/com/awkoo/terminal/core): `app/src/main/kotlin/com/awkoo/terminal/core`

### Terminal library

- [Terminal session](https://github.com/awkox/androidterminal/blob/main/libterminal/src/main/kotlin/com/awkoo/libterminal/engine/TerminalSession.kt): `libterminal/src/main/kotlin/com/awkoo/libterminal/engine/TerminalSession.kt`
- [Terminal emulator](https://github.com/awkox/androidterminal/blob/main/libterminal/src/main/kotlin/com/awkoo/libterminal/engine/TerminalEmulator.kt): `libterminal/src/main/kotlin/com/awkoo/libterminal/engine/TerminalEmulator.kt`
- [VT and ANSI protocol](https://github.com/awkox/androidterminal/tree/main/libterminal/src/main/kotlin/com/awkoo/libterminal/engine/protocol): `libterminal/src/main/kotlin/com/awkoo/libterminal/engine/protocol`
- [Screen buffer](https://github.com/awkox/androidterminal/tree/main/libterminal/src/main/kotlin/com/awkoo/libterminal/engine/buffer): `libterminal/src/main/kotlin/com/awkoo/libterminal/engine/buffer`
- [Terminal view](https://github.com/awkox/androidterminal/blob/main/libterminal/src/main/kotlin/com/awkoo/libterminal/view/TerminalView.kt): `libterminal/src/main/kotlin/com/awkoo/libterminal/view/TerminalView.kt`
- [Terminal input](https://github.com/awkox/androidterminal/tree/main/libterminal/src/main/kotlin/com/awkoo/libterminal/view/input): `libterminal/src/main/kotlin/com/awkoo/libterminal/view/input`
- [Text selection](https://github.com/awkox/androidterminal/blob/main/libterminal/src/main/kotlin/com/awkoo/libterminal/view/textselection/TextSelectionCursorController.kt): `libterminal/src/main/kotlin/com/awkoo/libterminal/view/textselection/TextSelectionCursorController.kt`
- [Color schemes](https://github.com/awkox/androidterminal/blob/main/libterminal/src/main/kotlin/com/awkoo/libterminal/color/TerminalColorScheme.kt): `libterminal/src/main/kotlin/com/awkoo/libterminal/color/TerminalColorScheme.kt`

### Process backends

- [SSH fingerprint probe](https://github.com/awkox/androidterminal/blob/main/libterminal-ssh/src/main/kotlin/com/awkoo/libterminal/ssh/SshPreConnector.kt): `libterminal-ssh/src/main/kotlin/com/awkoo/libterminal/ssh/SshPreConnector.kt`
- [Local PTY backend](https://github.com/awkox/androidterminal/blob/main/libterminal-pty/src/main/kotlin/com/awkoo/libterminal/pty/PtyFactory.kt): `libterminal-pty/src/main/kotlin/com/awkoo/libterminal/pty/PtyFactory.kt`
- [SSH backend](https://github.com/awkox/androidterminal/blob/main/libterminal-ssh/src/main/kotlin/com/awkoo/libterminal/ssh/SshFactory.kt): `libterminal-ssh/src/main/kotlin/com/awkoo/libterminal/ssh/SshFactory.kt`
- [Native PTY](https://github.com/awkox/androidterminal/blob/main/libterminal-pty/src/main/cpp/pty.cpp): `libterminal-pty/src/main/cpp/pty.cpp`
- [Native SSH](https://github.com/awkox/androidterminal/blob/main/libterminal-ssh/src/main/cpp/sshterm.cpp): `libterminal-ssh/src/main/cpp/sshterm.cpp`

### Other components

- **User**
- **Local shell**
- **SSH host**

## Connections

- User → Main activity: opens
- Main activity → Terminal workspace: hosts (evidence: `app/src/main/kotlin/com/awkoo/terminal/ui/MainActivity.kt`)
- Terminal workspace → Session and SSH UI: shows (evidence: `app/src/main/kotlin/com/awkoo/terminal/ui/compose/SessionListDrawer.kt`)
- Terminal workspace → Terminal view: embeds (evidence: `app/src/main/kotlin/com/awkoo/terminal/ui/compose/SessionListDrawer.kt`)
- Terminal workspace → Extra keys: dispatches (evidence: `app/src/main/kotlin/com/awkoo/terminal/ui/compose/SessionListDrawer.kt`)
- Terminal workspace → Terminal settings: navigates (evidence: `app/src/main/kotlin/com/awkoo/terminal/ui/compose/SessionListDrawer.kt`)
- Session and SSH UI → SSH fingerprint probe: checks fingerprint (evidence: `app/src/main/kotlin/com/awkoo/terminal/ui/compose/SessionListScreen.kt`)
- Session and SSH UI → SSH trust and keys: checks trust (evidence: `app/src/main/kotlin/com/awkoo/terminal/ui/compose/SessionListScreen.kt`)
- Session manager → Terminal session: creates and runs (evidence: `app/src/main/kotlin/com/awkoo/terminal/core/SessionManager.kt`)
- Session manager → Local PTY backend: creates local process (evidence: `app/src/main/kotlin/com/awkoo/terminal/core/SessionManager.kt`)
- Session manager → SSH backend: creates SSH process (evidence: `app/src/main/kotlin/com/awkoo/terminal/core/SessionManager.kt`)
- Terminal session → Terminal emulator: feeds output (evidence: `libterminal/src/main/kotlin/com/awkoo/libterminal/engine/TerminalSession.kt`)
- Terminal view → Terminal session: displays current session (evidence: `libterminal/src/main/kotlin/com/awkoo/libterminal/view/TerminalView.kt`)
- Terminal view → Terminal input: handles interaction (evidence: `libterminal/src/main/kotlin/com/awkoo/libterminal/view/TerminalView.kt`)
- Terminal view → Text selection: supports selection (evidence: `libterminal/src/main/kotlin/com/awkoo/libterminal/view/TerminalView.kt`)
- Terminal emulator → VT and ANSI protocol: parses terminal protocol (evidence: `libterminal/src/main/kotlin/com/awkoo/libterminal/engine/TerminalEmulator.kt`)
- Terminal emulator → Screen buffer: maintains screen (evidence: `libterminal/src/main/kotlin/com/awkoo/libterminal/engine/TerminalEmulator.kt`)
- Local PTY backend → Native PTY: uses JNI backend
- SSH backend → Native SSH: uses JNI backend
- Native PTY → Local shell: runs
- Native SSH → SSH host: connects
