config.sample.toml

################################################################################
#### Global configuration ######################################################
################################################################################

# Default display name for all accounts. It is used to build the full
# email address of an account: "Example" <example@localhost>
#
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 <https://docs.rs/comfy-table/latest/comfy_table/presets/index.html>.
#
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"

# Customizes the keybindings of command prompts.
#
# It does not yet apply to interactive prompts like folder selection,
# but it should in the future.
#
#repl.keybinds = "vi"
repl.keybinds = "emacs"

################################################################################
#### 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" <example@localhost>
#
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 <https://docs.rs/comfy-table/latest/comfy_table/presets/index.html>.
#
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 <https://docs.rs/chrono/latest/chrono/format/strftime/>. 
#
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 <https://docs.rs/comfy-table/latest/comfy_table/presets/index.html>.
#
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 <https://www.ietf.org/rfc/rfc2646.txt>.
#
#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"]

# 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 <https://en.wikipedia.org/wiki/Posting_style>.
#
#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 <https://docs.rs/chrono/latest/chrono/format/strftime/>.
#
template.reply.quote-headline-fmt = "On %d/%m/%Y %H:%M, {senders} wrote:\n"

# Defines the posting style when forwarding a message.
#
# See <https://en.wikipedia.org/wiki/Posting_style>.
#
#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 <https://datatracker.ietf.org/doc/html/rfc6749#section-2.2>.
#
#imap.auth.client-id = "client-id"
#
# Client password issued to the client during the registration process
# described in RFC6749.
#
# Defaults to keyring "<account-name>-imap-client-secret".
# See <https://datatracker.ietf.org/doc/html/rfc6749#section-2.2>.
#
#imap.auth.client-secret.raw = "<raw-client-secret>"
#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 "<account-name>-imap-access-token".
#
#imap.auth.access-token.raw = "<raw-access-token>"
#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 "<account-name>-imap-refresh-token".
#
#imap.auth.refresh-token.raw = "<raw-refresh-token>"
#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 <https://datatracker.ietf.org/doc/html/rfc7636>.
#
#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 <https://en.wikipedia.org/wiki/Maildir#Maildir++>.
#
#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.
#
message.send.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 <https://datatracker.ietf.org/doc/html/rfc6749#section-2.2>.
#
#smtp.auth.client-id = "client-id"
#
# Client password issued to the client during the registration process
# described in RFC6749.
#
# Defaults to keyring "<account-name>-smtp-client-secret".
# See <https://datatracker.ietf.org/doc/html/rfc6749#section-2.2>.
#
#smtp.auth.client-secret.raw = "<raw-client-secret>"
#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 "<account-name>-smtp-access-token".
#
#smtp.auth.access-token.raw = "<raw-access-token>"
#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 "<account-name>-smtp-refresh-token".
#
#smtp.auth.refresh-token.raw = "<raw-refresh-token>"
#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 <https://datatracker.ietf.org/doc/html/rfc7636>.
#
#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"