AERC-STYLESETS

NAME

aerc-stylesets - styleset file specification for aerc(1)

SYNOPSIS

aerc uses a simple configuration syntax to configure the styleset for its ui.

STYLESET CONFIGURATION

The styleset is described as <object>.<attribute> = <value> pairs.

For example, in the line below, the foreground color of the style object msglist_unread is set to cornflowerblue

msglist_unread.fg = cornflowerblue

The configuration also allows wildcard matching of the keys to configure multiple style objects at a time.

ATTRIBUTES

The following options are available to be modified for each of the style objects.

<object>.fg = <color>

The foreground color of the style object is set.

<object>.bg = <color>

The background color of the style object is set.

<object>.bold = true|false|toggle

The bold attribute of the style object is set/unset.

<object>.blink = true|false|toggle

The blink attribute of the style object is set/unset. The terminal needs to support blinking text.

<object>.underline = true|false|toggle

The underline attribute of the style object is set/unset. The terminal needs to support underline text.

<object>.italic = true|false|toggle

The italic attribute of the style object is set/unset. The terminal needs to support italic text.

<object>.reverse = true|false|toggle

Reverses the color of the style object. Exchanges the foreground and background colors.

If the value is false, it doesn’t change anything.

<object>.normal = true

All the attributes of the style object are unset.

The value doesn’t matter.

<object>.default = true

Set the style object to the default style of the context. Usually based on the terminal.

The value doesn’t matter.

STYLE OBJECTS

The style objects represent the various ui elements or ui instances for styling.

FNMATCH STYLE WILDCARD MATCHING

The styleset configuration can be made simpler by using the fnmatch style wildcard matching for the style object.

The special characters used in the fnmatch wildcards are:

For example, the following wildcards can be made using this syntax.

SELECTED MODIFIER

The selected modifier can be applied to any style object. The style provided for the selected modifier is applied on top of the style object it corresponds to.

If you would like to make sure message that are flagged as read in the msglist appear in yellow foreground and black background. You can specify that with this:

msglist_default.selected.fg = yellow

msglist_default.selected.bg = black

If we specify the global style selected modifier using fnmatch as below:

*.selected.reverse = toggle

This toggles the reverse switch for selected version of all the style objects.

LAYERED STYLES

Some styles, (currently the msglist_* and dirlist_* ones) are applied in layers. If a style differs from the base (in this case *list_default) then that style applies, unless overridden by a higher layer.

The order that msglist_* styles are applied in is, from first to last:

1. msglist_default
2. msglist_unread
3. msglist_read
4. msglist_flagged
5. msglist_deleted
6. msglist_marked

So, the marked style will override all other msglist styles.

The order for dirlist_* styles is:

1. dirlist_default
2. dirlist_unread
3. dirlist_recent

COLORS

The color values are set using the values accepted by the tcell library. The values can be one of the following.

default

The color is set as per the system or terminal default.

<Color name>

Any w3c approved color name is used to set colors for the style.

<Hex code>

Hexcode for a color can be used. The format must be #XXXXXX.

<Dec number>

Color based on the terminal palette index. Valid numbers are between 0 and 255.

SEE ALSO

aerc(1) aerc-config(5)

AUTHORS

Originally created by Drew DeVault <sir@cmpwn.com> and maintained by Robin Jarry <robin@jarry.cc> who is assisted by other open source contributors. For more information about aerc development, see https://sr.ht/˜rjarry/aerc/.