WezTerm TOML Files

Where Rusty Looks

1. Near executable: term/
2. Near executable: dist/term/
3. Current working directory: term/
4. Current working directory: dist/term/

Only .toml files are loaded.

Selection and Identity Rules

• Theme ID = filename stem lowercased (example: tokyo-night.toml -> tokyo-night).
• Name uses root name, then [metadata].name, then filename fallback.
• Comment uses root comment, then [metadata].author.
• Duplicate IDs are skipped. Duplicate names are also skipped.

Required and Optional Colors

Rusty reads keys from [colors] first, then root-level fallback keys.

ANSI Palette Requirements

Option A: Arrays

• ansi must contain exactly 8 colors.
• brights must contain exactly 8 colors.

Option B: Named Keys

• black, red, green, yellow, blue, magenta, cyan, white
• bright_black, bright_red, bright_green, bright_yellow, bright_blue, bright_magenta, bright_cyan, bright_white

Indexed Overrides

• Optional [indexed] or [colors.indexed] numeric overrides for palette indexes 0-15.

Supported Color Value Forms

• String color values (parsed with WezTerm-compatible SrgbaTuple parser).
• Numeric arrays: [r, g, b] or [r, g, b, a].
• Tables with nested color or RGBA keys, for example { color = "#88c0d0" } or { r = 136, g = 192, b = 208 }.
• Numeric scale can be 0-1 or 0-255.

Alpha is parsed but terminal rendering stores RGB values. Fully transparent values are rejected for required palette colors.

Light/Dark Classification

• If light = true|false exists, Rusty uses that.
• Otherwise Rusty infers light mode from background luminance.

Practical Example

light = false
comment = "Balanced dark blue"

[metadata]
name = "Tokyo Night"
author = "Rusty"

[colors]
foreground = "#C0CAF5"
background = "#1A1B26"
cursor_bg = "#C0CAF5"
selection_bg = "#33467C"
selection_fg = "#C0CAF5"
ansi = ["#15161E", "#F7768E", "#9ECE6A", "#E0AF68", "#7AA2F7", "#BB9AF7", "#7DCFFF", "#A9B1D6"]
brights = ["#414868", "#F7768E", "#9ECE6A", "#E0AF68", "#7AA2F7", "#BB9AF7", "#7DCFFF", "#C0CAF5"]

How To Apply In Rusty

1. Place TOML files into term/.
2. Open Settings -> Terminal Colors.
3. Click Reload from term/.
4. Click a theme card to apply instantly.

If a selected terminal theme is missing at startup, Rusty applies fallback terminal colors and clears invalid selection state.