How awkox/androidterminal works
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: SessionListDrawer.kt Terminal workspace · TerminalView.kt Terminal view · SessionManager.kt Session manager · SessionListScreen.kt Session and SSH UI
Components 24
Android app
- Main activity
app/src/main/kotlin/com/awkoo/terminal/ui/MainActivity.kt - Terminal workspace
app/src/main/kotlin/com/awkoo/terminal/ui/compose/SessionListDrawer.kt - Session and SSH UI
app/src/main/kotlin/com/awkoo/terminal/ui/compose/SessionListScreen.kt - Terminal settings
app/src/main/kotlin/com/awkoo/terminal/ui/settings - App preferences
app/src/main/kotlin/com/awkoo/terminal/AppPreferences.kt - Extra keys
app/src/main/kotlin/com/awkoo/terminal/extrakeys
Sessions and connections
- Session manager
app/src/main/kotlin/com/awkoo/terminal/core/SessionManager.kt - SSH trust and keys
app/src/main/kotlin/com/awkoo/terminal/core
Terminal library
- Terminal session
libterminal/src/main/kotlin/com/awkoo/libterminal/engine/TerminalSession.kt - Terminal emulator
libterminal/src/main/kotlin/com/awkoo/libterminal/engine/TerminalEmulator.kt - VT and ANSI protocol
libterminal/src/main/kotlin/com/awkoo/libterminal/engine/protocol - Screen buffer
libterminal/src/main/kotlin/com/awkoo/libterminal/engine/buffer - Terminal view
libterminal/src/main/kotlin/com/awkoo/libterminal/view/TerminalView.kt - Terminal input
libterminal/src/main/kotlin/com/awkoo/libterminal/view/input - Text selection
libterminal/src/main/kotlin/com/awkoo/libterminal/view/textselection/TextSelectionCursorController.kt - Color schemes
libterminal/src/main/kotlin/com/awkoo/libterminal/color/TerminalColorScheme.kt
Process backends
- SSH fingerprint probe
libterminal-ssh/src/main/kotlin/com/awkoo/libterminal/ssh/SshPreConnector.kt - Local PTY backend
libterminal-pty/src/main/kotlin/com/awkoo/libterminal/pty/PtyFactory.kt - SSH backend
libterminal-ssh/src/main/kotlin/com/awkoo/libterminal/ssh/SshFactory.kt - Native PTY
libterminal-pty/src/main/cpp/pty.cpp - Native SSH
libterminal-ssh/src/main/cpp/sshterm.cpp
Other components
- User
- Local shell
- SSH host
Connections 21
- User → Main activity: opens
- Main activity → Terminal workspace: hosts
app/src/main/kotlin/com/awkoo/terminal/ui/MainActivity.kt - Terminal workspace → Session and SSH UI: shows
app/src/main/kotlin/com/awkoo/terminal/ui/compose/SessionListDrawer.kt - Terminal workspace → Terminal view: embeds
app/src/main/kotlin/com/awkoo/terminal/ui/compose/SessionListDrawer.kt - Terminal workspace → Extra keys: dispatches
app/src/main/kotlin/com/awkoo/terminal/ui/compose/SessionListDrawer.kt - Terminal workspace → Terminal settings: navigates
app/src/main/kotlin/com/awkoo/terminal/ui/compose/SessionListDrawer.kt - Session and SSH UI → SSH fingerprint probe: checks fingerprint
app/src/main/kotlin/com/awkoo/terminal/ui/compose/SessionListScreen.kt - Session and SSH UI → SSH trust and keys: checks trust
app/src/main/kotlin/com/awkoo/terminal/ui/compose/SessionListScreen.kt - Session manager → Terminal session: creates and runs
app/src/main/kotlin/com/awkoo/terminal/core/SessionManager.kt - Session manager → Local PTY backend: creates local process
app/src/main/kotlin/com/awkoo/terminal/core/SessionManager.kt - Session manager → SSH backend: creates SSH process
app/src/main/kotlin/com/awkoo/terminal/core/SessionManager.kt - Terminal session → Terminal emulator: feeds output
libterminal/src/main/kotlin/com/awkoo/libterminal/engine/TerminalSession.kt - Terminal view → Terminal session: displays current session
libterminal/src/main/kotlin/com/awkoo/libterminal/view/TerminalView.kt - Terminal view → Terminal input: handles interaction
libterminal/src/main/kotlin/com/awkoo/libterminal/view/TerminalView.kt - Terminal view → Text selection: supports selection
libterminal/src/main/kotlin/com/awkoo/libterminal/view/TerminalView.kt - Terminal emulator → VT and ANSI protocol: parses terminal protocol
libterminal/src/main/kotlin/com/awkoo/libterminal/engine/TerminalEmulator.kt - Terminal emulator → Screen buffer: maintains screen
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