Skip to content

Installation

Ö. Efe D. edited this page Sep 16, 2026 · 5 revisions

Installation

With the install script

The install script works on Linux and macOS. It installs tron for the current user:

curl -fsSL https://raw.githubusercontent.com/skyline69/tron-terminal/main/install.sh | bash

What it does:

  1. Prebuilt or build. When the latest release has an archive for your system, the script asks:

    ==> tron 0.1.0 is available prebuilt for x86_64-linux.
    Install the prebuilt tron 0.1.0 (p), or build 0.1.0 from source (b)? [P/b]
    

    The prebuilt tron installs in seconds and needs no Rust. The default is the prebuilt release, unless the sources to build are newer than it, as in a checkout with unreleased changes. Without a release for your system, the script builds from source and says why: no release yet, an unsupported CPU, or a Linux with glibc older than 2.39.

  2. Version check. If tron is already installed, it compares the installed version with the new one, then asks before it upgrades, reinstalls or downgrades.

  3. Prebuilt: it downloads the archive, verifies its SHA-256 checksum and checks that the binary finds its libraries.

  4. Build: it uses the checkout it runs from, or clones the repository. It checks for Rust 1.98 or newer and offers rustup update stable when your Rust is older. On Linux, it checks for the Wayland, xkbcommon and fontconfig development files, a C compiler and tic, and offers to install the missing ones with dnf, apt, pacman or zypper. Then it builds tron.

  5. It installs tron.

Run from an unpacked release archive, the script installs the binary in that archive without asking.

To run it from a checkout:

git clone https://github.com/skyline69/tron-terminal.git
cd tron-terminal
./install.sh

What gets installed

Linux

File Location
Binary ~/.local/bin/tron
Desktop entry ~/.local/share/applications/dev.tron.Terminal.desktop
Icons ~/.local/share/icons/hicolor/*/apps/dev.tron.Terminal.*
AppStream metadata ~/.local/share/metainfo/dev.tron.Terminal.metainfo.xml
Completions bash, zsh and fish, when those shells are installed

After installing, the script refreshes the desktop database, the icon cache and the KDE service cache. Application launchers, KRunner and GNOME search find tron right away.

macOS

The script builds tron.app with an icon and installs it to /Applications, or to ~/Applications when /Applications is not writable. Spotlight and Launchpad find it there. ~/.local/bin/tron links to the binary inside the app.

Options

Option Effect
-y, --yes Answer yes to every question, for scripts and CI. Picks the prebuilt release unless the sources are newer
--prebuilt Install the prebuilt release without asking; fail when there is none
--build Build from source without asking
--system Install for all users under /usr/local, with sudo
--prefix DIR Install under DIR
--source DIR Build the checkout in DIR
--ref REF A release tag such as v0.1.0 installs that release; a branch name clones and builds that branch
--uninstall Remove what the script installed

--uninstall reads the list of installed files from ~/.local/share/tron/install-manifest, or PREFIX/share/tron/install-manifest for other prefixes. Your configuration in ~/.config/tron stays.

zsh completions

With a user install, zsh completions go to ~/.local/share/zsh/site-functions. That directory is not on zsh's fpath by default, so add it in ~/.zshrc before compinit:

fpath=(~/.local/share/zsh/site-functions $fpath)

Homebrew (macOS)

The skyline69/tap tap installs the disk image of the latest release:

brew install --cask skyline69/tap/tron

This puts tron.app in /Applications and links the tron command into Homebrew's bin, so it works in every terminal. The cask is updated with each release; brew upgrade --cask tron installs the new version.

tron is not notarized by Apple, so macOS blocks the first launch. Right click tron in Applications and choose Open, or clear the quarantine flag:

xattr -dr com.apple.quarantine /Applications/tron.app

To remove tron, run brew uninstall --cask tron. brew uninstall --zap --cask tron also deletes the configuration in ~/.config/tron, the data in ~/.local/share/tron and the cache in ~/.cache/tron.

macOS disk image

Download tron-VERSION-macos.dmg from the releases page, open it and drag tron to Applications. The app is universal: it runs natively on Apple Silicon and Intel Macs, on macOS 11 or newer.

tron is not notarized by Apple. The first time you open it, macOS refuses. Then either right click tron in Applications and choose Open, or allow it under System Settings > Privacy & Security > Open Anyway. From a terminal, this does the same:

xattr -dr com.apple.quarantine /Applications/tron.app

Inside tron windows, the tron command is always available. To use it in other terminals as well, link it onto your PATH:

sudo ln -sf /Applications/tron.app/Contents/MacOS/tron /usr/local/bin/tron

AppImage

tron-VERSION-x86_64.AppImage and tron-VERSION-aarch64.AppImage run on any Linux distribution with glibc 2.34 or newer:

chmod +x tron-0.1.0-x86_64.AppImage
./tron-0.1.0-x86_64.AppImage
  • AppImages need FUSE 2 or 3 to mount themselves. Without it, run ./tron-0.1.0-x86_64.AppImage --appimage-extract-and-run.
  • Inside tron windows, the tron command runs the AppImage. For other terminals, link it: ln -sf ~/Applications/tron-0.1.0-x86_64.AppImage ~/.local/bin/tron.
  • For a menu entry and updates, use Gear Lever or AppImageLauncher. The AppImage carries update information, so they can update it from new releases.

Flatpak

flatpak install --user tron-0.1.0-x86_64.flatpak
flatpak run dev.tron.Terminal

The bundle fetches the freedesktop runtime from Flathub the first time.

Inside tron windows, the tron command runs the Flatpak. For other terminals, add an alias such as alias tron='flatpak run dev.tron.Terminal'.

A terminal needs your real shell and tools, so the Flatpak runs shells and tron -e commands on the host through flatpak-spawn --host, with job control and resizing working as usual. It reads the same ~/.config/tron as other installations. Because of this, the Flatpak is not sandboxed in any meaningful way: it has access to the host, like any terminal.

From a release archive

Each release has archives with a prebuilt binary for x86_64-linux, aarch64-linux, x86_64-macos and aarch64-macos. Unpack one and run its install script. It needs no Rust:

tar xzf tron-0.1.0-x86_64-linux.tar.gz
cd tron-0.1.0-x86_64-linux
./install.sh

The Linux archives are built on AlmaLinux 9 and need glibc 2.34 or newer. On older distributions, use the install script to build from source instead.

Building by hand

tron needs Rust 1.98 or newer. At runtime it uses tic from ncurses to install its terminfo entry.

On Linux, install the development files first:

# Fedora
sudo dnf install wayland-devel libxkbcommon-devel fontconfig-devel ncurses
# Debian / Ubuntu
sudo apt install libwayland-dev libxkbcommon-dev libfontconfig-dev ncurses-bin
# Arch
sudo pacman -S wayland libxkbcommon fontconfig ncurses

macOS needs only the Xcode command line tools.

cargo build --release
./target/release/tron

The desktop entry, icons and AppStream file are in dist/ in the repository.

Shell completions by hand

tron completions bash > ~/.local/share/bash-completion/completions/tron
tron completions zsh  > ~/.local/share/zsh/site-functions/_tron
tron completions fish > ~/.config/fish/completions/tron.fish

Clone this wiki locally