Repository navigation
Installation
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 | bashWhat it does:
-
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.
-
Version check. If tron is already installed, it compares the installed version with the new one, then asks before it upgrades, reinstalls or downgrades.
-
Prebuilt: it downloads the archive, verifies its SHA-256 checksum and checks that the binary finds its libraries.
-
Build: it uses the checkout it runs from, or clones the repository. It checks for Rust 1.98 or newer and offers
rustup update stablewhen your Rust is older. On Linux, it checks for the Wayland, xkbcommon and fontconfig development files, a C compiler andtic, and offers to install the missing ones with dnf, apt, pacman or zypper. Then it builds tron. -
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.shLinux
| 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.
| 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.
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)The skyline69/tap tap installs the disk image of the latest release:
brew install --cask skyline69/tap/tronThis 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.appTo 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.
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.appInside 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/trontron-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
troncommand 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 install --user tron-0.1.0-x86_64.flatpak
flatpak run dev.tron.TerminalThe 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.
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.shThe 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.
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 ncursesmacOS needs only the Xcode command line tools.
cargo build --release
./target/release/tronThe desktop entry, icons and AppStream file are in dist/ in the repository.
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.fishUsing tron
Looks
Features
Reference