AERC-CONFIG(5) File Formats Manual AERC-CONFIG(5) (NAME) aerc-config - aerc (SYNOPSIS) aerc : aerc.conf binds.conf accounts.conf. . XDG aerc ~/.config/aerc . aerc(1) . aerc /usr/share/aerc . ini . # . [section-name] = . aerc.conf . binds.conf aerc-binds(5) accounts.conf aerc-accounts(5) . aerc.conf aerc . (GENERAL OPTIONS) [general] aerc.conf . default-save-path = . pgp-provider = auto|gpg|internal gpg aerc gpg . internal openpgp . auto gpg . : auto use-terminal-pinentry = true|false pinentry ( pinentry-tty pinentry-curses pinentry- vaxis) aerc(1) true . aerc(1) tty . aerc(1) GPG_TTY tty(1) GnuPG GPG-agent . : GPG_TTY=$(tty) export GPG_TTY : false unsafe-accounts-conf = true|false accounts.conf (0600). true . . : false log-file = . ~/ . aerc > stdout . log-level = trace|debug|info|warn|error log-file . : trace debug info warn error. aerc > trace . : info disable-ipc = true|false IPC. ( mailto:... mbox...) aerc IPC aerc . : false disable-ipc-mailto = true | false mailto:... IPC aerc . : false disable-ipc-mbox = true | false mbox:... IPC aerc mbox . : false term = $TERM . : xterm-256color enable-osc8 = true|false OSC 8 () . OSC 8 . : false enable-quake-mode = true|false Quake aerc . F1 . Quake . : false default-menu-cmd = :menu. sh -c (popover) . %f :menu . . : default-menu-cmd = fzf (UI OPTIONS) [ui] aerc.conf . index-columns = . . < () : () > () ( ) . 1% 99% . * () = () . . . * . : flags:4,name<20%,subject,date>= column-separator = "" . ( ). : " " column- = index-columns column- . column- (golang text/template) . : column-flags = {{.Flags | join ""}} column-name = {{index (.From | names) 0}} column-subject = {{.ThreadPrefix}}{{.Subject}} column-date = {{.DateAutoFormat .Date.Local}} aerc-templates(7) . timestamp-format = time.Time#Format https://godoc.org/time#Time.Format : 2006 Jan 02 this-day-time-format = - / . timestamp-format . : 15:04 this-week-time-format = - / . timestamp-format . : Jan 02 this-year-time-format = - / . timestamp-format . : Jan 02 message-view-timestamp-format = timestamp-format . : 2006 Jan 02, 15:04 GMT-0700 message-view-this-day-time-format = timestamp-format / . message-view-this-week-time-format = timestamp-format / . message-view-this-year-time-format = timestamp-format / . sidebar-width = . . : 22 message-list-split = [] . horizontal . : h horiz horizontal v vert vertical. ( ) . :split aerc(1) . empty-message = . : (no messages) empty-dirlist = . : (no folders) empty-subject = . : (no subject) mouse-enabled = true|false : false new-message-bell = true|false . : true tab-title-account = . aerc-templates(7) . : tab-title-account = {{.Account}} {{if .Unread}}({{.Unread}}){{end}} : {{.Account}} tab-title-composer = . aerc-templates(7) . : {{if .To}}to:{{index (.To | shortmboxes) 0}} {{end}}{{.SubjectBase}} tab-title-terminal = . aerc-templates(7) . [ui] . : {{.Title}} tab-title-viewer = . aerc-templates(7) . : {{.Subject}} pinned-tab-marker = "" . : ` spinner = "" spinner-delimiter ( ) : o spinner = "-_-,_-_" o spinner = '. , .' o spinner = ",|,/,-" : "[..] , [..] , [..] , [..] , [..], [..] , [..] , [..] " spinner-delimiter = () : , spinner-interval = : 200ms sort = :sort aerc(1) . -r . : sort = from -r date dirlist-left = . aerc-templates(7) . : {{.Folder}} dirlist-right = . aerc-templates(7) . : {{if .Unread}}{{humanReadable .Unread}}{{end}} dirlist-delay = . . 0s . : 200ms dirlist-tree = true|false . : false dirlist-collapse = dirlist-tree () . 0 . : 0 next-message-on-delete = true|false . : true auto-mark-read = true|false seen . : true auto-mark-read-split = true|false true auto-mark-read-split-delay seen true . : false auto-mark-read-split-delay = auto-mark-read-split true seen . : 3s completion-popovers = true|false (popovers) . : true completion-delay = . : 250ms completion-min-chars = completion-delay. manual $complete ( aerc-binds(5) ). : 1 border-char-vertical = "" border-char-horizontal = "" ( border) . : " " stylesets-dirs = . . : ${XDG_CONFIG_HOME:-~/.config}/aerc/stylesets ${XDG_DATA_HOME:-~/.local/share}/aerc/stylesets /usr/local/share/aerc/stylesets /usr/share/aerc/stylesets styleset-name = . stylesets . . . : default aerc-stylesets(7) . icon-unencrypted = . . icon-encrypted = . : [e] icon-signed = . : [s] icon-signed-encrypted = . . icon-unknown = . : [s?] icon-invalid = . : [s!] icon-attachment = column-flags . : a icon-new = column-flags . : N icon-old = column-flags . : O icon-replied = column-flags . : r icon-forwarded = column-flags () . : f icon-flagged = column-flags . : ! icon-marked = column-flags . : * icon-draft = column-flags . : d icon-deleted = column-flags . : X fuzzy-complete = true|false / / // . reverse-msglist-order = true|false . ( UID) . ( UID) . . : false reverse-thread-order = true|false (threads) . . . : false select-last-message = true|false ( ) . : false sort-thread-siblings = true|false sort . sort-thread-siblings false UID . false threading-by-subject true UTF-8 . . . : false threading-enabled = true|false . ( IMAP notmuch) . : false force-client-threads = true|false . . : false threading-by-subject = true|false References In-Reply-To . sort-thread-siblings false . : false client-threads-delay = . 0s . : 50ms show-thread-context = true|false . : . : false msglist-scroll-offset = . : 0 dialog-position = top|center|bottom (popovers) :menu :envelope :attach -m . : center dialog-width = . 10% 100% . : 50 dialog-height = . 10% 100% . : 50 quake-terminal-height = . : 20 (THREAD PREFIX CUSTOMIZATION) : thread-prefix-tip = . : ">" thread-prefix-indent = . : " " thread-prefix-stem = () . : "|" thread-prefix-limb = () . : "" thread-prefix-folded = () . : "+" thread-prefix-unfolded = . : "" thread-prefix-first-child = . : "" thread-prefix-has-siblings = . : thread-prefix-lone = . : "" thread-prefix-orphan = . : "" thread-prefix-last-sibling = . : thread-prefix-last-sibling-reverse = . : thread-prefix-dummy = (dummy head) . : thread-prefix-dummy-reverse = . : thread-prefix-first-child-reverse = . : "" thread-prefix-orphan-reverse = . : "" ( mutt): [PATCH aerc v5] ui: allow thread arrow customisation >[aerc/patches] build success >Re: [PATCH aerc v5] ui: allow thread arrow customisation + > > | > | > | > > : [PATCH aerc v5] ui: allow thread arrow customisation [aerc/patches] build success Re: [PATCH aerc v5] ui: allow thread arrow customisation + | | | thread-prefix-tip = "" thread-prefix-indent = "" thread-prefix-stem = "|" thread-prefix-limb = "" thread-prefix-folded = "+" thread-prefix-unfolded = "" thread-prefix-first-child = "" thread-prefix-has-siblings = "" thread-prefix-orphan = "" thread-prefix-dummy = "" thread-prefix-lone = " " thread-prefix-last-sibling = "" (CONTEXTUAL UI CONFIGURATION) . . UiConfig : Base UIConfig > Account Context > Folder Context. [ui:account=AccountName] . [ui:folder=FolderName] . [ui:folder~Regex] . : [ui:account=Work] sidebar-width=... [ui:folder=Sent] index-format=... [ui:folder~Archive/d+/.*] index-format=... (STATUSLINE) [statusline] aerc.conf . status-columns = . . [ui].index- columns . ( push) status-columns : status-columns= : left<*,center>=,right>* column-separator = "" . [ui].column- separator . : " " column- = status-columns column- . column- text/template golang . : column-left = [{{.Account}}] {{.StatusInfo}} column-center = {{.PendingKeys}} column-right = {{.TrayInfo}} | {{cwd}} aerc-templates(7) . separator = "" ( {{.ContentInfo}} {{.TrayInfo}} {{.StatusInfo}} column-). : " | " display-mode = text|icon . : text (VIEWER) [viewer] aerc.conf . pager = (pager) . ANSI pager ANSI . : less -Rc alternatives = ( multipart) (mimetype) . HTML . : text/plain,text/html header-layout = . From|To. . Notmuch Labels . Authentication-Results DKIM SPF DMARC . (+) ( DKIM+). : From|To,Cc|Bcc,Date,Subject show-headers = true|false . : false always-show-mime = true|false (mimetype) . : false max-mime-height = height (scrollbar) . . . : 0 parse-http-links = true|false http . open- link . : true (COMPOSE) [compose] aerc.conf . editor = . . : AERC_ACCOUNT AERC_ADDRESS_BOOK_CMD address-book-cmd accounts.conf $VISUAL $EDITOR vi(1) . header-layout = . To|From. : To|From,Subject edit-headers = true|false . true :cc :bcc :header . address-book-cmd . header-layout . : false focus-body = true|false . : false address-book-cmd = (tab- complete) . %s address-book-cmd . . . . . . accounts.conf . carddav-query(1): address-book-cmd = carddav-query %s khard(1): address-book-cmd = khard email --remove-first-line --parsable %s file-picker-cmd = . %s file-picker-cmd :attach -m . %f aerc . %f . aerc . : file-picker-cmd = fzf --multi --query=%s file-picker-cmd = ranger --choose-files=%f reply-to-self = true|false false ( To Cc ). : true empty-subject-warning = true|false . : false no-attachment-warning = . aerc . . Go https://golang.org/s/re2syntax . (?im) ( ). : no-attachment-warning = ^[^>]*attach(ed|ment) format-flowed = true|false aerc Format=Flowed "text/plain; Format=Flowed" RFC3676 . . . : false lf-editor = true|false aerc RFC2822 \r\n (CRLF) . \n (LF) . : false (MULTIPART CONVERTERS) multipart/alternative text/plain MIME :multipart . MIME . sh -c UTF-8 . MIME text/ . MIME text/plain . . [multipart-converters] aerc.conf . : [multipart-converters] text/html=pandoc -f markdown -t html --standalone text/plain markdown . text/html . . (FILTERS) . aerc MIME MIME ( ). pager aerc . [filters] aerc.conf . MIME . MIME ( ) subject,text text . header,~regex regex . .filename . aerc . - stdin . | . . ! pager . . TTY . . aerc libexec ( /usr/libexec/aerc/filters). aerc . sh -c command . $PATH . ${XDG_CONFIG_HOME:-~/.config}/aerc/filters ~/.local/libexec/aerc/filters ${XDG_DATA_HOME:-~/.local/share}/aerc/filters $PREFIX/libexec/aerc/filters $PREFIX/share/aerc/filters /usr/libexec/aerc/filters /usr/share/aerc/filters $PATH ( /usr/bin/colorize) . : AERC_MIME_TYPE / MIME AERC_FORMAT format= content type ( format=flowed) AERC_FILENAME ( ) AERC_SUBJECT Subject AERC_FROM From UTF-8 . show-headers . .headers . (EXAMPLES) text/plain git : text/plain=colorize colorize [viewer] styleset . aerc-stylesets(7) . . format=flowed : text/plain=wrap -w 100 | colorize from, . . : from,thatguywhoneverhardwrapshismessages=wrap -r -w 72 | colorize subject,~ lolcat(1) (software forges): subject,~Git(hub|lab)=lolcat -f text/html html : text/html=html | colorize pandoc : text/html=pandoc -f html -t plain w3m HTML : text/html=! w3m -I UTF-8 -T text/html img2sixel(1) sixel html-unsafe ( ) sixel . text/html=! html-unsafe -sixel text/calendar : text/calendar=calendar text/* bat(1) : text/*=bat -fP --file-name="$AERC_FILENAME" --style=plain .headers show-headers true . .headers=colorize message/delivery-status : message/delivery-status=colorize message/rfc822 (digest) . caeml(1) PATH : message/rfc822=caeml | colorize https://github.com/ferdinandyb/caeml application/mbox mbox. aerc :pipe mbox . catbox(1) caeml(1) PATH : application/mbox=catbox -c caeml | colorize https://github.com/konimarti/catbox application/pdf pdf . pdftotext(1) PATH : application/pdf=pdftotext - -l 10 -nopgbrk -q - | fmt -w 100 https://www.xpdfreader.com/pdftotext-man.html image/* . sixel kitty . aerc ( TUI Vaxis) . Vaxis sixel kitty . (no- op) . catimg(1): image/*=catimg -w$(tput cols) - .filename,~ csv : .filename,~.*.csv=column -t --separator="," https://man.sr.ht/~rjarry/aerc . (OPENERS) :open :open-link MIME . (URL scheme) :open-link MIME : x-scheme- handler/. [openers] aerc.conf . {} . . sh -c . [filters] (shell globbing) . MIME ( MIME ) . : [openers] x-scheme-handler/irc=hexchat x-scheme-handler/http*=printf '%s' {} | wl-copy text/html=surf -dfgms text/plain=gvim {} +125 message/rfc822=thunderbird (HOOKS) . . [hooks] aerc.conf . aerc-startup = aerc . . : o AERC_VERSION o AERC_BINARY : aerc-startup = aerc :terminal calcurse && aerc :next-tab mail-received = . maildir imap . : o AERC_ACCOUNT o AERC_ACCOUNT_BACKEND o AERC_FOLDER o AERC_FOLDER_ROLE o AERC_FROM_NAME o AERC_FROM_ADDRESS o AERC_SUBJECT o AERC_MESSAGE_ID : mail-received = notify-send "[$AERC_ACCOUNT/$AERC_FOLDER] New mail from $AERC_FROM_NAME" "$AERC_SUBJECT" mail-deleted = . . : o AERC_ACCOUNT o AERC_ACCOUNT_BACKEND o AERC_FOLDER o AERC_FOLDER_ROLE : mail-deleted = mbsync "$AERC_ACCOUNT:$AERC_FOLDER" mail-added = . ( mail-received ) aerc . : o AERC_ACCOUNT o AERC_ACCOUNT_BACKEND o AERC_FOLDER o AERC_FOLDER_ROLE : mail-added = mbsync "$AERC_ACCOUNT:$AERC_FOLDER" mail-sent = . msmtpq . : o AERC_ACCOUNT o AERC_ACCOUNT_BACKEND o AERC_FROM_NAME o AERC_FROM_ADDRESS o AERC_SUBJECT o AERC_TO o AERC_CC : mail-sent = if [ "$AERC_ACCOUNT" = "gmail" ]; then mbsync gmail; fi aerc-shutdown = aerc . aerc . : o AERC_LIFETIME tag-modified = notmuch notmuch . . : o AERC_ACCOUNT o AERC_ACCOUNT_BACKEND o AERC_TAG_ADDED o AERC_TAG_REMOVED flag-changed = . : o AERC_ACCOUNT o AERC_ACCOUNT_BACKEND o AERC_FOLDER o AERC_FOLDER_ROLE o AERC_FLAG : flag-changed = mbsync "$AERC_ACCOUNT:$AERC_FOLDER" (TEMPLATES) . :compose :reply :forward -T . aerc-templates(7) . aerc ( /usr/share/aerc/templates) . [templates] aerc.conf . template-dirs = . (:) . : ${XDG_CONFIG_HOME:-~/.config}/aerc/templates ${XDG_DATA_HOME:-~/.local/share}/aerc/templates /usr/local/share/aerc/templates /usr/share/aerc/templates new-message = . : new_message quoted-reply = . : quoted_reply forwards = (forward as body). : forward_as_body (SEE ALSO) aerc(1) aerc-accounts(5) aerc-binds(5) aerc-imap(5) aerc-jmap(5) aerc- maildir(5) aerc-notmuch(5) aerc-templates(7) aerc-sendmail(5) aerc- smtp(5) aerc-stylesets(7) carddav-query(1) (AUTHORS) Drew DeVault Robin Jarry . aerc https://sr.ht/~rjarry/aerc . 2025-08-29 AERC-CONFIG(5)