Desktop: Basic Usage 💻 Desktop

Keyboard-first, multi-window, runs from the shell or the GUI.

Desktop is in active development. Some shortcuts and tray features below are planned but not yet shipped — see tabssh/desktop for current status.

⌨️ Launching Sessions

  • From the GUI: double-click a host in the sidebar.
  • From the shell: tabssh user@host opens a new tab in an existing TabSSH window (or starts one if none is running).
  • From ~/.ssh/config: tabssh prod-web if you have a Host prod-web stanza.
  • From .desktop files / shortcuts: Exec=tabssh %U with a custom tabssh:// URL handler.

🎯 Keyboard Shortcuts

  • Ctrl+T — new tab (Quick Connect dialog)
  • Ctrl+W — close current tab
  • Ctrl+Tab / Ctrl+Shift+Tab — cycle tabs
  • Ctrl+1..9 — jump to tab N
  • Ctrl+K — command palette (fuzzy search across saved hosts, snippets, identities)
  • Ctrl+J — quick switcher (currently-open tabs only)
  • Ctrl+R — history palette (recent connections)
  • Ctrl+N — new window
  • Ctrl+Shift+C / Ctrl+Shift+V — copy / paste
  • Ctrl+Plus / Ctrl+Minus / Ctrl+0 — font zoom
  • Ctrl+Scroll — font zoom by mouse wheel

📌 System Tray (planned, v0.1)

  • Icon in the system tray / menu bar with a list of currently-open sessions.
  • Single-click → focus a tab. Right-click → close, reconnect, open new.
  • Auto-launch on login optional (per-OS: systemd user unit / launchd / Startup folder).
  • Closing the last window minimises to tray rather than killing connections.

🪟 Multi-Window vs Split View

  • Desktop uses real OS windows — Ctrl+N opens a new window with its own tab strip.
  • Tabs can be dragged between windows.
  • The mobile client's split-view-on-one-screen pattern doesn't exist on desktop because the OS already gives you that.

🔁 Differences from mobile

  • No swipe-between-tabs gesture — Ctrl+Tab does the same thing.
  • No on-screen keyboard — your hardware keyboard is enough.
  • No volume keys for font size — Ctrl+Plus / Ctrl+Minus or Ctrl+Scroll.
  • URL detection on long-press becomes Ctrl+Click (configurable).
Back to Documentation Desktop Tabbed Interface →