Themes

A theme controls the colors Rune draws with: the editor, the UI, and syntax highlighting. Rune ships a set of themes out of the box, and you can add your own entirely from configuration.

How themes work

Rune renders everything through a small named color palette (the standard terminal color names like red, green, blue, and so on). A theme is simply a set of overrides for those names: it remaps each name to the value you want. Because the whole interface references colors by name, remapping the palette re-themes everything at once, even your terminal's colors!

Themes live under the gui section of your config:

• gui.themes is a catalog of named themes.
• gui.default_theme picks which one is active at startup.

The default configuration ships sixteen themes and starts on romero.

Switching themes

Change the active theme at any time with the guitheme command:

guitheme carmack

Run guitheme with no argument to return to the default. To preview the named colors live, use the colorPalette command.

What a theme overrides

A theme entry maps color names to values. Each value can be a hex string ("#ff2400") or another known color name ("darkorange").

Three keys are special:

Key	Sets
foreground	the default text color
background	the default background color
cursor	the cursor color

Every other key remaps one of the named palette colors. These are essentially the 8 regular ANSI colors plus the 8 bold (bright) ones, 16 in total:

Regular	Default	Bold	Default
black		gray
maroon		red
green		lime
olive		yellow
navy		blue
purple		fuchsia
teal		aqua
silver		white

Creating a theme

Add a new entry under gui.themes and point gui.default_theme at it:

config.yaml

gui:
  default_theme: mytheme
  themes:
    mytheme:
      foreground: "#e0e0e0"
      background: "#101010"
      cursor: "#ff8800"
      black: "#101010"
      white: "#e0e0e0"
      red: "#cc3333"
      green: "#33aa55"
      yellow: "#d6a23a"
      blue: "#3a78d6"
      fuchsia: "#c06fd0"
      aqua: "#3ac6c6"
      gray: "#202020"
      silver: "#888888"
      maroon: "#8a2a2a"
      olive: "#9a8030"
      navy: "#2a3a6a"
      purple: "#6a3a9a"
      lime: "#5fd06f"
      teal: "#3a9a9a"

You do not have to set every color. Any name you leave out keeps its current value, so a theme can be as small as a couple of overrides.

Once it is in your config, activate it with guitheme mytheme or restart with default_theme set to it.