Basic Usage 📱 Mobile
Day-to-day TabSSH: typing, copying, font size, URLs, the on-screen keyboard, and what the gestures do.
This guide describes the mobile (Android) client. The desktop equivalent is in development — see Desktop Basic Usage.
⌨️ Terminal Input
TabSSH renders a full VT100 / xterm-256color terminal via the Termux emulator. Typing works the way you'd expect — vim, nano, htop, tmux all work.
- Hardware keyboard: standard layout. Modifiers (Ctrl, Alt, Shift) pass through.
- On-screen keyboard: a SSH-optimised soft keyboard with 1–5 customisable rows. Tap the keyboard icon in the toolbar to toggle.
- Special keys: Tab, Esc, Ctrl, Alt, arrow keys, F1–F12, Page Up/Down — all available in the soft keyboard.
- Customisable layout: rebind which keys are on which row in Settings → Keyboard.
- 2FA prompts arrive as keyboard-interactive challenges; just type the code.
🔍 Font Size, Zoom, and Themes
- Volume keys — Volume Up enlarges, Volume Down shrinks. Range 8–32sp. Toggleable in Settings → Terminal → Volume keys control font.
- Pinch-zoom — same effect as volume keys.
- Per-host theme override — pick a different theme on a per-connection basis from the connection edit screen.
- App theme — Light, Dark, or follow system. Set in Settings → General → App theme. Switches live, no restart.
- Cursor style — Block, Underline, or Vertical Bar. Settings → Terminal → Cursor.
- Bell — silent / visual / audio. Settings → Terminal → Bell.
📋 Copy & Paste, URL Detection
- Long-press on terminal text to select and copy.
- Paste — toolbar paste button or Ctrl+Shift+V on hardware keyboards.
- Long-press a URL in the output: a dialog offers Open (in your browser) / Copy / Cancel. Detects
http://,https://, and barewww.. - URL detection is toggleable in Settings → Terminal → Detect URLs.
🗂️ Tab Management
- Tap a tab in the strip to switch.
- Swipe left/right on the terminal to move between tabs (ViewPager2). Toggleable in Settings → General → Swipe between tabs.
- Ctrl+Tab on a hardware keyboard cycles tabs.
- Long-press a tab for context options (close, reconnect, …).
- Disconnected tabs show a Reconnect button instead of auto-closing.
- Tab strip is mobile-first — short labels, scrollable horizontally, color tags surface so you can spot prod vs lab at a glance.
For palette / quick switcher / split view / workspaces, see Tabbed Interface.
🔄 Session Persistence
- The connection runs in a foreground service so Android doesn't kill it when you switch apps.
- A persistent notification stays visible while you have any connected tab — tap to disconnect from the notification.
- Tabs and scrollback survive an app restart in most cases — you'll be reconnected (auth permitting) on the next launch.
- Auto-reconnect can be enabled per-connection (Settings → Connection defaults → Auto-reconnect, or per-host in the edit screen).
📝 Snippets & History
- Snippets — paste preset commands with a tap. Categories, tags, and prompt-style variables (
{?password}etc.). Open via the menu while connected. - Session transcripts — auto-record sessions to file if enabled (Settings → General → Auto-record sessions). Replay with the Transcript Viewer.
- Find / search in scrollback — Ctrl+F (or via the menu).
- History palette — Ctrl+R or via the menu — searches recent connections.