Skip to content

Desktop App

Shuvo edited this page Jul 18, 2026 · 2 revisions

Termi Desktop App — macOS, Windows & Linux

Termi ships a native desktop app built with Electron, available for macOS, Windows, and Linux in both x64 and arm64 builds. It's a lightweight native shell around your own self-hosted Termi instance, plus a local terminal that isn't available in the browser version.

⬇️ Download the latest release

Why use the desktop app instead of the browser?

  • Local terminal access — open a shell on the machine you're actually sitting at, not just remote servers
  • Remembers window size and position between launches
  • Native right-click context menu and keyboard shortcuts for managing shell tabs (new/close/cycle shells, quick-open)
  • Feels like a first-class app: no browser chrome, dock/taskbar integration, auto-updates on Windows and Linux

Installation

macOS

Download Termi-<version>-arm64.dmg for Apple Silicon or Termi-<version>.dmg for Intel Macs.

The macOS build is ad-hoc signed but not notarized (there is no paid Apple Developer ID behind this open-source project), so Gatekeeper will show a warning on first launch:

"Apple could not verify 'Termi.app' is free of malware…"

This is expected for an open-source, unsigned build. To open it anyway:

Option A — Right-click to open

  1. Drag Termi.app into /Applications
  2. Right-click (or Control-click) the app → Open
  3. Click Open in the dialog — macOS remembers this choice afterward

Option B — Remove the quarantine flag

xattr -dr com.apple.quarantine /Applications/Termi.app

Note: macOS builds do not currently self-update (unsigned apps can't). The app will notify you and link back to this page when a new version is available.

Windows

Download Termi-Setup-<version>.exe and run it. Windows SmartScreen may warn that the publisher is unknown — click More info → Run anyway. Windows builds self-update automatically.

Linux

Download the .AppImage for your architecture (x64 or arm64). No installation required:

chmod +x Termi-<version>.AppImage
./Termi-<version>.AppImage

Linux builds self-update automatically.

Connecting to your instance

On first launch, the desktop app asks for the URL of your self-hosted Termi instance (see Getting Started if you haven't deployed one yet). It then behaves exactly like the web app, with the added local-terminal and native-shell features above.

Keyboard shortcuts

Shortcut Action
Cmd/Ctrl + 1–4 Switch between Servers / Groups / Sessions / Local Terminal
Cmd/Ctrl + T New shell tab
Cmd/Ctrl + Shift + W Close shell tab
Cmd/Ctrl + Shift + ] / [ Next / previous shell tab
Cmd/Ctrl + K Quick-open a server
Cmd/Ctrl + , Settings

Related pages: Getting Started · Features · Troubleshooting · FAQ

Clone this wiki locally