AERC-IMAP(5) | File Formats Manual | AERC-IMAP(5) |
aerc-imap - IMAP configuration for aerc(1)
aerc implements the IMAP protocol as specified by RFC 3501, with the following IMAP extensions:
IMAP configuration may be done interactively with the :new-account command.
In accounts.conf (see aerc-accounts(5)), the following IMAP-specific options are available:
source = <scheme>://<username>[:<password>]@<hostname>[:<port>]?[<oauth2_params>]
Possible values of <scheme> are:
imap
imap+insecure
imaps
imaps+oauthbearer
<oauth2_params>:
If specified and a token_endpoint is provided, the configured password is used as a refresh token to obtain an access token. If token_endpoint is omitted, refresh token exchange is skipped, and the password acts like an access token instead.
Example:
imaps+xoauth2
source-cred-cmd = <command>
Example:
connection-timeout = <duration>
Default: 30s
keepalive-period = <duration>
By default, the system tcp socket settings are used.
keepalive-probes = <int>
By default, the system tcp socket settings are used. If keepalive-period is specified, this option defaults to 3 probes.
This option is only supported on linux. On other platforms, it will be ignored.
keepalive-interval = <duration>
By default, the system tcp socket settings are used. If keepalive-period is specified, this option defaults to 3s.
This option is only supported on linux. On other platforms, it will be ignored.
check-mail-include = <folder1,folder2,folder3...>
By default, all folders are included.
check-mail-exclude = <folder1,folder2,folder3...>
By default, no folders are excluded.
cache-headers = true|false
Default: false
cache-max-age = <duration>
Default: 720h (30 days)
idle-timeout = <duration>
Default: 10ms
idle-debounce = <duration>
Default: 10ms
Originally created by Drew DeVault <sir@cmpwn.com> and maintained by Robin Jarry <robin@jarry.cc> who is assisted by other open source contributors. For more information about aerc development, see https://sr.ht/~rjarry/aerc/.
2023-04-23 |