···11#
22# aerc main configuration
3344+[general]
55+#
66+# Used as a default path for save operations if no other path is specified.
77+# ~ is expanded to the current user home dir.
88+#
99+#default-save-path=
1010+1111+# If set to "gpg", aerc will use system gpg binary and keystore for all crypto
1212+# operations. If set to "internal", the internal openpgp keyring will be used.
1313+# If set to "auto", the system gpg will be preferred unless the internal
1414+# keyring already exists, in which case the latter will be used.
1515+#
1616+# Default: auto
1717+#pgp-provider=auto
1818+1919+# By default, the file permissions of accounts.conf must be restrictive and
2020+# only allow reading by the file owner (0600). Set this option to true to
2121+# ignore this permission check. Use this with care as it may expose your
2222+# credentials.
2323+#
2424+# Default: false
2525+#unsafe-accounts-conf=false
2626+2727+# Output log messages to specified file. A path starting with ~/ is expanded to
2828+# the user home dir. When redirecting aerc's output to a file using > shell
2929+# redirection, this setting is ignored and log messages are printed to stdout.
3030+#
3131+#log-file=
3232+3333+# Only log messages above the specified level to log-file. Supported levels
3434+# are: trace, debug, info, warn and error. When redirecting aerc's output to
3535+# a file using > shell redirection, this setting is ignored and the log level
3636+# is forced to trace.
3737+#
3838+# Default: info
3939+#log-level=info
4040+4141+# Set the $TERM environment variable used for the embedded terminal.
4242+#
4343+# Default: xterm-256color
4444+#term=xterm-256color
4545+4646+# Display OSC8 strings in the embedded terminal
4747+#
4848+# Default: false
4949+#enable-osc8=false
5050+451[ui]
55-index-columns = date<*,name<17,flags>4,subject<*
66-column-date = {{.DateAutoFormat .Date.Local}}
77-column-name = {{index (.From | names) 0}}
88-column-flags = {{.Flags | join ""}}
99-column-subject = {{.ThreadPrefix}}{{.Subject}}
5252+#
5353+# Describes the format for each row in a mailbox view. This is a comma
5454+# separated list of column names with an optional align and width suffix. After
5555+# the column name, one of the '<' (left), ':' (center) or '>' (right) alignment
5656+# characters can be added (by default, left) followed by an optional width
5757+# specifier. The width is either an integer representing a fixed number of
5858+# characters, or a percentage between 1% and 99% representing a fraction of the
5959+# terminal width. It can also be one of the '*' (auto) or '=' (fit) special
6060+# width specifiers. Auto width columns will be equally attributed the remaining
6161+# terminal width. Fit width columns take the width of their contents. If no
6262+# width specifier is set, '*' is used by default.
6363+#
6464+# Default: date<20,name<17,flags>4,subject<*
6565+#index-columns=date<20,name<17,flags>4,subject<*
6666+6767+#
6868+# Each name in index-columns must have a corresponding column-$name setting.
6969+# All column-$name settings accept golang text/template syntax. See
7070+# aerc-templates(7) for available template attributes and functions.
7171+#
7272+# Default settings
7373+#column-date={{.DateAutoFormat .Date.Local}}
7474+#column-name={{index (.From | names) 0}}
7575+#column-flags={{.Flags | join ""}}
7676+#column-subject={{.ThreadPrefix}}{{if .ThreadFolded}}{{printf "{%d}" .ThreadCount}}{{end}}{{.Subject}}
7777+7878+#
7979+# String separator inserted between columns. When the column width specifier is
8080+# an exact number of characters, the separator is added to it (i.e. the exact
8181+# width will be fully available for the column contents).
8282+#
8383+# Default: " "
8484+#column-separator=" "
10851186#
1287# See time.Time#Format at https://godoc.org/time#Time.Format
1388#
1489# Default: 2006-01-02 03:04 PM (ISO 8601 + 12 hour time)
1515-timestamp-format=2006-01-02 03:04 PM
9090+#timestamp-format=2006-01-02 03:04 PM
9191+9292+#
9393+# Index-only time format for messages that were received/sent today.
9494+# If this is not specified, timestamp-format is used instead.
9595+#
9696+#this-day-time-format=
9797+9898+#
9999+# Index-only time format for messages that were received/sent within the last
100100+# 7 days. If this is not specified, timestamp-format is used instead.
101101+#
102102+#this-week-time-format=
103103+104104+#
105105+# Index-only time format for messages that were received/sent this year.
106106+# If this is not specified, timestamp-format is used instead.
107107+#
108108+#this-year-time-format=
1610917110#
18111# Width of the sidebar, including the border.
19112#
20113# Default: 20
2121-sidebar-width=20
114114+#sidebar-width=20
2211523116#
24117# Message to display when viewing an empty folder.
25118#
26119# Default: (no messages)
2727-empty-message=(no messages)
120120+#empty-message=(no messages)
2812129122# Message to display when no folders exists or are all filtered
30123#
31124# Default: (no folders)
3232-empty-dirlist=(no folders)
125125+#empty-dirlist=(no folders)
3312634127# Enable mouse events in the ui, e.g. clicking and scrolling with the mousewheel
35128#
36129# Default: false
3737-mouse-enabled=false
130130+#mouse-enabled=false
3813139132#
40133# Ring the bell when new messages are received
41134#
42135# Default: true
4343-new-message-bell=true
136136+#new-message-bell=true
137137+138138+#
139139+# Template to use for Account tab titles
140140+#
141141+# Default: {{.Account}}
142142+#tab-title-account={{.Account}}
4414345144# Marker to show before a pinned tab's name.
46145#
47146# Default: `
4848-pinned-tab-marker='`'
147147+#pinned-tab-marker='`'
148148+149149+# Template for the left side of the directory list.
150150+# See aerc-templates(7) for all available fields and functions.
151151+#
152152+# Default: {{.Folder}}
153153+#dirlist-left={{.Folder}}
491545050-dirlist-left = {{.Folder}}
5151-dirlist-right = {{if .Unread}}{{humanReadable .Unread}}/{{end}}{{if .Exists}}{{humanReadable .Exists}}{{end}}
155155+# Template for the right side of the directory list.
156156+# See aerc-templates(7) for all available fields and functions.
157157+#
158158+# Default: {{if .Unread}}{{humanReadable .Unread}}/{{end}}{{if .Exists}}{{humanReadable .Exists}}{{end}}
159159+#dirlist-right={{if .Unread}}{{humanReadable .Unread}}/{{end}}{{if .Exists}}{{humanReadable .Exists}}{{end}}
160160+161161+# Delay after which the messages are actually listed when entering a directory.
162162+# This avoids loading messages when skipping over folders and makes the UI more
163163+# responsive. If you do not want that, set it to 0s.
164164+#
165165+# Default: 200ms
166166+#dirlist-delay=200ms
167167+168168+# Display the directory list as a foldable tree that allows to collapse and
169169+# expand the folders.
170170+#
171171+# Default: false
172172+#dirlist-tree=false
173173+174174+# If dirlist-tree is enabled, set level at which folders are collapsed by
175175+# default. Set to 0 to disable.
176176+#
177177+# Default: 0
178178+#dirlist-collapse=0
5217953180# List of space-separated criteria to sort the messages by, see *sort*
54181# command in *aerc*(1) for reference. Prefixing a criterion with "-r "
···56183#
57184# Example: "from -r date"
58185#
5959-# Default: ""
6060-sort="-r date from"
186186+#sort=
6118762188# Moves to next message when the current message is deleted
63189#
64190# Default: true
6565-next-message-on-delete=true
191191+#next-message-on-delete=true
192192+193193+# Automatically set the "seen" flag when a message is opened in the message
194194+# viewer.
195195+#
196196+# Default: true
197197+#auto-mark-read=true
6619867199# The directories where the stylesets are stored. It takes a colon-separated
6868-# list of directories.
200200+# list of directories. If this is unset or if a styleset cannot be found, the
201201+# following paths will be used as a fallback in that order:
69202#
7070-# default: /usr/local/share/aerc/stylesets/
7171-#stylesets-dirs=/usr/local/share/aerc/stylesets/
203203+# ${XDG_CONFIG_HOME:-~/.config}/aerc/stylesets
204204+# ${XDG_DATA_HOME:-~/.local/share}/aerc/stylesets
205205+# /nix/store/bk6874radkd8h2y75rgg8hd267pwhdkl-aerc-0.16.0/share/aerc/stylesets
206206+#
207207+#stylesets-dirs=
208208+209209+# Uncomment to use box-drawing characters for vertical and horizontal borders.
210210+#
211211+# Default: " "
212212+#border-char-vertical=" "
213213+#border-char-horizontal=" "
7221473215# Sets the styleset to use for the aerc ui elements.
74216#
75217# Default: default
7676-styleset-name=default
218218+#styleset-name=default
219219+220220+# Activates fuzzy search in commands and their arguments: the typed string is
221221+# searched in the command or option in any position, and need not be
222222+# consecutive characters in the command or option.
223223+#
224224+# Default: false
225225+#fuzzy-complete=false
226226+227227+# How long to wait after the last input before auto-completion is triggered.
228228+#
229229+# Default: 250ms
230230+#completion-delay=250ms
231231+232232+# The minimum required characters to allow auto-completion to be triggered after
233233+# completion-delay.
234234+#
235235+# Default: 1
236236+#completion-min-chars=1
237237+238238+#
239239+# Global switch for completion popovers
240240+#
241241+# Default: true
242242+#completion-popovers=true
243243+244244+# Uncomment to use UTF-8 symbols to indicate PGP status of messages
245245+#
246246+# Default: ASCII
247247+#icon-unencrypted=
248248+#icon-encrypted=✔
249249+#icon-signed=✔
250250+#icon-signed-encrypted=✔
251251+#icon-unknown=✘
252252+#icon-invalid=⚠
253253+254254+# Reverses the order of the message list. By default, the message list is
255255+# ordered with the newest (highest UID) message on top. Reversing the order
256256+# will put the oldest (lowest UID) message on top. This can be useful in cases
257257+# where the backend does not support sorting.
258258+#
259259+# Default: false
260260+#reverse-msglist-order = false
261261+262262+# Reverse display of the mesage threads. Default order is the the intial
263263+# message is on the top with all the replies being displayed below. The
264264+# reverse option will put the initial message at the bottom with the
265265+# replies on top.
266266+#
267267+# Default: false
268268+#reverse-thread-order=false
269269+270270+# Sort the thread siblings according to the sort criteria for the messages. If
271271+# sort-thread-siblings is false, the thread siblings will be sorted based on
272272+# the message UID in ascending order. This option is only applicable for
273273+# client-side threading with a backend that enables sorting. Note that there's
274274+# a performance impact when sorting is activated.
275275+#
276276+# Default: false
277277+#sort-thread-siblings=false
278278+279279+#[ui:account=foo]
280280+#
281281+# Enable a threaded view of messages. If this is not supported by the backend
282282+# (IMAP server or notmuch), threads will be built by the client.
283283+#
284284+# Default: false
285285+#threading-enabled=false
286286+287287+# Force client-side thread building
288288+#
289289+# Default: false
290290+#force-client-threads=false
291291+292292+# Show thread context enables messages which do not match the current query (or
293293+# belong to the current mailbox) to be shown for context. These messages can be
294294+# styled separately using "msglist_thread_context" in a styleset. This feature
295295+# is not supported by all backends
296296+#
297297+# Default: false
298298+#show-thread-context=false
299299+300300+# Debounce client-side thread building
301301+#
302302+# Default: 50ms
303303+#client-threads-delay=50ms
304304+305305+[statusline]
306306+#
307307+# Describes the format for the status line. This is a comma separated list of
308308+# column names with an optional align and width suffix. See [ui].index-columns
309309+# for more details. To completely mute the status line except for push
310310+# notifications, explicitly set status-columns to an empty string.
311311+#
312312+# Default: left<*,center:=,right>*
313313+#status-columns=left<*,center:=,right>*
314314+315315+#
316316+# Each name in status-columns must have a corresponding column-$name setting.
317317+# All column-$name settings accept golang text/template syntax. See
318318+# aerc-templates(7) for available template attributes and functions.
319319+#
320320+# Default settings
321321+#column-left=[{{.Account}}] {{.StatusInfo}}
322322+#column-center={{.PendingKeys}}
323323+#column-right={{.TrayInfo}}
324324+325325+#
326326+# String separator inserted between columns.
327327+# See [ui].column-separator for more details.
328328+#
329329+#column-separator=" "
330330+331331+# Specifies the separator between grouped statusline elements.
332332+#
333333+# Default: " | "
334334+#separator=" | "
335335+336336+# Defines the mode for displaying the status elements.
337337+# Options: text, icon
338338+#
339339+# Default: text
340340+#display-mode=text
7734178342[viewer]
79343#
···81345# may add ANSI codes to add color to rendered emails, so you may want to use a
82346# pager which supports ANSI codes.
83347#
8484-# Default: less -R
8585-pager=less -R
348348+# Default: less -Rc
349349+#pager=less -Rc
8635087351#
88352# If an email offers several versions (multipart), you can configure which
···90354# html emails.
91355#
92356# Default: text/plain,text/html
9393-alternatives=text/plain,text/html
357357+#alternatives=text/plain,text/html
9435895359#
96360# Default setting to determine whether to show full headers or only parsed
97361# ones in message viewer.
98362#
99363# Default: false
100100-show-headers=false
364364+#show-headers=false
101365102366#
103367# Layout of headers when viewing a message. To display multiple headers in the
···105369# none of their specified headers are present in the message.
106370#
107371# Default: From|To,Cc|Bcc,Date,Subject
108108-header-layout=From|To,Cc|Bcc,Date,Subject
372372+#header-layout=From|To,Cc|Bcc,Date,Subject
109373110374# Whether to always show the mimetype of an email, even when it is just a single part
111375#
112376# Default: false
113113-always-show-mime=false
377377+#always-show-mime=false
114378115115-# How long to wait after the last input before auto-completion is triggered.
116116-#
117117-# Default: 250ms
118118-completion-delay=250ms
119119-120120-#
121121-# Global switch for completion popovers
379379+# Parses and extracts http links when viewing a message. Links can then be
380380+# accessed with the open-link command.
122381#
123382# Default: true
124124-completion-popovers=true
383383+#parse-http-links=true
125384126385[compose]
127386#
128387# Specifies the command to run the editor with. It will be shown in an embedded
129388# terminal, though it may also launch a graphical window if the environment
130389# supports it. Defaults to $EDITOR, or vi.
131131-editor=
390390+#editor=
391391+392392+#
393393+# When set, aerc will create and read .eml files for composing that have
394394+# non-standard \n linebreaks. This is only relevant if the used editor does not
395395+# support CRLF linebreaks.
396396+#
397397+#lf-editor=false
132398133399#
134400# Default header fields to display when composing a message. To display
135401# multiple headers in the same row, separate them with a pipe, e.g. "To|From".
136402#
137403# Default: To|From,Subject
138138-header-layout=To|From,Subject
404404+#header-layout=To|From,Subject
405405+406406+#
407407+# Edit headers into the text editor instead than separate fields.
408408+#
409409+# When this is true, address-book-cmd is not supported and address completion
410410+# is left to the editor itself. Also, displaying multiple headers on the same
411411+# line is not possible.
412412+#
413413+# Default: false
414414+#edit-headers=false
139415140416#
141417# Specifies the command to be used to tab-complete email addresses. Any
···147423# the first field. Only the email address field is required. The second field,
148424# if present, will be treated as the contact name. Additional fields are
149425# ignored.
150150-address-book-cmd=
426426+#
427427+# This parameter can also be set per account in accounts.conf.
428428+#address-book-cmd=
429429+430430+# Specifies the command to be used to select attachments. Any occurrence of
431431+# '%s' in the file-picker-cmd will be replaced with the argument <arg>
432432+# to :attach -m <arg>. Any occurence of '%f' will be replaced by the
433433+# location of a temporary file, from which aerc will read the selected files.
434434+#
435435+# If '%f' is not present, the command must output the selected files to
436436+# standard output, one file per line. If it is present, then aerc does not
437437+# capture the standard output and instead reads the files from the temporary
438438+# file which should have the same format.
439439+#file-picker-cmd=
440440+441441+#
442442+# Allow to address yourself when replying
443443+#
444444+# Default: true
445445+#reply-to-self=true
446446+447447+# Warn before sending an email with an empty subject.
448448+#
449449+# Default: false
450450+#empty-subject-warning=false
451451+452452+#
453453+# Warn before sending an email that matches the specified regexp but does not
454454+# have any attachments. Leave empty to disable this feature.
455455+#
456456+# Uses Go's regexp syntax, documented at https://golang.org/s/re2syntax. The
457457+# "(?im)" flags are set by default (case-insensitive and multi-line).
458458+#
459459+# Example:
460460+# no-attachment-warning=^[^>]*attach(ed|ment)
461461+#
462462+#no-attachment-warning=
463463+464464+#
465465+# When set, aerc will generate "format=flowed" bodies with a content type of
466466+# "text/plain; format=flowed" as described in RFC3676. This format is easier to
467467+# handle for some mailing software, and generally just looks like ordinary
468468+# text. To actually make use of this format's features, you'll need support in
469469+# your editor.
470470+#
471471+#format-flowed=false
472472+473473+[multipart-converters]
474474+#
475475+# Converters allow to generate multipart/alternative messages by converting the
476476+# main text/plain part into any other MIME type. Only exact MIME types are
477477+# accepted. The commands are invoked with sh -c and are expected to output
478478+# valid UTF-8 text.
479479+#
480480+# Example (obviously, this requires that you write your main text/plain body
481481+# using the markdown syntax):
482482+#text/html=pandoc -f markdown -t html --standalone
151483152484[filters]
153485#
154486# Filters allow you to pipe an email body through a shell command to render
155487# certain emails differently, e.g. highlighting them with ANSI escape codes.
156488#
489489+# The commands are invoked with sh -c. The following folders are prepended to
490490+# the system $PATH to allow referencing filters from their name only:
491491+#
492492+# ${XDG_CONFIG_HOME:-~/.config}/aerc/filters
493493+# ~/.local/libexec/aerc/filters
494494+# ${XDG_DATA_HOME:-~/.local/share}/aerc/filters
495495+# $PREFIX/libexec/aerc/filters
496496+# $PREFIX/share/aerc/filters
497497+# /usr/libexec/aerc/filters
498498+# /usr/share/aerc/filters
499499+#
500500+# If you want to run a program in your default $PATH which has the same name
501501+# as a builtin filter (e.g. /usr/bin/colorize), use its absolute path.
502502+#
503503+# The following variables are defined in the filter command environment:
504504+#
505505+# AERC_MIME_TYPE the part MIME type/subtype
506506+# AERC_FORMAT the part content type format= parameter
507507+# AERC_FILENAME the attachment filename (if any)
508508+# AERC_SUBJECT the message Subject header value
509509+# AERC_FROM the message From header value
510510+#
157511# The first filter which matches the email's mimetype will be used, so order
158512# them from most to least specific.
159513#
160514# You can also match on non-mimetypes, by prefixing with the header to match
161515# against (non-case-sensitive) and a comma, e.g. subject,text will match a
162516# subject which contains "text". Use header,~regex to match against a regex.
163163-#>>>subject,~^\[PATCH=awk -f /usr/lib/aerc/filters/hldiff
164164-#text/html=/usr/local/share/aerc/filters/html
165165-#>>>text/*=awk -f /usr/lib/aerc/filters/plaintext
517517+#
518518+text/plain=colorize
519519+text/calendar=calendar
520520+message/delivery-status=colorize
521521+message/rfc822=colorize
522522+#text/html=pandoc -f html -t plain | colorize
523523+#text/html=html | colorize
524524+#text/*=bat -fP --file-name="$AERC_FILENAME"
525525+#application/x-sh=bat -fP -l sh
166526#image/*=catimg -w $(tput cols) -
527527+#subject,~Git(hub|lab)=lolcat -f
528528+#from,thatguywhodoesnothardwraphismessages=wrap -w 100 | colorize
167529168168-[triggers]
530530+# This special filter is only used to post-process email headers when
531531+# [viewer].show-headers=true
532532+# By default, headers are piped directly into the pager.
169533#
170170-# Triggers specify commands to execute when certain events occur.
534534+.headers=colorize
535535+536536+[openers]
171537#
172172-# Example:
173173-# new-email=exec notify-send "New email from %n" "%s"
538538+# Openers allow you to specify the command to use for the :open and :open-link
539539+# actions on a per-MIME-type basis. The :open-link URL scheme is used to
540540+# determine the MIME type as follows: x-scheme-handler/<scheme>.
541541+#
542542+# {} is expanded as the temporary filename to be opened. If it is not
543543+# encountered in the command, the temporary filename will be appened to the end
544544+# of the command.
545545+#
546546+# Like [filters], openers support basic shell globbing. The first opener which
547547+# matches the part's MIME type (or URL scheme handler MIME type) will be used,
548548+# so order them from most to least specific.
549549+#
550550+# Examples:
551551+# x-scheme-handler/irc=hexchat
552552+# x-scheme-handler/http*=firefox
553553+# text/html=surf -dfgms
554554+# text/plain=gvim {} +125
555555+# message/rfc822=thunderbird
556556+557557+[hooks]
558558+#
559559+# Hooks are triggered whenever the associated event occurs.
174560175561#
176562# Executed when a new email arrives in the selected folder
177177-new-email=
563563+#mail-received=notify-send "[$AERC_ACCOUNT/$AERC_FOLDER] New mail from $AERC_FROM_NAME" "$AERC_SUBJECT"
564564+565565+#
566566+# Executed when aerc starts
567567+#aerc-startup=aerc :terminal calcurse && aerc :next-tab
568568+569569+#
570570+# Executed when aerc shuts down.
571571+#aerc-shutdown=
178572179573[templates]
180574# Templates are used to populate email bodies automatically.
181575#
182576183577# The directories where the templates are stored. It takes a colon-separated
184184-# list of directories.
578578+# list of directories. If this is unset or if a template cannot be found, the
579579+# following paths will be used as a fallback in that order:
580580+#
581581+# ${XDG_CONFIG_HOME:-~/.config}/aerc/templates
582582+# ${XDG_DATA_HOME:-~/.local/share}/aerc/templates
583583+# /nix/store/bk6874radkd8h2y75rgg8hd267pwhdkl-aerc-0.16.0/share/aerc/templates
584584+#
585585+#template-dirs=
586586+587587+# The default template to be used for new messages.
185588#
186186-# default: /usr/local/share/aerc/templates/
187187-#template-dirs=/usr/local/share/aerc/templates/
589589+# default: new_message
590590+#new-message=new_message
188591189189-# The template to be used for quoted replies.
592592+# The default template to be used for quoted replies.
190593#
191594# default: quoted_reply
192192-quoted-reply=quoted_reply
595595+#quoted-reply=quoted_reply
193596194194-# The template to be used for forward as body.
597597+# The default template to be used for forward as body.
195598#
196599# default: forward_as_body
197197-forwards=forward_as_body
600600+#forwards=forward_as_body