45bff88515
Instead of xdg-open (or open on MacOS), allow forcing a program to open
a message part. The program is determined in that order of priority:
1) If :open has arguments, they will be used as command to open the
attachment. If the arguments contain the {} placeholder, the
temporary file will be substituted, otherwise the file path is added
at the end of the arguments.
2) If a command is specified in the [openers] section of aerc.conf for
the part MIME type, then it is used with the same rules of {}
substitution.
3) Finally, fallback to xdg-open/open with the file path as argument.
Update the docs and default config accordingly with examples.
Fixes: https://todo.sr.ht/~rjarry/aerc/64
Co-authored-by: Jason Stewart <support@eggplantsd.com>
Signed-off-by: Robin Jarry <robin@jarry.cc>
Tested-by: Tim Culverhouse <tim@timculverhouse.com>
Acked-by: Moritz Poldrack <moritz@poldrack.dev>
365 lines
9.4 KiB
Text
365 lines
9.4 KiB
Text
#
|
|
# 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
|
|
|
|
[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
|
|
|
|
# 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
|
|
|
|
#
|
|
# 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=⚠
|
|
|
|
#[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
|
|
|
|
[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 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.
|
|
#subject,~^\[PATCH=colordiff
|
|
text/plain=sed 's/^>\+.*/\x1b[36m&\x1b[0m/'
|
|
#text/html=pandoc -f html -t plain
|
|
#text/html=w3m -dump -I UTF-8 -T text/html
|
|
#image/*=catimg -w $(tput cols) -
|
|
|
|
[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
|