Phone terminal
Open Terminal from the application catalog. It runs Bash alongside the other phone applications, with command editing, completion, history, reverse search and scrollback. The shell uses the application’s account. Use the USB shell for commands that require administrative access or a full computer keyboard.
Terminal displays shell text in a monospaced Terminus bitmap font and fits its rows and columns to the available screen. It starts with 6 × 12 pixel cells on a narrow screen and 8 × 16 pixel cells on wider screens. Choose Options → Font size to change the size; Terminal remembers your choice. The terminal text area stays dark in both system themes. Menus and other interface text use the system theme and shared interface font. A narrow screen shows fewer columns; long commands wrap. Terminal does not change the font of the Linux text console.
Type with the keypad
Section titled “Type with the keypad”Press a digit repeatedly to choose a character, then pause or press another digit to send it. The pending character stays highlighted at the cursor until sent. With line wrapping enabled, a pending character after a full row previews the next row; at the bottom, the view temporarily shifts up to keep both the pending character and the last output visible. Clear cancels the character and restores the output. The header shows the input mode on the right, preceded by any modifiers armed for the next phone key. When space is tight, C, A and S stand for Ctrl, Alt and Shift; the title shortens to leave the indicators visible.
| Key | Action |
|---|---|
| Digits | Multi-tap text, or digits in 123 mode |
| 1 | Punctuation |
| 0 | Space |
| Hold a digit | Type that digit |
| * | Open the shared symbol grid |
| # | Change letter case; from 123, return to letters |
| Hold # | Switch between letters and 123 |
| Hold * | Select the next installed input language |
| Clear | Cancel a pending letter or modifiers, otherwise Backspace; hold to repeat |
| Centre | Enter |
| Dial | Tab completion |
| D-pad | Arrow keys; scroll earlier output while scrollback is open |
In the symbol grid, use the D-pad to choose a symbol and Insert to type it. Cancel or * closes the grid without typing.
The initial keypad language follows Settings → Input. Terminal uses the same keypad gestures as Notes: hold * for half a second to change language, or hold # to switch between letters and digits. Your language and case are kept when returning from 123. Terminal starts with lowercase letters and omits automatic sentence capitalization because shell commands are case-sensitive.
Holding a D-pad key repeats its arrow action. External keyboards repeat the keys allowed by their layout, using the graphical session’s delay and rate. Opening Options, switching screens or hiding Terminal stops the held repeat; press the key again after returning.
Options
Section titled “Options”Use the soft-key labels to open Options, move with Up and Down, and choose an item with Centre:
- Modifiers selects Ctrl, Alt and Shift for the next phone key or committed letter. Mark the required modifiers and choose Done; Back keeps the previous selection.
- Symbols inserts a literal symbol.
- Special keys opens with Esc selected and sends Esc, Home, End, Delete, PageUp, PageDown or F1–F12 to the running program. Its header shows the armed modifiers. Home here moves within the terminal; it keeps Terminal open.
- Scrollback shows earlier output.
- Font size chooses compact 6 × 12 or larger 8 × 16 pixel cells. Changing the size keeps the shell running and preserves pending input.
- Interrupt Ctrl+C, End input Ctrl+D and Search Ctrl+R send exactly those shortcuts and clear unused one-shot modifiers. A pending letter is sent first with its armed modifiers.
- Help explains the controls on the phone.
- Exit closes the terminal and its shell.
Back from Modifiers, Special keys, Font size or Help returns to Options with the previous item selected. Done, Send or choosing a font completes that action and returns to the terminal. The shared navigation controls describe holding the D-pad and moving through long pages.
A pending letter waits while a menu, another screen or the lock covers the terminal. Returning to it gives the letter a fresh pause before it is sent. Held digit and Clear actions stop, and an open symbol grid closes.
Scrollback and history
Section titled “Scrollback and history”Choose Options → Scrollback to read earlier output. Up and Down move one line; Left and Right move one page. The title changes to Scrollback. The counter on its right, such as ↑37, shows the distance in lines from live output. At ↑0, scrollback is still active and the arrows still move the view. Back or typing returns to live output while the shell is running. After the shell has ended, Back returns to its final output and typing remains disabled.
While reading scrollback, the input-mode indicator is hidden, but your language and letter case are kept. Armed modifiers remain visible. Returning to live output restores the Terminal title and the current input indicator without changing the terminal’s rows or columns.
At the Bash prompt, Up and Down choose earlier commands; Search Ctrl+R searches command history. History is stored with the application’s state. In a RAM boot it disappears when the phone powers off; a supported persistent system root can retain it.
A failed history write leaves command input and the current shell’s in-memory history available. Terminal reports an unsuccessful font save without stopping the shell; the selected font remains active. Follow the storage-error guidance before relying on a saved choice or history file.
Home, lock and close
Section titled “Home, lock and close”The shared application controls apply to Terminal. The red key returns to Home and keeps the shell and its programs running. Open Terminal from Tasks to continue. Locking or turning off the screen also leaves programs running.
Tasks → Close app and Options → Exit terminate the shell and its terminal jobs. Save files before closing. A successful exit from Bash, including Ctrl+D at an empty prompt, closes Terminal. If the shell exits with an error or signal, Terminal keeps its final output and Scrollback available and shows the exit code or signal in the header. Input stops; choose Close when finished reading. An unsuccessful command inside a running Bash session leaves the shell available for the next command. Returning Home alone does not end the shell.
Keyboards
Section titled “Keyboards”External keyboards use the session’s installed layouts and their own Ctrl, Alt and Shift keys. Alt+Shift switches layouts; see keyboard support for your phone. Keyboard Escape and Enter are sent to the running terminal program. F13 and F14 remain ordinary function keys.
Use Shift+PageUp and Shift+PageDown for scrollback. Ctrl+Esc returns to Home while retaining the terminal in Tasks.