################################################################################ #### Global configuration ###################################################### ################################################################################ # Default display name for all accounts. It is used to build the full # email address of an account: "Example" # display-name = "Example" # Default signature for all accounts. The signature is put at the # bottom of all messages. It can be a path or a string. Supports TOML # multilines. # # signature = "/path/to/signature/file" # signature = """ # Thanks you, # Regards # """ signature = "Regards,\n" # Default signature delimiter for all accounts. It delimits the end of # the message body from the signature. # signature-delim = "-- \n" # Default downloads directory path for all accounts. It is mostly used # for downloading attachments. Defaults to the system temporary # directory. # downloads-dir = "~/downloads" # Customizes the charset used to build the table. Defaults to markdown # table style. # # See . # account.list.table.preset = "|| |-||| " # Customizes the color of the NAME column of the account listing # table. # account.list.table.name-color = "green" # Customizes the color of the BACKENDS column of the account listing # table. # account.list.table.backends-color = "blue" # Customizes the color of the DEFAULT column of the account listing # table. # account.list.table.default-color = "reset" ################################################################################ #### Account configuration ##################################################### ################################################################################ [accounts.example] # Defaultness of the account. The current account will be used by # default in all commands. # default = true # The email address associated to the current account. # email = "example@localhost" # The display name of the account. This and the email are used to # build the full email address: "Example" # display-name = "Example" # The signature put at the bottom of composed messages. It can be a # path or a string. Supports TOML multilines. # #signature = "/path/to/signature/file" #signature = """ # Thanks you, # Regards #""" signature = "Regards,\n" # Signature delimiter. It delimits the end of the message body from # the signature. # signature-delim = "-- \n" # Downloads directory path. It is mostly used for downloading # attachments. Defaults to the system temporary directory. downloads-dir = "~/downloads" ######################################## #### Folder configuration ############## ######################################## # Defines aliases for your mailboxes. There are 4 special aliases used # by the tool: inbox, sent, drafts and trash. Other aliases can be # defined as well. # folder.alias.inbox = "INBOX" folder.alias.sent = "Sent" folder.alias.drafts = "Drafts" folder.alias.trash = "Trash" folder.alias.a23 = "Archives/2023" # Customizes the number of folders to show by page. # folder.list.page-size = 10 # Customizes the charset used to build the table. Defaults to markdown # table style. # # See . # folder.list.table.preset = "|| |-||| " # Customizes the color of the NAME column of the folder listing table. # folder.list.table.name-color = "blue" # Customizes the color of the DESC column of the folder listing table. # folder.list.table.desc-color = "green" ######################################## #### Envelope configuration ############ ######################################## # Customizes the number of envelopes to show by page. # envelope.list.page-size = 10 # Customizes the format of the envelope date. # # See supported formats at . # envelope.list.datetime-fmt = "%F %R%:z" # Transforms envelopes date timezone into the user's local one. For # example, if the user's local timezone is UTC, the envelope date # `2023-06-15T09:00:00+02:00` becomes `2023-06-15T07:00:00-00:00`. # envelope.list.datetime-local-tz = true # Customizes the charset used to build the table. Defaults to markdown # table style. # # See . # envelope.list.table.preset = "|| |-||| " # Customizes the character of the unseen flag of the envelope listing # table. # envelope.list.table.unseen-char = "*" # Customizes the character of the replied flag of the envelope listing # table. # envelope.list.table.replied-char = "R" # Customizes the character of the flagged flag of the envelope listing # table. # envelope.list.table.flagged-char = "!" # Customizes the character of the attachment property of the envelope # listing table. # envelope.list.table.attachment-char = "@" # Customizes the color of the ID column of the envelope listing table. # envelope.list.table.id-color = "red" # Customizes the color of the FLAGS column of the envelope listing # table. # envelope.list.table.flags-color = "reset" # Customizes the color of the SUBJECT column of the envelope listing # table. # envelope.list.table.subject-color = "green" # Customizes the color of the SENDER column of the envelope listing # table. # envelope.list.table.sender-color = "blue" # Customizes the color of the DATE column of the envelope listing # table. # envelope.list.table.date-color = "yellow" ######################################## #### Message configuration ############# ######################################## # Defines headers to show at the top of messages when reading them. # message.read.headers = ["From", "To", "Cc", "Subject"] # Represents the message text/plain format as defined in the # RFC2646. # # See . # #message.read.format.fixed = 80 #message.read.format = "flowed" message.read.format = "auto" # Defines headers to show at the top of messages when writing them. # message.write.headers = ["From", "To", "In-Reply-To", "Cc", "Subject"] # Overrides the backend used for sending messages. # message.send.backend = "smtp" # Saves a copy of sent messages to the sent folder. The sent folder is # taken from folder.alias, defaults to Sent. # message.send.save-copy = true # Hook called just before sending a message. The command should take a # raw message as standard input (stdin) and returns the modified raw # message to the standard output (stdout). # message.send.pre-hook = "process-markdown.sh" # Customizes the message deletion style. Message deletion can be # performed either by moving messages to the Trash folder or by adding # the Deleted flag to their respective envelopes. # #message.delete.style = "flag" message.delete.style = "folder" ######################################## #### Template configuration ############ ######################################## # Defines how and where the signature should be displayed when writing # a new message. # #template.new.signature-style = "hidden" #template.new.signature-style = "attached" template.new.signature-style = "inlined" # Defines the posting style when replying to a message. # # See . # #template.reply.posting-style = "interleaved" #template.reply.posting-style = "bottom" template.reply.posting-style = "top" # Defines how and where the signature should be displayed when # repyling to a message. # #template.reply.signature-style = "hidden" #template.reply.signature-style = "attached" #template.reply.signature-style = "above-quote" template.reply.signature-style = "below-quote" # Defines the headline format put at the top of a quote when replying # to a message. # # Available placeholders: {senders} # See supported date formats at . # template.reply.quote-headline-fmt = "On %d/%m/%Y %H:%M, {senders} wrote:\n" # Defines the posting style when forwarding a message. # # See . # #template.forward.posting-style = "attached" template.forward.posting-style = "top" # Defines how and where the signature should be displayed when # forwarding a message. # #template.forward.signature-style = "hidden" #template.forward.signature-style = "attached" template.forward.signature-style = "inlined" # Defines the headline format put at the top of the quote when # forwarding a message. # template.forward.quote-headline = "-------- Forwarded Message --------\n" ######################################## #### PGP configuration ################# ######################################## # TODO #pgp.backend = "commands" #pgp.backend = "gpg" #pgp.backend = "native" ######################################## #### IMAP configuration ################ ######################################## # Defines the IMAP backend as the default one for all features. # backend = "imap" # IMAP server host name. # imap.host = "localhost" # IMAP server port. # #imap.port = 143 imap.port = 993 # IMAP server encryption. # #imap.encryption = "none" # or false #imap.encryption = "start-tls" imap.encryption = "tls" # or true # IMAP server login. # imap.login = "example@localhost" # IMAP server password authentication configuration. # imap.auth.type = "password" # # Password can be inlined (not recommended). # #imap.auth.raw = "p@assw0rd" # # Password can be stored inside your system global keyring (requires # the keyring cargo feature). You must run at least once `himalaya # account configure` to set up the password. # #imap.auth.keyring = "example-imap" # # Password can be retrieved from a shell command. # imap.auth.cmd = "pass show example-imap" # IMAP server OAuth 2.0 authorization configuration. # #imap.auth.type = "oauth2" # # Client identifier issued to the client during the registration # process described in RFC6749. # See . # #imap.auth.client-id = "client-id" # # Client password issued to the client during the registration process # described in RFC6749. # # Defaults to keyring "-imap-client-secret". # See . # #imap.auth.client-secret.raw = "" #imap.auth.client-secret.keyring = "example-imap-client-secret" #imap.auth.client-secret.cmd = "pass show example-imap-client-secret" # # Method for presenting an OAuth 2.0 bearer token to a service for # authentication. # #imap.auth.method = "oauthbearer" #imap.auth.method = "xoauth2" # # URL of the authorization server's authorization endpoint. # #imap.auth.auth-url = "https://accounts.google.com/o/oauth2/v2/auth" # # URL of the authorization server's token endpoint. # #imap.auth.token-url = "https://www.googleapis.com/oauth2/v3/token" # # Access token returned by the token endpoint and used to access # protected resources. It is recommended to use the keyring variant, # as it will refresh automatically. # # Defaults to keyring "-imap-access-token". # #imap.auth.access-token.raw = "" #imap.auth.access-token.keyring = "example-imap-access-token" #imap.auth.access-token.cmd = "pass show example-imap-access-token" # # Refresh token used to obtain a new access token (if supported by the # authorization server). It is recommended to use the keyring variant, # as it will refresh automatically. # # Defaults to keyring "-imap-refresh-token". # #imap.auth.refresh-token.raw = "" #imap.auth.refresh-token.keyring = "example-imap-refresh-token" #imap.auth.refresh-token.cmd = "pass show example-imap-refresh-token" # # Enable the protection, as defined in RFC7636. # # See . # #imap.auth.pkce = true # # Access token scope(s), as defined by the authorization server. # #imap.auth.scope = "unique scope" #imap.auth.scopes = ["multiple", "scopes"] # # Host name of the redirect server. # Defaults to localhost. # #imap.auth.redirect-host = "localhost" # # Port of the redirect server. # Defaults to the first available one. # #imap.auth.redirect-port = 9999 ######################################## #### Maildir configuration ############# ######################################## # Defines the Maildir backend as the default one for all features. # #backend = "maildir" # The Maildir root directory. The path should point to the root level # of the Maildir directory. # #maildir.root-dir = "~/.Mail/example" # Does the Maildir folder follows the Maildir++ standard? # # See . # #maildir.maildirpp = false ######################################## #### Notmuch configuration ############# ######################################## # Defines the Notmuch backend as the default one for all features. # #backend = "notmuch" # The path to the Notmuch database. The path should point to the root # directory containing the Notmuch database (usually the root Maildir # directory). # #notmuch.db-path = "~/.Mail/example" # Overrides the default path to the Maildir folder. # #notmuch.maildir-path = "~/.Mail/example" # Overrides the default Notmuch configuration file path. # #notmuch.config-path = "~/.notmuchrc" # Override the default Notmuch profile name. # #notmuch.profile = "example" ######################################## #### SMTP configuration ################ ######################################## # Defines the SMTP backend for the message sending feature. # backend = "smtp" # SMTP server host name. # smtp.host = "localhost" # SMTP server port. # #smtp.port = 25 #smtp.port = 465 smtp.port = 587 # SMTP server encryption. # #smtp.encryption = "none" # or false #smtp.encryption = "start-tls" smtp.encryption = "tls" # or true # SMTP server login. # smtp.login = "example@localhost" # SMTP server password authentication configuration. # smtp.auth.type = "password" # # Password can be inlined (not recommended). # #smtp.auth.raw = "p@assw0rd" # # Password can be stored inside your system global keyring (requires # the keyring cargo feature). You must run at least once `himalaya # account configure` to set up the password. # #smtp.auth.keyring = "example-smtp" # # Password can be retrieved from a shell command. # smtp.auth.cmd = "pass show example-smtp" # SMTP server OAuth 2.0 authorization configuration. # #smtp.auth.type = "oauth2" # # Client identifier issued to the client during the registration # process described in RFC6749. # See . # #smtp.auth.client-id = "client-id" # # Client password issued to the client during the registration process # described in RFC6749. # # Defaults to keyring "-smtp-client-secret". # See . # #smtp.auth.client-secret.raw = "" #smtp.auth.client-secret.keyring = "example-smtp-client-secret" #smtp.auth.client-secret.cmd = "pass show example-smtp-client-secret" # # Method for presenting an OAuth 2.0 bearer token to a service for # authentication. # #smtp.auth.method = "oauthbearer" #smtp.auth.method = "xoauth2" # # URL of the authorization server's authorization endpoint. # #smtp.auth.auth-url = "https://accounts.google.com/o/oauth2/v2/auth" # # URL of the authorization server's token endpoint. # #smtp.auth.token-url = "https://www.googleapis.com/oauth2/v3/token" # # Access token returned by the token endpoint and used to access # protected resources. It is recommended to use the keyring variant, # as it will refresh automatically. # # Defaults to keyring "-smtp-access-token". # #smtp.auth.access-token.raw = "" #smtp.auth.access-token.keyring = "example-smtp-access-token" #smtp.auth.access-token.cmd = "pass show example-smtp-access-token" # # Refresh token used to obtain a new access token (if supported by the # authorization server). It is recommended to use the keyring variant, # as it will refresh automatically. # # Defaults to keyring "-smtp-refresh-token". # #smtp.auth.refresh-token.raw = "" #smtp.auth.refresh-token.keyring = "example-smtp-refresh-token" #smtp.auth.refresh-token.cmd = "pass show example-smtp-refresh-token" # # Enable the protection, as defined in RFC7636. # # See . # #smtp.auth.pkce = true # # Access token scope(s), as defined by the authorization server. # #smtp.auth.scope = "unique scope" #smtp.auth.scopes = ["multiple", "scopes"] # # Host name of the redirect server. # Defaults to localhost. # #smtp.auth.redirect-host = "localhost" # # Port of the redirect server. # Defaults to the first available one. # #smtp.auth.redirect-port = 9999 ######################################## #### Sendmail configuration ############ ######################################## # Defines the Sendmail backend for the message sending feature. # #message.send.backend = "sendmail" # Customizes the sendmail shell command. # #sendmail.cmd = "/usr/bin/sendmail"