Installation Guide
Install the kftray desktop app or the kftui terminal interface on macOS, Linux or Windows.
Pick the install method that matches your platform, then continue with the Quick Start.
Desktop Interface (kftray)
Install with Homebrew (recommended):
brew tap hcavarsan/kftray
brew install --cask kftrayOr download the versioned .dmg from the downloads page. The universal binary runs on Intel and Apple Silicon.
Terminal Interface (kftui)
brew tap hcavarsan/kftray
brew install kftuiManual Binary Downloads
Use the downloads page to select an app, operating system and CPU architecture. The release page also lists the downloadable files.
Desktop filenames include the release version. Terminal binaries use these names:
| Platform | Terminal binary |
|---|---|
| macOS (Universal) | kftui_macos_universal |
| Linux x86_64 | kftui_linux_amd64 |
| Linux ARM64 | kftui_linux_arm64 |
| Windows x64 | kftui_windows_x86_64.exe |
| Windows x86 | kftui_windows_x86.exe |
| Windows ARM64 | kftui_windows_arm64.exe |
Linux Packages
Each release publishes kftray and kftui packages for Debian, Ubuntu, Fedora, openSUSE and Arch Linux through the openSUSE Build Service. Add the repository once and install either package with your package manager. Updates arrive with regular system upgrades.
The commands below install kftui. Replace it with kftray for the desktop app.
Replace Debian_12 with Debian_13, Ubuntu_22.04, Ubuntu_24.04 or Ubuntu_26.04 as needed:
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.opensuse.org/repositories/home:/hencavarsan:/kftray/Debian_12/Release.key | sudo gpg --dearmor -o /etc/apt/keyrings/kftray.gpg
echo "deb [signed-by=/etc/apt/keyrings/kftray.gpg] https://download.opensuse.org/repositories/home:/hencavarsan:/kftray/Debian_12/ /" | sudo tee /etc/apt/sources.list.d/kftray.list
sudo apt update
sudo apt install kftuiThe packages use the signing key for home:hencavarsan:kftray. The .repo files reference it, apt pins it with signed-by and pacman trusts it after pacman-key --lsign-key.
The kftray package ships the AppImage and depends on fuse3. The kftui package depends on libdbus-1.
Verifying the Installation
Launch kftray from your applications menu or open the AppImage. Check app mode if the tray icon is unavailable or you prefer a regular window.
Configuration Storage
Both apps use the same SQLite configuration database. See configuration storage for database and log paths, including KFTRAY_CONFIG and XDG_CONFIG_HOME overrides.
Building from source
See building from source for desktop and terminal build commands. To verify downloaded artifacts, follow the security guide.