Skip to content

Theming

Brett Terpstra edited this page Mar 7, 2023 · 1 revision

When Howzit runs, it creates a theme file in ~/.config/howzit/theme.yaml. This file is automatically filled with the color assignments for each color name. If you modify this file, you can change the look of Howzit's output. By changing :green to '#00a8ff', you can make everything that Howzit displays in green turn a bright blue.

The default colors are:

---
:black: 30
:red: 31
:green: 32
:yellow: 33
:blue: 34
:magenta: 35
:purple: 35
:cyan: 36
:white: 37
:bgblack: 40
:bgred: 41
:bggreen: 42
:bgyellow: 43
:bgblue: 44
:bgmagenta: 45
:bgpurple: 45
:bgcyan: 46
:bgwhite: 47
:boldblack: 90
:boldred: 91
:boldgreen: 92
:boldyellow: 93
:boldblue: 94
:boldmagenta: 95
:boldpurple: 95
:boldcyan: 96
:boldwhite: 97
:boldbgblack: 100
:boldbgred: 101
:boldbggreen: 102
:boldbgyellow: 103
:boldbgblue: 104
:boldbgmagenta: 105
:boldbgpurple: 105
:boldbgcyan: 106
:boldbgwhite: 107

The defaults use ANSI escape codes for each color. If a color starts with "bg", it specifies a background color (Howzit does not use these often) and if it starts with "bold" it specifies the color that should be used when the ANSI "bright" version of the color is displayed.

You can swap around the ANSI codes, or add RGB hex codes by quoting the string and starting it with "#", e.g. :green: '#00a8ff'.

Clone this wiki locally