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@hostopens a new tab in an existing TabSSH window (or starts one if none is running). - From
~/.ssh/config:tabssh prod-webif you have aHost prod-webstanza. - From
.desktopfiles / shortcuts:Exec=tabssh %Uwith a customtabssh://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).