Download and install¶
Termalith is free. Every version is on the Releases page (the link always opens the newest one). Scroll to Assets and pick the file for your system from the table below.
Which file do I need?¶
| Your computer | Download | How to check |
|---|---|---|
| Mac with Apple Silicon (M1, M2, M3, M4…) | Termalith_<version>_aarch64.dmg |
Apple menu → About This Mac shows Chip: Apple M… |
| Mac with Intel | Termalith_<version>_x64.dmg |
About This Mac shows Processor: Intel… |
| Windows 10 or 11 (most PCs) | Termalith_<version>_x64-setup.exe |
Settings → System → About: x64-based processor |
| Windows on ARM (Surface Pro X, Snapdragon laptops) | Termalith_<version>_arm64-setup.exe |
ARM-based processor |
| Linux x64, Ubuntu / Debian / Mint | Termalith_<version>_amd64.deb |
uname -m prints x86_64 |
| Linux x64, any other distribution | Termalith_<version>_amd64.AppImage |
as above |
| Linux ARM64 (Raspberry Pi 5, ARM servers with a desktop) | Termalith_<version>_arm64.deb or …_aarch64.AppImage |
uname -m prints aarch64 |
Windows also has .msi files (…_x64_en-US.msi, …_arm64_en-US.msi) for
administrators who deploy software with Group Policy or Intune; the
-setup.exe is the simpler choice for everyone else.
Requirements: macOS 11 (Big Sur) or newer; Windows 10 version 1809 or newer (the WebView2 runtime is included in Windows 11 and installed by the setup if missing); Linux with glibc 2.35 or newer and WebKitGTK 4.1 (Ubuntu 22.04, Debian 12, Fedora 36 or newer). For saved passwords on Linux you need a Secret Service such as GNOME Keyring or KWallet (most desktops have one).
Install¶
- Open the downloaded
.dmgand drag Termalith onto Applications. - Open Termalith from Applications. macOS says it cannot verify the developer, because the app is not signed with a paid Apple certificate yet. Click Done (or Cancel).
- Open System Settings → Privacy & Security, scroll down and click Open Anyway next to the message about Termalith, then confirm. (macOS 14 and older: right-click the app in Applications and choose Open.)
- The first time Termalith connects to a machine on your own network, macOS asks whether it may find devices on your local network: click Allow. If you missed it, see Troubleshooting.
- Run
Termalith_<version>_x64-setup.exe(or the ARM64 one). - If SmartScreen shows Windows protected your PC, click More info → Run anyway. This appears because the installer is not signed with a paid certificate yet.
- Follow the setup. Termalith appears in the Start menu.
sudo apt install ./Termalith_<version>_amd64.deb
Termalith appears in your applications menu. Remove it with
sudo apt remove termalith.
chmod +x Termalith_<version>_amd64.AppImage
./Termalith_<version>_amd64.AppImage
Nothing is installed; keep the file wherever you like. To carry it on a USB stick with all your data, see Portable copy.
Verify the download (optional)¶
Each release has a SHA256SUMS.txt. Compare it with the checksum of your
file; they must be identical:
shasum -a 256 Termalith_<version>_aarch64.dmg # macOS
sha256sum Termalith_<version>_amd64.AppImage # Linux
Get-FileHash .\Termalith_<version>_x64-setup.exe # Windows (PowerShell)
Every installer is installed and started on its own system in an automated test before a release is published.
Updates¶
Termalith never updates itself or downloads anything on its own. Use About (ⓘ in the sidebar footer) → Check for updates, or turn on Check GitHub for a newer version at startup in Settings. Install a newer version over the old one; your sessions and settings are kept.
Uninstall¶
- macOS: drag Termalith from Applications to the Trash.
- Windows: Settings → Apps → Installed apps → Termalith → Uninstall.
- Linux:
sudo apt remove termalith, or delete the AppImage.
Your sessions and settings stay on the computer until you delete the data folder listed in Where your data is; saved passwords stay in the system keychain under entries named Termalith.
Build from source¶
You need Git, Rust (the version in rust-toolchain.toml is installed
automatically through rustup), Node.js 24 with Corepack, and the
Tauri prerequisites for your
system.
git clone https://github.com/mehaskari/Termalith.git && cd Termalith
corepack pnpm install --frozen-lockfile
corepack pnpm dev # run it
corepack pnpm --filter @termalith/desktop tauri build # build installers for this system
More detail: Building and releasing.