Skip to content

Environment Variables

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

Environment Variables

Read by tron

Variable Effect
TRON_CONFIG_DIR Configuration directory instead of ~/.config/tron. --config-dir does the same
TRON_ACCESSIBILITY=0 Turns screen reader support (AT-SPI, VoiceOver) off
TRON_STARTUP_ANIMATIONS=0 Turns the startup screen's animations off
TRON_TRACE_LATENCY Logs the time from each key press to the frame that shows it
TRON_SCREENSHOT=path Saves a PNG of the window to path and exits; for bug reports and documentation
TRON_SCREENSHOT_DELAY_MS Waits this long before the screenshot. Default: 1500
RUST_LOG Log level: error, warn (default), info, debug or trace
SHELL Default shell when [shell] program is not set
XDG_CONFIG_HOME, XDG_DATA_HOME, XDG_CACHE_HOME Base directories for configuration, data and the shader cache

Example: take a screenshot of a command's output after three seconds.

TRON_SCREENSHOT=/tmp/tron.png TRON_SCREENSHOT_DELAY_MS=3000 tron -e htop

Example: debug logs.

RUST_LOG=debug tron 2> tron.log

Set by tron for programs

Variable Value
TERM xterm-tron, or [shell] term
COLORTERM truecolor
TERM_PROGRAM tron
TERM_PROGRAM_VERSION tron's version, such as 0.1.0
KITTY_WINDOW_ID 1, so tools that look for kitty use the kitty graphics protocol
LANG A UTF-8 locale, only when LANG, LC_ALL and LC_CTYPE are all unset: the macOS locale with .UTF-8, else en_US.UTF-8, and C.UTF-8 on Linux
PATH ~/.local/share/tron/bin first, for the tron launcher and the ssh and tmux wrappers
TRON_CONFIG_DIR tron's configuration directory

Removed for programs

Variables that would make programs believe they run inside tmux, screen, zellij or another terminal are removed: TMUX, TMUX_PANE, STY, ZELLIJ, KITTY_PID, WEZTERM_PANE, ITERM_SESSION_ID, VTE_VERSION, KONSOLE_VERSION, ALACRITTY_SOCKET, WT_SESSION, WINDOWID and similar.

Files and directories

Path Contents
~/.config/tron/ config.toml, themes/, shaders/
~/.local/share/tron/ Terminfo entry, ssh and tmux wrappers, known ssh hosts, startup screen marker, last update check (update-check)
~/.cache/tron/ Compiled shader pipeline cache

Clone this wiki locally