]>
Commit | Line | Data |
---|---|---|
1 | # | |
2 | # aerc main configuration | |
3 | ||
4 | [general] | |
5 | # | |
6 | # Used as a default path for save operations if no other path is specified. | |
7 | # ~ is expanded to the current user home dir. | |
8 | # | |
9 | #default-save-path= | |
10 | ||
11 | # If set to "gpg", aerc will use system gpg binary and keystore for all crypto | |
12 | # operations. If set to "internal", the internal openpgp keyring will be used. | |
13 | # If set to "auto", the system gpg will be preferred unless the internal | |
14 | # keyring already exists, in which case the latter will be used. | |
15 | # | |
16 | # Default: auto | |
17 | #pgp-provider=auto | |
18 | ||
19 | # By default, the file permissions of accounts.conf must be restrictive and | |
20 | # only allow reading by the file owner (0600). Set this option to true to | |
21 | # ignore this permission check. Use this with care as it may expose your | |
22 | # credentials. | |
23 | # | |
24 | # Default: false | |
25 | #unsafe-accounts-conf=false | |
26 | ||
27 | # Output log messages to specified file. A path starting with ~/ is expanded to | |
28 | # the user home dir. When redirecting aerc's output to a file using > shell | |
29 | # redirection, this setting is ignored and log messages are printed to stdout. | |
30 | # | |
31 | #log-file= | |
32 | ||
33 | # Only log messages above the specified level to log-file. Supported levels | |
34 | # are: trace, debug, info, warn and error. When redirecting aerc's output to | |
35 | # a file using > shell redirection, this setting is ignored and the log level | |
36 | # is forced to trace. | |
37 | # | |
38 | # Default: info | |
39 | #log-level=info | |
40 | ||
41 | # Set the $TERM environment variable used for the embedded terminal. | |
42 | # | |
43 | # Default: xterm-256color | |
44 | #term=xterm-256color | |
45 | ||
46 | # Display OSC8 strings in the embedded terminal | |
47 | # | |
48 | # Default: false | |
49 | #enable-osc8=false | |
50 | ||
51 | [ui] | |
52 | # | |
53 | # Describes the format for each row in a mailbox view. This is a comma | |
54 | # separated list of column names with an optional align and width suffix. After | |
55 | # the column name, one of the '<' (left), ':' (center) or '>' (right) alignment | |
56 | # characters can be added (by default, left) followed by an optional width | |
57 | # specifier. The width is either an integer representing a fixed number of | |
58 | # characters, or a percentage between 1% and 99% representing a fraction of the | |
59 | # terminal width. It can also be one of the '*' (auto) or '=' (fit) special | |
60 | # width specifiers. Auto width columns will be equally attributed the remaining | |
61 | # terminal width. Fit width columns take the width of their contents. If no | |
62 | # width specifier is set, '*' is used by default. | |
63 | # | |
64 | # Default: date<20,name<17,flags>4,subject<* | |
65 | #index-columns=date<20,name<17,flags>4,subject<* | |
66 | ||
67 | # | |
68 | # Each name in index-columns must have a corresponding column-$name setting. | |
69 | # All column-$name settings accept golang text/template syntax. See | |
70 | # aerc-templates(7) for available template attributes and functions. | |
71 | # | |
72 | # Default settings | |
73 | #column-date={{.DateAutoFormat .Date.Local}} | |
74 | #column-name={{index (.From | names) 0}} | |
75 | #column-flags={{.Flags | join ""}} | |
76 | #column-subject={{.ThreadPrefix}}{{.Subject}} | |
77 | ||
78 | # | |
79 | # String separator inserted between columns. When the column width specifier is | |
80 | # an exact number of characters, the separator is added to it (i.e. the exact | |
81 | # width will be fully available for the column contents). | |
82 | # | |
83 | # Default: " " | |
84 | #column-separator=" " | |
85 | ||
86 | # | |
87 | # See time.Time#Format at https://godoc.org/time#Time.Format | |
88 | # | |
89 | # Default: 2006-01-02 03:04 PM (ISO 8601 + 12 hour time) | |
90 | #timestamp-format=2006-01-02 03:04 PM | |
91 | ||
92 | # | |
93 | # Index-only time format for messages that were received/sent today. | |
94 | # If this is not specified, timestamp-format is used instead. | |
95 | # | |
96 | #this-day-time-format= | |
97 | ||
98 | # | |
99 | # Index-only time format for messages that were received/sent within the last | |
100 | # 7 days. If this is not specified, timestamp-format is used instead. | |
101 | # | |
102 | #this-week-time-format= | |
103 | ||
104 | # | |
105 | # Index-only time format for messages that were received/sent this year. | |
106 | # If this is not specified, timestamp-format is used instead. | |
107 | # | |
108 | #this-year-time-format= | |
109 | ||
110 | # | |
111 | # Width of the sidebar, including the border. | |
112 | # | |
113 | # Default: 20 | |
114 | #sidebar-width=20 | |
115 | ||
116 | # | |
117 | # Message to display when viewing an empty folder. | |
118 | # | |
119 | # Default: (no messages) | |
120 | #empty-message=(no messages) | |
121 | ||
122 | # Message to display when no folders exists or are all filtered | |
123 | # | |
124 | # Default: (no folders) | |
125 | #empty-dirlist=(no folders) | |
126 | ||
127 | # Enable mouse events in the ui, e.g. clicking and scrolling with the mousewheel | |
128 | # | |
129 | # Default: false | |
130 | #mouse-enabled=false | |
131 | ||
132 | # | |
133 | # Ring the bell when new messages are received | |
134 | # | |
135 | # Default: true | |
136 | #new-message-bell=true | |
137 | ||
138 | # | |
139 | # Template to use for Account tab titles | |
140 | # | |
141 | # Default: {{.Account}} | |
142 | tab-title-account={{.Account}} {{if .Unread}}({{.Unread}}){{end}} | |
143 | ||
144 | # Marker to show before a pinned tab's name. | |
145 | # | |
146 | # Default: ` | |
147 | #pinned-tab-marker='`' | |
148 | ||
149 | # Template for the left side of the directory list. | |
150 | # See aerc-templates(7) for all available fields and functions. | |
151 | # | |
152 | # Default: {{.Folder}} | |
153 | #dirlist-left={{.Folder}} | |
154 | ||
155 | # Template for the right side of the directory list. | |
156 | # See aerc-templates(7) for all available fields and functions. | |
157 | # | |
158 | # Default: {{if .Unread}}{{humanReadable .Unread}}/{{end}}{{if .Exists}}{{humanReadable .Exists}}{{end}} | |
159 | #dirlist-right={{if .Unread}}{{humanReadable .Unread}}/{{end}}{{if .Exists}}{{humanReadable .Exists}}{{end}} | |
160 | ||
161 | # Delay after which the messages are actually listed when entering a directory. | |
162 | # This avoids loading messages when skipping over folders and makes the UI more | |
163 | # responsive. If you do not want that, set it to 0s. | |
164 | # | |
165 | # Default: 200ms | |
166 | #dirlist-delay=200ms | |
167 | ||
168 | # Display the directory list as a foldable tree that allows to collapse and | |
169 | # expand the folders. | |
170 | # | |
171 | # Default: false | |
172 | #dirlist-tree=false | |
173 | ||
174 | # If dirlist-tree is enabled, set level at which folders are collapsed by | |
175 | # default. Set to 0 to disable. | |
176 | # | |
177 | # Default: 0 | |
178 | #dirlist-collapse=0 | |
179 | ||
180 | # List of space-separated criteria to sort the messages by, see *sort* | |
181 | # command in *aerc*(1) for reference. Prefixing a criterion with "-r " | |
182 | # reverses that criterion. | |
183 | # | |
184 | # Example: "from -r date" | |
185 | # | |
186 | #sort= | |
187 | ||
188 | # Moves to next message when the current message is deleted | |
189 | # | |
190 | # Default: true | |
191 | #next-message-on-delete=true | |
192 | ||
193 | # Automatically set the "seen" flag when a message is opened in the message | |
194 | # viewer. | |
195 | # | |
196 | # Default: true | |
197 | #auto-mark-read=true | |
198 | ||
199 | # The directories where the stylesets are stored. It takes a colon-separated | |
200 | # list of directories. If this is unset or if a styleset cannot be found, the | |
201 | # following paths will be used as a fallback in that order: | |
202 | # | |
203 | # ${XDG_CONFIG_HOME:-~/.config}/aerc/stylesets | |
204 | # ${XDG_DATA_HOME:-~/.local/share}/aerc/stylesets | |
205 | # /usr/local/share/aerc/stylesets | |
206 | # /usr/share/aerc/stylesets | |
207 | # | |
208 | #stylesets-dirs= | |
209 | ||
210 | # Uncomment to use box-drawing characters for vertical and horizontal borders. | |
211 | # | |
212 | # Default: " " | |
213 | #border-char-vertical=" " | |
214 | #border-char-horizontal=" " | |
215 | ||
216 | # Sets the styleset to use for the aerc ui elements. | |
217 | # | |
218 | # Default: default | |
219 | #styleset-name=default | |
220 | ||
221 | # Activates fuzzy search in commands and their arguments: the typed string is | |
222 | # searched in the command or option in any position, and need not be | |
223 | # consecutive characters in the command or option. | |
224 | # | |
225 | # Default: false | |
226 | #fuzzy-complete=false | |
227 | ||
228 | # How long to wait after the last input before auto-completion is triggered. | |
229 | # | |
230 | # Default: 250ms | |
231 | #completion-delay=250ms | |
232 | ||
233 | # The minimum required characters to allow auto-completion to be triggered after | |
234 | # completion-delay. | |
235 | # | |
236 | # Default: 1 | |
237 | #completion-min-chars=1 | |
238 | ||
239 | # | |
240 | # Global switch for completion popovers | |
241 | # | |
242 | # Default: true | |
243 | #completion-popovers=true | |
244 | ||
245 | # Uncomment to use UTF-8 symbols to indicate PGP status of messages | |
246 | # | |
247 | # Default: ASCII | |
248 | #icon-unencrypted= | |
249 | #icon-encrypted=✔ | |
250 | #icon-signed=✔ | |
251 | #icon-signed-encrypted=✔ | |
252 | #icon-unknown=✘ | |
253 | #icon-invalid=⚠ | |
254 | ||
255 | # Reverses the order of the message list. By default, the message list is | |
256 | # ordered with the newest (highest UID) message on top. Reversing the order | |
257 | # will put the oldest (lowest UID) message on top. This can be useful in cases | |
258 | # where the backend does not support sorting. | |
259 | # | |
260 | # Default: false | |
261 | #reverse-msglist-order = false | |
262 | ||
263 | # Reverse display of the mesage threads. Default order is the the intial | |
264 | # message is on the top with all the replies being displayed below. The | |
265 | # reverse option will put the initial message at the bottom with the | |
266 | # replies on top. | |
267 | # | |
268 | # Default: false | |
269 | #reverse-thread-order=false | |
270 | ||
271 | # Sort the thread siblings according to the sort criteria for the messages. If | |
272 | # sort-thread-siblings is false, the thread siblings will be sorted based on | |
273 | # the message UID in ascending order. This option is only applicable for | |
274 | # client-side threading with a backend that enables sorting. Note that there's | |
275 | # a performance impact when sorting is activated. | |
276 | # | |
277 | # Default: false | |
278 | #sort-thread-siblings=false | |
279 | ||
280 | #[ui:account=foo] | |
281 | # | |
282 | # Enable a threaded view of messages. If this is not supported by the backend | |
283 | # (IMAP server or notmuch), threads will be built by the client. | |
284 | # | |
285 | # Default: false | |
286 | #threading-enabled=false | |
287 | ||
288 | # Force client-side thread building | |
289 | # | |
290 | # Default: false | |
291 | #force-client-threads=false | |
292 | ||
293 | # Debounce client-side thread building | |
294 | # | |
295 | # Default: 50ms | |
296 | #client-threads-delay=50ms | |
297 | ||
298 | [statusline] | |
299 | # | |
300 | # Describes the format for the status line. This is a comma separated list of | |
301 | # column names with an optional align and width suffix. See [ui].index-columns | |
302 | # for more details. To completely mute the status line except for push | |
303 | # notifications, explicitly set status-columns to an empty string. | |
304 | # | |
305 | # Default: left<*,center:=,right>* | |
306 | #status-columns=left<*,center:=,right>* | |
307 | ||
308 | # | |
309 | # Each name in status-columns must have a corresponding column-$name setting. | |
310 | # All column-$name settings accept golang text/template syntax. See | |
311 | # aerc-templates(7) for available template attributes and functions. | |
312 | # | |
313 | # Default settings | |
314 | #column-left=[{{.Account}}] {{.StatusInfo}} | |
315 | #column-center={{.PendingKeys}} | |
316 | #column-right={{.TrayInfo}} | |
317 | ||
318 | # | |
319 | # String separator inserted between columns. | |
320 | # See [ui].column-separator for more details. | |
321 | # | |
322 | #column-separator=" " | |
323 | ||
324 | # Specifies the separator between grouped statusline elements. | |
325 | # | |
326 | # Default: " | " | |
327 | #separator=" | " | |
328 | ||
329 | # Defines the mode for displaying the status elements. | |
330 | # Options: text, icon | |
331 | # | |
332 | # Default: text | |
333 | #display-mode=text | |
334 | ||
335 | [viewer] | |
336 | # | |
337 | # Specifies the pager to use when displaying emails. Note that some filters | |
338 | # may add ANSI codes to add color to rendered emails, so you may want to use a | |
339 | # pager which supports ANSI codes. | |
340 | # | |
341 | # Default: less -R | |
342 | #pager=less -R | |
343 | ||
344 | # | |
345 | # If an email offers several versions (multipart), you can configure which | |
346 | # mimetype to prefer. For example, this can be used to prefer plaintext over | |
347 | # html emails. | |
348 | # | |
349 | # Default: text/plain,text/html | |
350 | #alternatives=text/plain,text/html | |
351 | ||
352 | # | |
353 | # Default setting to determine whether to show full headers or only parsed | |
354 | # ones in message viewer. | |
355 | # | |
356 | # Default: false | |
357 | #show-headers=false | |
358 | ||
359 | # | |
360 | # Layout of headers when viewing a message. To display multiple headers in the | |
361 | # same row, separate them with a pipe, e.g. "From|To". Rows will be hidden if | |
362 | # none of their specified headers are present in the message. | |
363 | # | |
364 | # Default: From|To,Cc|Bcc,Date,Subject | |
365 | #header-layout=From|To,Cc|Bcc,Date,Subject | |
366 | ||
367 | # Whether to always show the mimetype of an email, even when it is just a single part | |
368 | # | |
369 | # Default: false | |
370 | #always-show-mime=false | |
371 | ||
372 | # Parses and extracts http links when viewing a message. Links can then be | |
373 | # accessed with the open-link command. | |
374 | # | |
375 | # Default: true | |
376 | #parse-http-links=true | |
377 | ||
378 | [compose] | |
379 | # | |
380 | # Specifies the command to run the editor with. It will be shown in an embedded | |
381 | # terminal, though it may also launch a graphical window if the environment | |
382 | # supports it. Defaults to $EDITOR, or vi. | |
383 | #editor= | |
384 | ||
385 | # | |
386 | # Default header fields to display when composing a message. To display | |
387 | # multiple headers in the same row, separate them with a pipe, e.g. "To|From". | |
388 | # | |
389 | # Default: To|From,Subject | |
390 | #header-layout=To|From,Subject | |
391 | ||
392 | # | |
393 | # Specifies the command to be used to tab-complete email addresses. Any | |
394 | # occurrence of "%s" in the address-book-cmd will be replaced with what the | |
395 | # user has typed so far. | |
396 | # | |
397 | # The command must output the completions to standard output, one completion | |
398 | # per line. Each line must be tab-delimited, with an email address occurring as | |
399 | # the first field. Only the email address field is required. The second field, | |
400 | # if present, will be treated as the contact name. Additional fields are | |
401 | # ignored. | |
402 | # | |
403 | # This parameter can also be set per account in accounts.conf. | |
404 | #address-book-cmd= | |
405 | ||
406 | # Specifies the command to be used to select attachments. Any occurence of '%s' | |
407 | # in the file-picker-cmd will be replaced the argument <arg> to :attach -m | |
408 | # <arg>. | |
409 | # | |
410 | # The command must output the selected files to standard output, one file per | |
411 | # line. | |
412 | #file-picker-cmd= | |
413 | ||
414 | # | |
415 | # Allow to address yourself when replying | |
416 | # | |
417 | # Default: true | |
418 | #reply-to-self=true | |
419 | ||
420 | # | |
421 | # Warn before sending an email that matches the specified regexp but does not | |
422 | # have any attachments. Leave empty to disable this feature. | |
423 | # | |
424 | # Uses Go's regexp syntax, documented at https://golang.org/s/re2syntax. The | |
425 | # "(?im)" flags are set by default (case-insensitive and multi-line). | |
426 | # | |
427 | # Example: | |
428 | # no-attachment-warning=^[^>]*attach(ed|ment) | |
429 | # | |
430 | #no-attachment-warning= | |
431 | ||
432 | # | |
433 | # When set, aerc will generate "format=flowed" bodies with a content type of | |
434 | # "text/plain; format=flowed" as described in RFC3676. This format is easier to | |
435 | # handle for some mailing software, and generally just looks like ordinary | |
436 | # text. To actually make use of this format's features, you'll need support in | |
437 | # your editor. | |
438 | # | |
439 | #format-flowed=false | |
440 | ||
441 | [multipart-converters] | |
442 | # | |
443 | # Converters allow to generate multipart/alternative messages by converting the | |
444 | # main text/plain part into any other MIME type. Only exact MIME types are | |
445 | # accepted. The commands are invoked with sh -c and are expected to output | |
446 | # valid UTF-8 text. | |
447 | # | |
448 | # Example (obviously, this requires that you write your main text/plain body | |
449 | # using the markdown syntax): | |
450 | text/html=pandoc -f markdown -t html --standalone | |
451 | ||
452 | [filters] | |
453 | # | |
454 | # Filters allow you to pipe an email body through a shell command to render | |
455 | # certain emails differently, e.g. highlighting them with ANSI escape codes. | |
456 | # | |
457 | # The commands are invoked with sh -c. The following folders are appended to | |
458 | # the system $PATH to allow referencing filters from their name only: | |
459 | # | |
460 | # ${XDG_CONFIG_HOME:-~/.config}/aerc/filters | |
461 | # ${XDG_DATA_HOME:-~/.local/share}/aerc/filters | |
462 | # $PREFIX/share/aerc/filters | |
463 | # /usr/share/aerc/filters | |
464 | # | |
465 | # The following variables are defined in the filter command environment: | |
466 | # | |
467 | # AERC_MIME_TYPE the part MIME type/subtype | |
468 | # AERC_FORMAT the part content type format= parameter | |
469 | # AERC_FILENAME the attachment filename (if any) | |
470 | # AERC_SUBJECT the message Subject header value | |
471 | # AERC_FROM the message From header value | |
472 | # | |
473 | # The first filter which matches the email's mimetype will be used, so order | |
474 | # them from most to least specific. | |
475 | # | |
476 | # You can also match on non-mimetypes, by prefixing with the header to match | |
477 | # against (non-case-sensitive) and a comma, e.g. subject,text will match a | |
478 | # subject which contains "text". Use header,~regex to match against a regex. | |
479 | # | |
480 | text/plain=colorize | |
481 | text/calendar=calendar | |
482 | message/delivery-status=colorize | |
483 | message/rfc822=colorize | |
484 | text/html=pandoc -f html -t plain | colorize | |
485 | #text/html=html | colorize | |
486 | text/*=bat -fP --file-name="$AERC_FILENAME" | |
487 | #application/x-sh=bat -fP -l sh | |
488 | #image/*=catimg -w $(tput cols) - | |
489 | #subject,~Git(hub|lab)=lolcat -f | |
490 | #from,thatguywhodoesnothardwraphismessages=wrap -w 100 | colorize | |
491 | ||
492 | # This special filter is only used to post-process email headers when | |
493 | # [viewer].show-headers=true | |
494 | # By default, headers are piped directly into the pager. | |
495 | # | |
496 | .headers=colorize | |
497 | ||
498 | [openers] | |
499 | # | |
500 | # Openers allow you to specify the command to use for the :open and :open-link | |
501 | # actions on a per-MIME-type basis. The :open-link URL scheme is used to | |
502 | # determine the MIME type as follows: x-scheme-handler/<scheme>. | |
503 | # | |
504 | # {} is expanded as the temporary filename to be opened. If it is not | |
505 | # encountered in the command, the temporary filename will be appened to the end | |
506 | # of the command. | |
507 | # | |
508 | # Like [filters], openers support basic shell globbing. The first opener which | |
509 | # matches the part's MIME type (or URL scheme handler MIME type) will be used, | |
510 | # so order them from most to least specific. | |
511 | # | |
512 | # Examples: | |
513 | # x-scheme-handler/irc=hexchat | |
514 | # x-scheme-handler/http*=firefox | |
515 | # text/html=surf -dfgms | |
516 | # text/plain=gvim {} +125 | |
517 | # message/rfc822=thunderbird | |
518 | ||
519 | [hooks] | |
520 | # | |
521 | # Hooks are triggered whenever the associated event occurs. | |
522 | ||
523 | # | |
524 | # Executed when a new email arrives in the selected folder | |
525 | #mail-received=notify-send "New mail from $AERC_FROM_NAME" "$AERC_SUBJECT" | |
526 | ||
527 | # | |
528 | # Executed when aerc starts | |
529 | #aerc-startup=aerc :terminal calcurse && aerc :next-tab | |
530 | ||
531 | # | |
532 | # Executed when aerc shuts down. | |
533 | #aerc-shutdown= | |
534 | ||
535 | [templates] | |
536 | # Templates are used to populate email bodies automatically. | |
537 | # | |
538 | ||
539 | # The directories where the templates are stored. It takes a colon-separated | |
540 | # list of directories. If this is unset or if a template cannot be found, the | |
541 | # following paths will be used as a fallback in that order: | |
542 | # | |
543 | # ${XDG_CONFIG_HOME:-~/.config}/aerc/templates | |
544 | # ${XDG_DATA_HOME:-~/.local/share}/aerc/templates | |
545 | # /usr/local/share/aerc/templates | |
546 | # /usr/share/aerc/templates | |
547 | # | |
548 | #template-dirs= | |
549 | ||
550 | # The default template to be used for new messages. | |
551 | # | |
552 | # default: new_message | |
553 | #new-message=new_message | |
554 | ||
555 | # The default template to be used for quoted replies. | |
556 | # | |
557 | # default: quoted_reply | |
558 | #quoted-reply=quoted_reply | |
559 | ||
560 | # The default template to be used for forward as body. | |
561 | # | |
562 | # default: forward_as_body | |
563 | #forwards=forward_as_body |