Skip to content
Ö. Efe D. edited this page Sep 15, 2026 · 1 revision

Themes

Choosing a theme

Set theme at the top of ~/.config/tron/config.toml:

theme = "catppuccin-mocha"

The easiest way to pick one is the Themes tab of the startup screen (tron --startup). It previews every theme on your terminal and saves your choice.

Built-in themes

  • tron, the default dark theme, and tron-light.
  • About 460 more from iTerm2-Color-Schemes, named in lower case with hyphens: catppuccin-mocha, dracula, gruvbox-dark, nord, rose-pine, solarized-dark, tokyonight-storm and so on.

The built-in theme files are in examples/themes.

Writing a theme

Put a file in ~/.config/tron/themes/<name>.toml and select it with theme = "<name>". A theme with the same name as a built-in one replaces it.

# ~/.config/tron/themes/midnight.toml
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"]
Key Meaning
foreground, background Default text and background colors
cursor Cursor color
cursor_text Text under a block cursor. Default: the background color
selection_background Background of selected text
selection_foreground Text inside a selection. Default: the text keeps its color
normal ANSI colors 0 to 7: black, red, green, yellow, blue, magenta, cyan, white
bright ANSI colors 8 to 15, the bright variants

Colors are #rrggbb hex strings. Colors 16 to 255 of the 256 color palette are the standard xterm cube and gray ramp.

Tweaking a theme

The [colors] table in config.toml overrides single colors on top of the selected theme, with the same keys as a theme file:

theme = "nord"

[colors]
background = "#1b1f27"
cursor = "#ff79c6"
# Draw bold text in colors 0-7 with the bright variant.
bold_is_bright = true

Transparency and blur

[window]
opacity = 0.9     # 0.0 to 1.0
blur = true       # blur what is behind the window, where the compositor supports it (KDE Plasma)

Shaders keep a translucent window translucent. See Writing Shaders for how alpha works.

Hot reload

tron watches the configuration directory. Saving config.toml or a theme file applies the change to open windows right away.

Clone this wiki locally