Linux

Packages are published for amd64 and arm64 from a GPG-signed repository at https://packages.teamhud.app. Linux has no built-in self-updater: the package manager is the update path. See Updates.

Install

sudo curl -fsSL https://packages.teamhud.app/teamhud.gpg -o /usr/share/keyrings/teamhud.gpg
sudo curl -fsSL https://packages.teamhud.app/teamhud.list -o /etc/apt/sources.list.d/teamhud.list
sudo apt update && sudo apt install teamhud

Updates arrive with sudo apt update && sudo apt upgrade.

sudo curl -fsSL https://packages.teamhud.app/teamhud.repo -o /etc/yum.repos.d/teamhud.repo
sudo dnf install teamhud

Updates arrive with sudo dnf upgrade.

curl -fLO "https://packages.teamhud.app/appimage/stable/TeamHUD-$(uname -m).AppImage"
chmod +x "TeamHUD-$(uname -m).AppImage"
./"TeamHUD-$(uname -m).AppImage"

uname -m picks the file for your architecture. A detached .asc signature and a SHA256SUMS file sit beside it. If it fails with libfuse.so.2, install libfuse2 (libfuse2t64 on Ubuntu 24.04 and newer) or run it with --appimage-extract-and-run.

What the desktop needs

TeamHUD uses things Wayland does not give applications by default.

System tray (GNOME). GNOME has no tray of its own. Without an AppIndicator extension the tray icon never appears. On Ubuntu, gnome-extensions enable ubuntu-appindicators@ubuntu.com, then restart TeamHUD. The overlay is the main interface; the tray only adds quit and preferences.
/dev/input read access for the overlay cursor and push-to-talk fallback. Run sh scripts/linux/linux-setup.sh --dry-run to see what a machine needs, without changing anything.
GNOME Shell helper extensions. The app installs them; they load at the next login, so expect a “log out and back in” notice on first run. With an AppImage they are installed through the in-app grant flow.

Uninstall

sudo apt remove teamhud (add --purge to drop config), sudo dnf remove teamhud, or delete the AppImage. The repository file and key stay behind; delete them to stop receiving updates.