AERC-IMAP(5)                  File Formats Manual                 AERC-IMAP(5)

<?><?><?> (NAME)
       aerc-imap - <?><?><?><?><?><?><?><?> IMAP <?><?><?><?> aerc(1)

<?><?><?><?><?> (SYNOPSIS)
       <?><?><?><?><?><?> aerc <?><?><?><?><?><?> IMAP <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> RFC 3501 <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?><?> IMAP <?><?><?>:

       o   IDLE (RFC 2177)
       o   LIST-STATUS (RFC 5819)
       o   X-GM-EXT-1 (Gmail)

<?><?><?><?><?><?><?><?> (CONFIGURATION)
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> IMAP
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> :new-account <?><?><?><?><?> <?><?><?>.

       <?><?> <?><?><?><?> accounts.conf (<?><?> aerc-accounts(5)
       <?><?><?><?><?><?> <?><?><?><?><?><?><?>)<?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> IMAP <?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?>:

       source =
       <scheme>://<username>[:<password>]@<hostname>[:<port>]?[<oauth2_params>]
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> URL (<?><?>
           <?><?><?><?> URL-encoded) <?><?><?><?><?>. <?><?><?><?> @ <?><?>
           <?><?><?><?> <?><?><?><?><?><?><?> URL <?><?> %40 <?><?><?><?><?>
           <?><?><?><?><?><?>.

           <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <scheme>
           <?><?><?><?><?><?><?> <?><?>:

           imap
               <?><?><?><?><?><?> IMAP <?><?> <?><?><?><?><?> STARTTLS

           imap+insecure
               <?><?><?><?><?><?> IMAP <?><?><?><?> STARTTLS

           imaps
               <?><?><?><?><?><?> IMAP <?><?> TLS/SSL

           imaps+insecure
               <?><?><?><?><?><?> IMAP <?><?> TLS/SSL<?> <?><?><?><?>
               <?><?><?><?><?> <?><?><?> <?><?><?><?><?> (certificate)

           imaps+oauthbearer
               <?><?><?><?><?><?> IMAP <?><?> TLS/SSL <?>
               <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
               OAUTHBEARER

               <oauth2_params>:

               <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?> <?>
               <?><?><?><?><?> token_endpoint<?> <?><?><?><?><?><?><?>
               <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
               <?><?> <?><?><?><?> <?><?><?><?><?><?> (refresh token)
               <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
               (access token) <?><?> <?><?><?> <?><?><?><?><?><?>. <?><?><?>
               token_endpoint <?><?><?> <?><?><?><?> <?><?><?><?><?>
               <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?>
               <?><?><?><?><?> <?><?><?><?><?><?> <?> <?><?><?><?><?><?><?>
               <?><?> <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
               <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>.

               o   token_endpoint (<?><?><?><?><?><?><?>)
               o   client_id (<?><?><?><?><?><?><?>)
               o   client_secret (<?><?><?><?><?><?><?>)
               o   scope (<?><?><?><?><?><?><?>)

               <?><?><?><?>:
                   imaps+oauthbearer://...?&token_endpoint=https://...&client_id=

           imaps+xoauth2
               <?><?><?><?><?><?> IMAP <?><?> TLS/SSL <?><?>
               <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
               XOAUTH2. <?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
               OAUTHBEARER <?><?><?><?><?>.

       source-cred-cmd = <command>
           <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
           <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
           IMAP <?><?><?><?> <?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?>
           <?><?> <?><?><?><?><?><?><?> <?><?> sh -c command <?><?><?><?>
           <?><?><?><?><?> <?><?>. <?><?><?> <?><?><?><?><?><?><?><?><?><?>
           <?><?> <?><?><?><?><?> source <?><?><?><?><?> <?><?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>.

           <?><?><?><?>:
               source-cred-cmd = pass hostname/username

       connection-timeout = <duration>
           <?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> IMAP.
           <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?>:
           https://pkg.go.dev/time#ParseDuration

           <?><?><?><?><?><?><?>: 90s

       keepalive-period = <duration>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?><?>
           (<?><?><?><?><?><?><?><?> <?><?><?><?> ACK <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?><?>) <?> <?><?><?><?><?><?>
           <?><?><?><?> keepalive. <?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
           keepalive <?><?><?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?>. <?><?><?><?><?> <?><?><?> <?><?>
           <?><?><?><?><?><?>: https://pkg.go.dev/time#ParseDuration

           <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?> TCP <?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?>.

       keepalive-probes = <int>
           <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?> <?><?> <?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?> <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?>.

           <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?><?><?> <?><?><?><?> TCP <?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?>
           keepalive-period <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.

           <?><?><?> <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>. <?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?>.

       keepalive-interval = <duration>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?> keepalive<?> <?><?><?><?> <?><?>
           <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?>
           <?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?><?>. <?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> (<?><?><?>) <?><?><?><?><?><?><?>.

           <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?> TCP <?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?>. <?><?><?> keepalive-period <?><?><?><?>
           <?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> 3s <?><?><?><?><?>
           <?><?><?><?><?><?>.

           <?><?><?> <?><?><?><?><?> <?><?><?> <?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>. <?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?>.

       check-mail-include = <folder1,folder2,folder3...>
           <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
           <?><?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?><?><?> :check-mail <?><?><?><?>
           <?><?><?><?><?><?>. <?><?><?><?><?><?><?><?> <?><?> <?><?>
           <?><?><?><?><?><?> ~ <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?> (regular
           expressions) <?><?><?><?><?> <?><?><?><?><?><?><?>. <?><?><?>
           <?><?><?><?> IMAP <?><?><?> <?><?> <?><?><?><?><?> LIST-STATUS
           <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?>
           <?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?> <?><?>.

           <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.

       check-mail-exclude = <folder1,folder2,folder3...>
           <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
           <?><?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?>
           <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
           :check-mail <?><?><?><?> <?><?><?><?><?><?>.
           <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?> ~
           <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?><?> (regular expressions)
           <?><?><?><?><?> <?><?><?><?><?><?><?>. <?><?><?> <?><?><?><?> IMAP
           <?><?><?> <?><?> <?><?><?><?><?> LIST-STATUS
           <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?>
           <?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?> <?><?>. <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
           <?><?> <?><?> <?><?><?><?><?><?> <?><?> check-mail-include
           <?><?><?><?><?><?> <?><?><?><?>.

           <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?>.

       cache-headers = true|false
           <?><?> <?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?> true<?>
           <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?>.
           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
           $XDG_CACHE_HOME/aerc <?><?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?> ~/.cache/aerc
           <?><?><?>.

           <?><?><?><?><?><?><?>: false

       cache-max-age = <duration>
           <?><?><?><?><?><?> <?><?><?> <?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>.
           <?><?><?><?>: <?><?><?><?><?><?><?><?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?>
           cache-max-age <?><?><?><?><?> <?><?><?> <?><?> <?><?><?>
           <?><?><?><?> <?><?><?>. <?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?>
           <?><?> <?><?><?> 0 <?><?><?><?><?> <?><?><?><?>.

           <?><?><?><?><?><?><?>: 720h (<?><?> <?><?><?>)

       idle-timeout = <duration>
           <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?> <?><?>
           <?><?><?><?> <?><?><?> <?><?><?><?><?> IDLE<?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?>.

           <?><?><?><?><?><?><?>: 10s

       idle-debounce = <duration>
           <?><?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
           <?><?><?><?><?><?><?><?><?><?> (idler) <?><?><?><?> <?><?>
           <?><?><?> <?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>.

           <?><?><?><?><?><?><?>: 10ms

       expunge-policy = auto|low-to-high|stable
           <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>
           <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>.
           <?><?><?><?><?> auto <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?>
           <?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?> <?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?>. <?><?><?><?><?> low-to-high
           <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>
           (<?><?><?> <?><?><?><?> <?><?><?> <?><?> GMail <?><?> FastMail
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?> <?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?>). <?><?><?><?><?> stable
           <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> (<?><?><?>
           <?><?><?><?> <?><?><?> <?><?> Dovecot <?><?> WorkMail
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?> <?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> ).

           <?><?><?><?><?><?><?>: auto

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       aerc(1) aerc-accounts(5)

<?><?><?><?><?><?><?><?><?> (AUTHORS)
       <?><?> <?><?><?><?><?> <?><?><?><?> Drew DeVault <?><?><?><?><?> <?><?>
       <?> <?><?><?><?> Robin Jarry <?><?> <?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> aerc<?> <?><?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?>: https://sr.ht/~rjarry/aerc

                                  2025-08-29                      AERC-IMAP(5)