Install

The fastest path is the Termy download page. It detects your platform and links to the current GitHub release.

macOS

1. On the download page, choose Apple silicon for M-series Macs or Intel for older Macs.
2. Open the .dmg and drag Termy to /Applications.
3. Open Termy from Applications.

macOS DMGs from v0.2.75 onward are signed and notarized. If Termy does not open, see the troubleshooting guide.

Linux

Download the AppImage or .tar.gz from GitHub Releases.

• AppImage: mark it executable, then run it.
• Archive: unpack it and run the included Termy binary.

Linux release launchers prefer X11/XWayland when it is available so the desktop window manager can provide the native title bar and window controls. To run the Wayland backend instead, launch Termy with TERMY_LINUX_BACKEND=wayland. Both terminal and Settings windows request system-managed decorations, including KDE's title bar, window controls, and resize borders. The window manager controls the titlebar theme independently of Termy's terminal color theme.

Windows

1. From GitHub Releases, download the installer for your PC:
   • Termy-<version>-windows-x64-Setup.exe for Intel and AMD PCs.
   • Termy-<version>-windows-arm64-Setup.exe for ARM64 PCs such as Snapdragon laptops.
2. Run the installer. By default it installs Termy for your account only, in %LOCALAPPDATA%\Programs\Termy, without an administrator prompt. To install for every user under Program Files, choose Install for all users when Setup asks, or run it with /ALLUSERS.
3. Open Termy from the Start menu. A desktop shortcut is optional; tick it on the Additional tasks page.

Termy checks for updates itself and installs them in the same place, for the same users, as the existing install.

The Windows installer is not code-signed, so Windows SmartScreen may show Windows protected your PC with an unknown publisher. Choose More info, check that the file name is the one you downloaded from the Termy release, then choose Run anyway. To confirm the download, compare its SHA-256 hash (Get-FileHash .\Termy-<version>-windows-x64-Setup.exe in PowerShell) with checksums.txt on the same release.

Termy will also be available through winget as lassejlv.Termy once the package is accepted into the winget repository:

winget install lassejlv.Termy

From source

git clone https://github.com/lassejlv/termy
cd termy
cargo run --release -p termy

This route requires Rust and the platform dependencies used by the desktop app. Prefer a release binary unless you are developing Termy itself.

First launch