Repository navigation
Environment Variables
Ö. Efe D. edited this page Sep 16, 2026
·
2 revisions
| 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 htopExample: debug logs.
RUST_LOG=debug tron 2> tron.log| 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 |
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.
| 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 |
Using tron
Looks
Features
Reference