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 bare www..
  • 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.
Back to Documentation Tabbed Interface →