# # aerc main configuration [general] # # Used as a default path for save operations if no other path is specified. # ~ is expanded to the current user home dir. # # Default: "" #default-save-path=~/tmp # # If set to "gpg", aerc will use system gpg binary and keystore for all crypto # operations. Otherwise, the internal openpgp implementation will be used. # # Default: internal pgp-provider=internal # By default, the file permissions of accounts.conf must be restrictive and # only allow reading by the file owner (0600). Set this option to true to # ignore this permission check. Use this with care as it may expose your # credentials. # # Default: false unsafe-accounts-conf=false # Output log messages to specified file. A path starting with ~/ is expanded to # the user home dir. When redirecting aerc's output to a file using > shell # redirection, this setting is ignored and log messages are printed to stdout. # # Default: "" #log-file= # Only log messages above the specified level to log-file. Supported levels # are: debug, info, warn and error. When redirecting aerc's output to a file # using > shell redirection, this setting is ignored and the log level is # forced to debug. # # Default: info #log-level=info [ui] # # Describes the format for each row in a mailbox view. This field is compatible # with mutt's printf-like syntax. # # Default: %-20.20D %-17.17n %Z %s index-format=%-20.20D %-17.17n %Z %s # # See time.Time#Format at https://godoc.org/time#Time.Format # # Default: 2006-01-02 03:04 PM (ISO 8601 + 12 hour time) timestamp-format=2006-01-02 03:04 PM # # Index-only time format for messages that were received/sent today. # If this is not specified, timestamp-format is used instead. # # Default: "" #this-day-time-format=03:04 PM # # Index-only time format for messages that were received/sent within the last # 7 days. If this is not specified, timestamp-format is used instead. # # Default: "" #this-week-time-format=Monday 03:04 PM # # Index-only time format for messages that were received/sent this year. # If this is not specified, timestamp-format is used instead. # # Default: "" #this-year-time-format=January 02 # # Width of the sidebar, including the border. # # Default: 20 sidebar-width=20 # # Message to display when viewing an empty folder. # # Default: (no messages) empty-message=(no messages) # Message to display when no folders exists or are all filtered # # Default: (no folders) empty-dirlist=(no folders) # Enable mouse events in the ui, e.g. clicking and scrolling with the mousewheel # # Default: false mouse-enabled=false # # Ring the bell when new messages are received # # Default: true new-message-bell=true # Marker to show before a pinned tab's name. # # Default: ` pinned-tab-marker='`' # Describes the format string to use for the directory list # # Default: %n %>r dirlist-format=%n %>r # Delay after which the messages are actually listed when entering a directory. # This avoids loading messages when skipping over folders and makes the UI more # responsive. If you do not want that, set it to 0s. # # Default: 200ms dirlist-delay=200ms # Display the directory list as a foldable tree that allows to collapse and # expand the folders. # # Default: false dirlist-tree=false # If dirlist-tree is enabled, set level at which folders are collapsed by # default. Set to 0 to disable. # # Default: 0 dirlist-collapse=0 # List of space-separated criteria to sort the messages by, see *sort* # command in *aerc*(1) for reference. Prefixing a criterion with "-r " # reverses that criterion. # # Example: "from -r date" # # Default: "" sort= # Moves to next message when the current message is deleted # # Default: true next-message-on-delete=true # Automatically set the "seen" flag when a message is opened in the message # viewer. # # Default: true auto-mark-read=true # The directories where the stylesets are stored. It takes a colon-separated # list of directories. If this is unset or if a styleset cannot be found, the # following paths will be used as a fallback in that order: # # ${XDG_CONFIG_HOME:-~/.config}/aerc/stylesets # ${XDG_DATA_HOME:-~/.local/share}/aerc/stylesets # /usr/local/share/aerc/stylesets # /usr/share/aerc/stylesets # # default: "" stylesets-dirs= # Uncomment to use box-drawing characters for vertical and horizontal borders. # # Default: spaces # border-char-vertical=│ # border-char-horizontal=─ # Sets the styleset to use for the aerc ui elements. # # Default: default styleset-name=default # Activates fuzzy search in commands and their arguments: the typed string is # searched in the command or option in any position, and need not be # consecutive characters in the command or option. #fuzzy-complete=false # How long to wait after the last input before auto-completion is triggered. # # Default: 250ms completion-delay=250ms # The minimum required characters to allow auto-completion to be triggered after # completion-delay. # # Default: 1 #completion-min-chars=1 # # Global switch for completion popovers # # Default: true completion-popovers=true # Uncomment to use UTF-8 symbols to indicate PGP status of messages # # Default: ASCII #icon-unencrypted= #icon-encrypted=✔ #icon-signed=✔ #icon-signed-encrypted=✔ #icon-unknown=✘ #icon-invalid=⚠ # # Reverses the order of the message list. By default, the message list is # ordered with the newest (highest UID) message on top. Reversing the order # will put the oldest (lowest UID) message on top. This can be useful in cases # where the backend does not support sorting. # # Default: false #reverse-msglist-order = false # Reverse display of the mesage threads. Default order is the the intial # message is on the top with all the replies being displayed below. The # reverse option will put the initial message at the bottom with the # replies on top. # # Default: false #reverse-thread-order=false # Sort the thread siblings according to the sort criteria for the messages. If # sort-thread-siblings is false, the thread siblings will be sorted based on # the message UID in ascending order. This option is only applicable for # client-side threading with a backend that enables sorting. Note that there's # a performance impact when sorting is activated. # # Default: false #sort-thread-siblings=false #[ui:account=foo] # # Enable a threaded view of messages. If this is not supported by the backend # (IMAP server or notmuch), threads will be built by the client. # # Default: false #threading-enabled=false # Force client-side thread building # # Default: false #force-client-threads=false # Debounce client-side thread building # # Default: 50ms #client-threads-delay=50ms [statusline] # Describes the format string for the statusline. # # Default: [%a] %S %>%T render-format=[%a] %S %>%T # Specifies the separator between grouped statusline elements. # # Default: " | " # separator= # Defines the mode for displaying the status elements. # Options: text, icon # # Default: text # display-mode= [viewer] # # Specifies the pager to use when displaying emails. Note that some filters # may add ANSI codes to add color to rendered emails, so you may want to use a # pager which supports ANSI codes. # # Default: less -R pager=less -R # # If an email offers several versions (multipart), you can configure which # mimetype to prefer. For example, this can be used to prefer plaintext over # html emails. # # Default: text/plain,text/html alternatives=text/plain,text/html # # Default setting to determine whether to show full headers or only parsed # ones in message viewer. # # Default: false show-headers=false # # Layout of headers when viewing a message. To display multiple headers in the # same row, separate them with a pipe, e.g. "From|To". Rows will be hidden if # none of their specified headers are present in the message. # # Default: From|To,Cc|Bcc,Date,Subject header-layout=From|To,Cc|Bcc,Date,Subject # Whether to always show the mimetype of an email, even when it is just a single part # # Default: false always-show-mime=false # Parses and extracts http links when viewing a message. Links can then be # accessed with the open-link command. # # Default: true parse-http-links=true [compose] # # Specifies the command to run the editor with. It will be shown in an embedded # terminal, though it may also launch a graphical window if the environment # supports it. Defaults to $EDITOR, or vi. editor= # # Default header fields to display when composing a message. To display # multiple headers in the same row, separate them with a pipe, e.g. "To|From". # # Default: To|From,Subject header-layout=To|From,Subject # # Specifies the command to be used to tab-complete email addresses. Any # occurrence of "%s" in the address-book-cmd will be replaced with what the # user has typed so far. # # The command must output the completions to standard output, one completion # per line. Each line must be tab-delimited, with an email address occurring as # the first field. Only the email address field is required. The second field, # if present, will be treated as the contact name. Additional fields are # ignored. # # This parameter can also be set per account in accounts.conf. address-book-cmd= # # Allow to address yourself when replying # # Default: true reply-to-self=true # # Warn before sending an email that matches the specified regexp but does not # have any attachments. Leave empty to disable this feature. # # Uses Go's regexp syntax, documented at https://golang.org/s/re2syntax. The # "(?im)" flags are set by default (case-insensitive and multi-line). # # Example: # no-attachment-warning=^[^>]*attach(ed|ment) # no-attachment-warning= [filters] # # Filters allow you to pipe an email body through a shell command to render # certain emails differently, e.g. highlighting them with ANSI escape codes. # # The commands are invoked with sh -c. The following folders are appended to # the system $PATH to allow referencing filters from their name only: # # ${XDG_CONFIG_HOME:-~/.config}/aerc/filters # ${XDG_DATA_HOME:-~/.local/share}/aerc/filters # $PREFIX/share/aerc/filters # /usr/share/aerc/filters # # The following variables are defined in the filter command environment: # # AERC_MIME_TYPE the part MIME type/subtype # AERC_FORMAT the part content type format= parameter # AERC_FILENAME the attachment filename (if any) # AERC_SUBJECT the message Subject header value # AERC_FROM the message From header value # # The first filter which matches the email's mimetype will be used, so order # them from most to least specific. # # You can also match on non-mimetypes, by prefixing with the header to match # against (non-case-sensitive) and a comma, e.g. subject,text will match a # subject which contains "text". Use header,~regex to match against a regex. # text/plain=colorize text/calendar=calendar message/delivery-status=colorize message/rfc822=colorize #text/html=pandoc -f html -t plain | colorize #text/html=html | colorize #text/*=bat -fP --file-name="$AERC_FILENAME" #application/x-sh=bat -fP -l sh #image/*=catimg -w $(tput cols) - #subject,~Git(hub|lab)=lolcat -f #from,thatguywhodoesnothardwraphismessages=fmt -w 72 | colorize [openers] # # Openers allow you to specify the command to use for the :open action on a # per-MIME-type basis. # # {} is expanded as the temporary filename to be opened. If it is not # encountered in the command, the temporary filename will be appened to the end # of the command. # # Examples: # text/html=surf -dfgms # text/plain=gvim {} +125 # message/rfc822=thunderbird [triggers] # # Triggers specify commands to execute when certain events occur. # # Example: # new-email=exec notify-send "New email from %n" "%s" # # Executed when a new email arrives in the selected folder new-email= [templates] # Templates are used to populate email bodies automatically. # # The directories where the templates are stored. It takes a colon-separated # list of directories. If this is unset or if a template cannot be found, the # following paths will be used as a fallback in that order: # # ${XDG_CONFIG_HOME:-~/.config}/aerc/templates # ${XDG_DATA_HOME:-~/.local/share}/aerc/templates # /usr/local/share/aerc/templates # /usr/share/aerc/templates # # default: "" template-dirs= # The default template to be used for new messages. # # default: new_message new-message=new_message # The default template to be used for quoted replies. # # default: quoted_reply quoted-reply=quoted_reply # The default template to be used for forward as body. # # default: forward_as_body forwards=forward_as_body