Skip to content

Terminal Requirements

Retro-Jack edited this page Mar 29, 2026 · 1 revision

Terminal Requirements

UnixTree uses its own terminal abstraction layer rather than system terminfo/termcap. It ships a set of .trm definition files and requires a compatible terminal environment to start.


Supported Terminal Types

The following $TERM values have a matching .trm file:

TERM value Notes
xterm Standard xterm
xterm-256color Modern xterm / most terminal emulators
linux Linux virtual console
vt100 DEC VT100
vt220 DEC VT220
ansi Generic ANSI

If your terminal reports a different $TERM value (e.g. alacritty, kitty, tmux-256color), set it to one of the above before launching:

TERM=xterm-256color xt

Minimum Terminal Size

UnixTree requires at least 80 columns × 24 rows. It will refuse to start if the terminal is smaller. Resize your terminal window and try again.


How Terminal Detection Works

At startup, xt looks up $XTPATH/trm/$TERM.trm. The XTPATH environment variable is set by the wrapper scripts installed to /usr/bin/xt and /usr/bin/xtx:

export XTPATH=/usr/share/unixtree

If you run the raw binary at /usr/lib/unixtree/xt directly, you must set XTPATH yourself.


Window Resizing

UnixTree handles SIGWINCH (terminal resize signal) and redraws the interface correctly when you resize the terminal window during a session.


Running from a Desktop Menu Entry

The .desktop menu entry uses /usr/bin/xt-run, which opens a new xfce4-terminal window and launches xt inside it. This ensures the terminal environment is always compatible.

Clone this wiki locally