Install Troupe
Install the Troupe desktop app on macOS, Windows, or Linux.
The desktop app is called Troupe. Every release has builds for macOS, Windows, and Linux on the GitHub releases page.
If you want to run Troupe on a server and open it in a browser or on your phone, install troupe-server instead. See Browser and phone.
macOS
You can install Troupe with Homebrew, with the install script, or from a disk image. All three give you the same app.
Homebrew
brew tap gnoviawan/termul
brew install --cask troupeIf you installed the termul cask before, brew update moves it to troupe for you. brew install --cask termul also still installs Troupe.
Install script
curl -fsSL https://raw.githubusercontent.com/gnoviawan/troupe/v0.4.60/scripts/install.sh | bashThe link points to the script from a fixed release, so it can't change under you. The script still installs the newest Troupe release.
The script does these things:
- It finds the latest release and the disk image for your Mac (Apple silicon or Intel).
- It asks
Install Troupe <version> (...) to /Applications? [y/N]. Typeyand press Enter. - It downloads the disk image and checks it against the release checksums. If the check fails, it installs nothing.
- It copies Troupe.app to
/Applications. If Termul Manager.app from an older release is there, the script removes it. Your settings, projects, and logins stay.
To skip the question, run the script with TROUPE_INSTALL_YES=1. To install somewhere other than /Applications, set TROUPE_INSTALL_APPLICATIONS_DIR. The older TERMUL_INSTALL_* names still work.
Disk image
- Open the latest release.
- Download the
.dmgfor your Mac. The file ending in_aarch64.dmgis for Apple silicon. The file ending in_x64.dmgis for Intel. - Open the
.dmgand drag Troupe into Applications. - If Termul Manager.app from a release before 0.5.0 is still in Applications, move it to the Trash. Your settings, projects, and logins stay.
Windows
- Open the latest release.
- Download the file ending in
_x64-setup.exeor the file ending in_x64_en-US.msi. Both install the same app. Builds are for 64-bit x86 Windows. - Run the installer.
The install script does not work on Windows.
Linux
Linux builds are for 64-bit x86 (x86_64) only. They need WebKitGTK 2.40 or later. Debian 12, Ubuntu 24.04, and an updated Ubuntu 22.04 have it.
Install script (AppImage)
curl -fsSL https://raw.githubusercontent.com/gnoviawan/troupe/v0.4.60/scripts/install.sh | bashThe script downloads the latest AppImage and checks it against the release checksums. Then it does these things:
- It saves the AppImage as
~/.local/bin/troupe.AppImage. - It adds the
~/.local/bin/troupecommand, which starts the AppImage. On Wayland, this command also loads your system'slibwayland-clientlibrary so that the window is not blank with Mesa 25 or later. Terminals in Troupe do not get that setting. If the library is in another folder, setTROUPE_WAYLAND_CLIENT_LIB(or the olderTERMUL_WAYLAND_CLIENT_LIB) to its path. - It adds a Troupe entry to your application menu.
- It keeps the
termul-managerandtermul-manager.AppImagenames from older installs as links to Troupe, so old shell aliases and launchers still work. - It warns you if
~/.local/binis not on yourPATH. Add that folder to yourPATHto start Troupe from a shell withtroupe.
Before it installs, the script asks you to confirm. To skip the question, run it with TROUPE_INSTALL_YES=1. To use a different folder, set TROUPE_INSTALL_BIN_DIR. The older TERMUL_INSTALL_* names still work.
Debian, Ubuntu, Fedora, and other packages
The latest release also has these files:
- A
.debpackage (Troupe_<version>_amd64.deb) for Debian, Ubuntu, and similar systems. - An
.rpmpackage (Troupe-<version>-1.x86_64.rpm) for Fedora and similar systems. - The
.AppImagefile (Troupe_<version>_amd64.AppImage), if you want to manage it yourself.
Releases up to 0.4.60 use the old name in their files, for example Termul.Manager_<version>_amd64.deb.
Install the package with your system's package manager. For example, on Ubuntu:
sudo apt install ./Troupe_<version>_amd64.debArch Linux (AUR)
Troupe is in the AUR as troupe. Install it with your AUR helper. For example:
yay -S troupeThe package was called termul-manager before 0.5.0. The troupe package replaces it.
Updates
The desktop app checks for new versions and can install them for you. You can pick the Stable, Insider, or Nightly channel. See Settings for details.