1aerc-stylesets(7) Miscellaneous Information Manual aerc-stylesets(7)
2
6 aerc-stylesets - styleset file specification for aerc(1)
7
9 aerc uses a simple configuration syntax to configure the styleset for
10 its ui.
11
13 Aerc uses a simple configuration file to describe a styleset. The
14 styleset is described as key, value pairs. In each line, the key repre‐
15 sents the style object it signifies and the color/attribute of that is
16 modified.
17 For example, in the line below, the foreground color of the style ob‐
19 ject "msglist_unread" is set to "cornflowerblue"
20 msglist_unread.fg=cornflowerblue
21 The configuration also allows wildcard matching of the style_objects to
23 configure multiple style objects at a time.
24 Style
26 The following options are available to be modified for each of the
27 style objects.
28 fg
30 The foreground color of the style object is set.
31 Syntax: `<style_object>.fg=<color>`
33 bg
35 The background color of the style object is set.
36 Syntax: `<style_object>.bg=<color>`
38 bold
40 The bold attribute of the style object is set/unset.
41 Syntax: `<style_object>.bold=<true|false|toggle>`
43 blink
45 The blink attribute of the style object is set/unset. The terminal
46 needs to support blinking text
47 Syntax: `<style_object>.blink=<true|false|toggle>`
49 underline
51 The underline attribute of the style object is set/unset. The ter‐
52 minal needs to support underline text
53 Syntax: `<style_object>.underline=<true|false|toggle>`
55 reverse
57 Reverses the color of the style object. Exchanges the foreground
58 and background colors.
59 Syntax: `<style_object>.reverse=<true|false|toggle>` If the value
61 is false, it doesn't change anything
62 normal
64 All the attributes of the style object are unset.
65 Syntax: `<style_object>.normal=<true>` The value doesn't matter
67 default
69 Set the style object to the default style of the context. Usually
70 based on the terminal.
71 Syntax: `<style_object>.default=<true>` The value doesn't matter
73 Style Objects
75 The style objects represent the various ui elements or ui instances for
76 styling.
77 ┌───────────────────┬────────────────────────────┐
79 │Style Object │ Description │
80 ├───────────────────┼────────────────────────────┤
81 │default │ The default style object │
82 │ │ used for normal ui ele‐ │
83 │ │ ments while not using spe‐ │
84 │ │ cialized configuration. │
85 ├───────────────────┼────────────────────────────┤
86 │error │ The style used to show er‐ │
87 │ │ rors. │
88 ├───────────────────┼────────────────────────────┤
89 │warning │ The style used when show‐ │
90 │ │ ing warnings. │
91 ├───────────────────┼────────────────────────────┤
92 │success │ The style used for success │
93 │ │ messages. │
94 ├───────────────────┼────────────────────────────┤
95 │title │ The style object used to │
96 │ │ style titles in ui ele‐ │
97 │ │ ments. │
98 ├───────────────────┼────────────────────────────┤
99 │header │ The style object used to │
100 │ │ style headers in ui ele‐ │
101 │ │ ments. │
102 ├───────────────────┼────────────────────────────┤
103 │statusline_default │ The default style applied │
104 │ │ to the statusline. │
105 ├───────────────────┼────────────────────────────┤
106 │statusline_error │ The style used for error │
107 │ │ messages in statusline. │
108 ├───────────────────┼────────────────────────────┤
109 │statusline_success │ The style used for success │
110 │ │ messages in statusline. │
111 ├───────────────────┼────────────────────────────┤
112 │msglist_default │ The default style for mes‐ │
113 │ │ sages in a message list. │
114 ├───────────────────┼────────────────────────────┤
115 │msglist_unread │ Unread messages in a mes‐ │
116 │ │ sage list. │
117 ├───────────────────┼────────────────────────────┤
118 │msglist_read │ Read messages in a message │
119 │ │ list. │
120 ├───────────────────┼────────────────────────────┤
121 │msglist_flagged │ The messages with the │
122 │ │ flagged flag. │
123 ├───────────────────┼────────────────────────────┤
124 │msglist_deleted │ The messages marked as │
125 │ │ deleted. │
126 ├───────────────────┼────────────────────────────┤
127 │msglist_marked │ The messages with the │
128 │ │ marked flag. │
129 ├───────────────────┼────────────────────────────┤
130 │dirlist_default │ The default style for di‐ │
131 │ │ rectories in the directory │
132 │ │ list. │
133 ├───────────────────┼────────────────────────────┤
134 │dirlist_unread │ The style used for direc‐ │
135 │ │ tories with unread mes‐ │
136 │ │ sages │
137 ├───────────────────┼────────────────────────────┤
138 │dirlist_recent │ The style used for direc‐ │
139 │ │ tories with recent mes‐ │
140 │ │ sages │
141 ├───────────────────┼────────────────────────────┤
142 │completion_default │ The default style for the │
143 │ │ completion engine. │
144 ├───────────────────┼────────────────────────────┤
145 │completion_gutter │ The completion gutter. │
146 ├───────────────────┼────────────────────────────┤
147 │completion_pill │ The completion pill. │
148 ├───────────────────┼────────────────────────────┤
149 │tab │ The style for the tab bar. │
150 ├───────────────────┼────────────────────────────┤
151 │stack │ The style for ui stack el‐ │
152 │ │ ement. │
153 ├───────────────────┼────────────────────────────┤
154 │spinner │ The style for the loading │
155 │ │ spinner. │
156 ├───────────────────┼────────────────────────────┤
157 │border │ The style used to draw │
158 │ │ borders. Only the back‐ │
159 │ │ ground color is used un‐ │
160 │ │ less you customize border- │
161 │ │ char-vertical and/or bor‐ │
162 │ │ der-char-horizontal in │
163 │ │ aerc.conf. │
164 ├───────────────────┼────────────────────────────┤
165 │selector_default │ The default style for the │
166 │ │ selector ui element. │
167 ├───────────────────┼────────────────────────────┤
168 │selector_focused │ The focused item in a se‐ │
169 │ │ lector ui element. │
170 ├───────────────────┼────────────────────────────┤
171 │selector_chooser │ The item chooser in a se‐ │
172 │ │ lector ui element. │
173 └───────────────────┴────────────────────────────┘
174 fnmatch style wildcard matching
176 The styleset configuration can be made simpler by using the fnmatch
177 style wildcard matching for the style object.
178 The special characters used in the fnmatch wildcards are:
180 ┌────────┬────────────────────────────┐
182 │Pattern │ Meaning │
183 ├────────┼────────────────────────────┤
184 │* │ Matches everything │
185 ├────────┼────────────────────────────┤
186 │? │ Matches any single charac‐ │
187 │ │ ter │
188 └────────┴────────────────────────────┘
189 For example, the following wildcards can be made using this syntax.
190 ┌─────────────────┬───────────────────────────┐
192 │Example │ Description │
193 ├─────────────────┼───────────────────────────┤
194 │*.fg=blue │ Set the foreground color │
195 │ │ of all style objects to │
196 │ │ blue. │
197 ├─────────────────┼───────────────────────────┤
198 │*list.bg=hotpink │ Set the background color │
199 │ │ of all style objects that │
200 │ │ end in list to hotpink. │
201 └─────────────────┴───────────────────────────┘
202 Selected modifier
204 Selected modifier can be applied to any style object. The style pro‐
205 vided for the selected modifier are applied on top of the style object
206 it corresponds to.
207 If you would like to make sure message that are flagged as read in the
209 msglist appear in yellow foreground and black background. You can spec‐
210 ify that with this:
211 msglist_default.selected.fg=yellow
213 msglist_default.selected.bg=black
215 If we specify the global style selected modifier using fnmatch as be‐
217 low:
218 *.selected.reverse=toggle
220 This toggles the reverse switch for selected version of all the style
222 objects.
223 Layered styles
225 Some styles, (currently the `msglist*` and `dirlist*` ones) are applied
226 in layers. If a style differs from the base (in this case `{ms‐
227 glist|dirlist}_default`) then that style applies, unless overridden by
228 a higher layer. The order that `msglist` styles are applied in is, from
229 first to last:
230 msglist_default
232 msglist_unread
233 msglist_read
234 msglist_flagged
235 msglist_deleted
236 msglist_marked
237 So, the marked style will override all other msglist styles. The order
239 for `dirlist` styles is:
240 dirlist_default
242 dirlist_unread
243 dirlist_recent
244 Colors
246 The color values are set using the values accepted by the tcell li‐
247 brary. The values can be one of the following.
248 default
250 The color is set as per the system or terminal default.
251 <Color name>
253 Any w3c approved color name is used to set colors for the
254 style.
255 <Hex code>
257 Hexcode for a color can be used. The format must be "#XXXXXX"
258 <Dec number>
260 Color based on the palette index. Valid numbers are between 0
261 and 255.
262
264 aerc(1) aerc-config(5)
265
267 Originally created by Drew DeVault <sir@cmpwn.com> and maintained by
268 Robin Jarry <robin@jarry.cc> who is assisted by other open source con‐
269 tributors. For more information about aerc development, see
270 https://sr.ht/~rjarry/aerc/.
271 2022-11-02 aerc-stylesets(7)