How termux/termux-app works
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: TermuxService.java Terminal service · TermuxActivity.java Terminal activity · TerminalSession.java PTY session · TerminalView.java Terminal view
Components 20
Terminal interface
- Terminal activity
app/src/main/java/com/termux/app/TermuxActivity.java - Session client
app/src/main/java/com/termux/app/terminal/TermuxTerminalSessionActivityClient.java - Session list
app/src/main/java/com/termux/app/terminal/TermuxSessionsListViewController.java - Terminal view
terminal-view/src/main/java/com/termux/view/TerminalView.java - Text renderer
terminal-view/src/main/java/com/termux/view/TerminalRenderer.java
Shell runtime
- Terminal service
app/src/main/java/com/termux/app/TermuxService.java - Shell manager
termux-shared/src/main/java/com/termux/shared/termux/shell/TermuxShellManager.java - Shell session
termux-shared/src/main/java/com/termux/shared/termux/shell/command/runner/terminal/TermuxSession.java - PTY session
terminal-emulator/src/main/java/com/termux/terminal/TerminalSession.java - Terminal emulator
terminal-emulator/src/main/java/com/termux/terminal/TerminalEmulator.java
App integrations
- Command service
app/src/main/java/com/termux/app/RunCommandService.java - File receiver
app/src/main/java/com/termux/app/api/file/FileReceiverActivity.java - Open receiver
app/src/main/java/com/termux/app/TermuxOpenReceiver.java - Settings UI
app/src/main/java/com/termux/app/activities/SettingsActivity.java
Shared services
- App preferences
termux-shared/src/main/java/com/termux/shared/termux/settings/preferences/TermuxAppSharedPreferences.java - App contracts
termux-shared/src/main/java/com/termux/shared/termux/TermuxConstants.java - File utilities
termux-shared/src/main/java/com/termux/shared/file/FileUtils.java - Local sockets
termux-shared/src/main/java/com/termux/shared/net/socket/local/LocalSocketManager.java
Other components
- Android user
- Linux environment
Connections 23
- Android user → Terminal activity: opens
README.md - Terminal activity → Session client: manages UI
app/src/main/java/com/termux/app/TermuxActivity.java - Terminal activity → Terminal service: binds service
app/src/main/java/com/termux/app/TermuxActivity.java - Session client → Terminal service: selects sessions
app/src/main/java/com/termux/app/terminal/TermuxTerminalSessionActivityClient.java - Session list → Terminal activity: updates selection
app/src/main/java/com/termux/app/terminal/TermuxSessionsListViewController.java - Terminal view → Text renderer: renders text
terminal-view/src/main/java/com/termux/view/TerminalView.java - Terminal activity → Terminal view: displays terminal
app/src/main/java/com/termux/app/TermuxActivity.java - Terminal service → Shell manager: manages shells
app/src/main/java/com/termux/app/TermuxService.java - Shell manager → Shell session: creates sessions
termux-shared/src/main/java/com/termux/shared/termux/shell/TermuxShellManager.java - Shell session → PTY session: starts PTY
termux-shared/src/main/java/com/termux/shared/termux/shell/command/runner/terminal/TermuxSession.java - PTY session → Terminal emulator: updates state
terminal-emulator/src/main/java/com/termux/terminal/TerminalSession.java - PTY session → Terminal view: sends output
terminal-view/src/main/java/com/termux/view/TerminalView.java - Linux environment → PTY session: runs shell
README.md - Command service → Terminal service: dispatches commands
app/src/main/java/com/termux/app/RunCommandService.java - File receiver → Terminal service: passes files
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
app/src/main/java/com/termux/app/RunCommandService.java - File receiver → File utilities: handles files
- Terminal service → App preferences: reads settings
app/src/main/java/com/termux/app/TermuxService.java - Android user → Linux environment: runs commands
README.md - Terminal service → Local sockets: uses sockets