Skip to content

Configuration

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

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 DIR or the environment variable TRON_CONFIG_DIR point tron at another configuration directory.
  • Startup screen. The Settings, Themes and Shaders tabs of tron --startup edit this file for you, with a live preview.

Top level

# 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]

[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.

[window]

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

[cursor]

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

[colors]

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

[scrollback]

Key Default Meaning
lines 10000 Lines kept in history
multiplier 3.0 Lines per mouse wheel step

[shell]

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.

[selection]

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

[clipboard]

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.

[shader]

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

[images]

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

[bell]

Key Default Meaning
mode "attention" none, visual (flash), attention (urgency hint while unfocused) or both

[links]

Key Default Meaning
open_command xdg-open, open on macOS Program that opens links clicked with Ctrl (Cmd on macOS)

[notifications]

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.

[updates]

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

See Getting Started#updates.

[harness]

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.

[keybindings]

See Key Bindings.

A complete example

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"

Clone this wiki locally