Repository navigation
Configuration
tron reads ~/.config/tron/config.toml. On macOS it uses the same path,
not ~/Library. The first launch writes a fully commented example there, and
every key is optional: remove a key to get its default.
~/.config/tron/
config.toml configuration
themes/<name>.toml color themes (see [[Themes]])
shaders/<name>.wgsl post-processing shaders (see [[Shaders]])
-
Hot reload. tron watches this directory and applies changes to open windows as you save.
Ctrl+Shift+,(Cmd+,on macOS) reloads by hand. - Errors. A mistake, such as an unknown key or a wrong value, is shown in the window for 15 seconds and logged. tron then runs with the valid parts.
-
Other directories.
tron --config-dir DIRor the environment variableTRON_CONFIG_DIRpoint tron at another configuration directory. -
Startup screen. The Settings, Themes and Shaders tabs of
tron --startupedit this file for you, with a live preview.
# Startup screen before the shell. Unset: only on the first launch.
startup = true
# Animate the startup screen. false for reduced motion.
startup_animations = true
# A built-in theme or themes/<name>.toml.
theme = "tron"[font]
family = "monospace"
size = 12.0
fallback = ["Symbols Nerd Font Mono", "Noto Color Emoji"]
features = ["ss01", "zero"]
ligatures = true
bold_family = "Iosevka Heavy"
italic_family = "Victor Mono"
bold_italic_family = "Victor Mono"
variations = { wght = 450, wdth = 90 }
hinting = "auto"
bidi = true| Key | Default | Meaning |
|---|---|---|
family |
"monospace" |
Font family, found through fontconfig on Linux and Core Text on macOS |
size |
12.0 |
Size in points |
fallback |
[] |
Families tried in order before the system fallback |
features |
[] |
OpenType features, for example "ss01" or "zero"
|
ligatures |
true |
Programming ligatures. false disables calt, liga and dlig
|
bold_family, italic_family, bold_italic_family
|
family |
Separate families for styled text |
variations |
none | Variable font axes, such as wght and wdth
|
hinting |
"auto" |
Outline hinting: auto (on below 1.5x display scale), on or off
|
bidi |
true |
Reorder rows with right-to-left text (Arabic, Hebrew) for display |
Box drawing, block elements, Braille patterns and Powerline glyphs are drawn by tron to fit every cell exactly, whatever the font.
| Key | Default | Meaning |
|---|---|---|
title |
"tron" |
Window title, until a program sets one |
padding_x, padding_y
|
10, 8
|
Space around the text, in logical pixels |
opacity |
1.0 |
Background opacity from 0.0 to 1.0
|
blur |
false |
Blur what is behind a translucent window, where the compositor supports it (KDE Plasma) |
decorations |
true |
Window title bar and borders |
columns, rows
|
100, 30
|
Initial window size in cells |
close_on_exit |
true |
Close the window when the shell exits. false keeps it open until a key press |
option_as_alt |
"none" |
macOS: Option keys that act as Alt: none, left, right or both
|
| Key | Default | Meaning |
|---|---|---|
shape |
"block" |
block, beam or underline
|
blinking |
"app" |
app blinks when the application asks for it; always or never override that |
blink_interval_ms |
530 |
Blink interval |
Overrides single colors of the selected theme. The keys are the same as in a theme file; see Themes.
[colors]
foreground = "#c7d5e0"
background = "#0a0e14"
cursor = "#4fd6ff"
cursor_text = "#0a0e14"
selection_background = "#1f4a6b"
selection_foreground = "#ffffff"
normal = ["#1b2230", "#ff5c75", "#5ce6a6", "#ffc86b", "#4f9dff", "#c38bff", "#4fd6ff", "#c7d5e0"]
bright = ["#4a5568", "#ff8095", "#86f0bf", "#ffd99a", "#7fb8ff", "#d6adff", "#8ae6ff", "#eef4f8"]
# Draw bold text in ANSI colors 0-7 with the bright variant.
bold_is_bright = false| Key | Default | Meaning |
|---|---|---|
lines |
10000 |
Lines kept in history |
multiplier |
3.0 |
Lines per mouse wheel step |
| Key | Default | Meaning |
|---|---|---|
program |
$SHELL, then /bin/sh
|
Program to run |
args |
[] |
Its arguments, for example ["--login"]
|
term |
"xterm-tron" |
Value of TERM. "xterm-256color" suits systems without the tron terminfo entry; see Remote Hosts
|
env |
{} |
Extra environment variables, for example { EDITOR = "nvim" }
|
On macOS, the default shell starts as a login shell, like in Terminal.app.
| Key | Default | Meaning |
|---|---|---|
word_separators |
",│`|:\"'()[]{}<>" |
Characters that end a word for double click |
copy_on_select |
true |
Copy selections to the primary selection, for middle click paste |
| Key | Default | Meaning |
|---|---|---|
osc52 |
"copy" |
Clipboard access for applications through OSC 52: disabled, copy or copy-paste
|
copy lets programs, such as vim or tmux over ssh, set the clipboard.
copy-paste also lets them read it; allow that only for programs you trust.
| Key | Default | Meaning |
|---|---|---|
files |
[] |
WGSL shaders applied in order; built-in names or files in shaders/
|
animation |
"auto" |
auto, always or never; see Shaders
|
fps |
0 |
Frame rate cap of continuous shader animations, such as 30 to save power; 0 follows the display |
| Key | Default | Meaning |
|---|---|---|
memory_limit |
320 |
Memory for decoded kitty graphics protocol images, in MiB |
file_transfer |
true |
Let applications send images as file paths |
| Key | Default | Meaning |
|---|---|---|
mode |
"attention" |
none, visual (flash), attention (urgency hint while unfocused) or both
|
| Key | Default | Meaning |
|---|---|---|
open_command |
xdg-open, open on macOS |
Program that opens links clicked with Ctrl (Cmd on macOS) |
| Key | Default | Meaning |
|---|---|---|
mode |
"unfocused" |
Desktop notifications from applications: never, unfocused or always
|
command |
notify-send, osascript on macOS |
Command run as command --app-name tron -- title body
|
See Notifications.
| Key | Default | Meaning |
|---|---|---|
check |
true |
Look on GitHub for a newer tron at most once a day and show a notice in the window when one is out |
| Key | Default | Meaning |
|---|---|---|
line |
true |
Sweep a glowing line across the top edge when a coding agent harness starts |
colors |
{} |
Line colors by command name, such as claude = "#d97757". Overrides the brand colors and adds other harnesses |
See Getting Started#coding-agents.
See Key Bindings.
theme = "catppuccin-mocha"
[font]
family = "JetBrains Mono"
size = 11.5
features = ["zero"]
[window]
opacity = 0.92
blur = true
padding_x = 14
padding_y = 12
[cursor]
shape = "beam"
blinking = "never"
[scrollback]
lines = 50000
[shader]
files = ["starfield-dark.wgsl", "cursor-tail.wgsl"]
[keybindings]
"ctrl+shift+k" = "clear_scrollback"
"ctrl+shift+o" = "copy_command_output"Using tron
Looks
Features
Reference