Troupe Docs
Getting started

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 troupe

If 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 | bash

The 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:

  1. It finds the latest release and the disk image for your Mac (Apple silicon or Intel).
  2. It asks Install Troupe <version> (...) to /Applications? [y/N]. Type y and press Enter.
  3. It downloads the disk image and checks it against the release checksums. If the check fails, it installs nothing.
  4. 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

  1. Open the latest release.
  2. Download the .dmg for your Mac. The file ending in _aarch64.dmg is for Apple silicon. The file ending in _x64.dmg is for Intel.
  3. Open the .dmg and drag Troupe into Applications.
  4. 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

  1. Open the latest release.
  2. Download the file ending in _x64-setup.exe or the file ending in _x64_en-US.msi. Both install the same app. Builds are for 64-bit x86 Windows.
  3. 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 | bash

The 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/troupe command, which starts the AppImage. On Wayland, this command also loads your system's libwayland-client library 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, set TROUPE_WAYLAND_CLIENT_LIB (or the older TERMUL_WAYLAND_CLIENT_LIB) to its path.
  • It adds a Troupe entry to your application menu.
  • It keeps the termul-manager and termul-manager.AppImage names from older installs as links to Troupe, so old shell aliases and launchers still work.
  • It warns you if ~/.local/bin is not on your PATH. Add that folder to your PATH to start Troupe from a shell with troupe.

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 .deb package (Troupe_<version>_amd64.deb) for Debian, Ubuntu, and similar systems.
  • An .rpm package (Troupe-<version>-1.x86_64.rpm) for Fedora and similar systems.
  • The .AppImage file (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.deb

Arch Linux (AUR)

Troupe is in the AUR as troupe. Install it with your AUR helper. For example:

yay -S troupe

The 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.

Next step

Create your first project.

On this page