Terminal Settings
Relevant source files
The following files were used as context for generating this wiki page:
Terminal Settings configures the built-in Linux terminal emulator within Acode. The terminal environment operates using proot with Alpine Linux to provide a command-line interface directly in the editor workspace.
Users modify these settings to adjust terminal aesthetics, manage system-level storage permissions, and control the lifecycle of the terminal installation, including backups and uninstallation.
Sources: user-guide/terminal.md:5, user-guide/settings/terminal-settings.md:1-3
Accessing Terminal Settings
You access Terminal Settings through the main application settings menu. The following sequence shows the interaction flow to reach the configuration page:
The diagram represents the navigational steps from the primary UI to the terminal-specific configuration module.
Sources: user-guide/settings.md:13-25, user-guide/settings/terminal-settings.md:1-3
Permissions
Terminal operations require specific Android permissions to interact with the device filesystem.
| Setting | Description | Constraints |
|---|---|---|
| All Files Access | Grants full internal storage access to the terminal environment. | Requires Android 10+; Not available in Play Store version. |
Sources: user-guide/settings/terminal-settings.md:7-9, user-guide/terminal.md:18-20
Appearance Customization
The appearance section controls the visual rendering of the terminal emulator, including font styles and cursor behavior. Terminal fonts are managed via the general App Settings font management system.
| Setting | Description |
|---|---|
| Font Size | Sets the pixel size of terminal text. |
| Font Family | Selects the typeface for terminal rendering. |
| Theme | Selects a color scheme for the terminal interface. |
| Cursor Style | Defines the shape (block, underline, or bar). |
| Cursor Inactive Style | Defines appearance when the terminal loses focus. |
| Font Weight | Sets the thickness of non-bold text. |
| Cursor Blink | Toggles the cursor blinking animation. |
| Font Ligatures | Enables or disables font ligature rendering. |
| Letter Spacing | Sets pixel spacing between characters. |
Sources: user-guide/settings/terminal-settings.md:13-23, user-guide/settings/app-settings.md:32-34
Terminal Behavior
Behavioral settings define how the terminal processes data, handles scrolling, and interacts with the user interface.
The flowchart illustrates the logic for tab management, buffer handling, and input processing defined in the behavior settings.
| Setting | Description |
|---|---|
| Scrollback Lines | Sets the number of rows retained outside the viewport. |
| Tab Stop Width | Sets the width of tab characters in the terminal. |
| Convert EOL | Manages end-of-line character conversion. |
| Image Support | Toggles support for rendering images within the terminal. |
| Confirm Terminal Tab Close | Toggles the confirmation dialog when closing terminal tabs. |
Sources: user-guide/settings/terminal-settings.md:27-33
Installation Management
Users manage the physical terminal environment (Alpine Linux via proot) through maintenance actions. These actions affect the persistence and existence of the terminal files on the device.
| Action | Result |
|---|---|
| Backup | Creates a copy of the terminal installation and current configuration. |
| Restore | Replaces the current installation with a previously created backup. |
| Uninstall | Deletes the terminal environment and all associated files. |
Sources: user-guide/settings/terminal-settings.md:37-41, user-guide/terminal.md:112-118
Reinstallation Logic
If the terminal fails to start or encounters package errors, the recommended workflow involves the Installation Management tools.
The flowchart describes the troubleshooting and reinstallation path for the terminal system.
Sources: user-guide/terminal.md:120-123
Integration with Editor Functions
Terminal settings interact with the Acode CLI tool and background services. The terminal runs as a foreground service to prevent the device from killing the process while it is in the background. The acode CLI tool allows the terminal to send commands back to the editor, such as opening files or folders based on the current terminal path.
Sources: user-guide/terminal.md:12-14, user-guide/terminal.md:46-56
Summary
Terminal Settings provides a comprehensive interface for managing the Acode terminal environment. It bridges the gap between the Android OS (permissions), the visual interface (appearance), and the underlying Alpine Linux installation (management). These configurations ensure the terminal remains a stable, customizable tool for executing commands and managing projects via the CLI.