Theming

repartee uses irssi-compatible format strings with 24-bit color support.

Theme files

Themes are TOML files stored in ~/.repartee/themes/. Set the active theme in your config:

[general]
theme = "mytheme"

This loads ~/.repartee/themes/mytheme.theme.

Theme structure

A theme file has two sections: colors and abstracts.

[colors]
bg = "1a1b26"
bg_alt = "24283b"
fg = "a9b1d6"
fg_alt = "565f89"
highlight = "e0af68"
nick_self = "7aa2f7"
timestamp = "565f89"
separator = "3b4261"

[abstracts]
line_start = "{timestamp $Z}{sb_background}"
timestamp = "%Z565f89$*"
own_msg = "{ownmsgnick $0}$1"
pubmsg = "{pubmsgnick $0}$1"
date_separator = "%Z3b4261─── $* ───"
backlog_end = "%Z565f89─── End of backlog ($* lines) ───"

Colors

The [colors] section defines hex RGB values (without #) for UI elements:

Abstracts

Abstracts are named format string templates that can reference each other. They control how every UI element is rendered -- from message lines to the status bar.

See Format Strings below for the full format string syntax.

Default theme

If no theme is set, repartee uses built-in defaults with a dark color scheme inspired by Tokyo Night.

Format Strings

repartee implements a full irssi-compatible format string engine with extensions for 24-bit color.

Color codes

24-bit foreground: %Z + RRGGBB

%Z7aa2f7Hello    → "Hello" in blue (#7aa2f7)

24-bit background: %z + RRGGBB

%z1a1b26%Za9b1d6Text    → Light text on dark background

irssi single-letter codes: %X

Style codes

Abstracts: {name args}

Abstracts are named templates that expand recursively:

[abstracts]
sb_background = "%z24283b"
timestamp = "%Z565f89$*"
line_start = "{timestamp $Z}{sb_background}"

Usage in another abstract: {timestamp 12:34} expands $* to 12:34.

Variable substitution

Example: $[8]0 pads argument 0 to 8 characters (right-aligned by default).

mIRC control characters

repartee also parses mIRC-style control characters in incoming messages:

Abstraction depth

Abstracts can reference other abstracts up to 10 levels deep to prevent infinite recursion.