| MELI.CONF.EXAMPLES(5) | File Formats Manual | MELI.CONF.EXAMPLES(5) |
NAME¶
meli.conf.examples —
Example configurations for various mail backends supported
by the meli(1) terminal e-mail client
MAILDIR ACCOUNT¶
An example configuration:
[accounts.account-name]
root_mailbox = "/path/to/root/folder"
format = "Maildir"
listing.index_style = "Compact"
identity="email@example.com"
display_name = "Name"
send_mail = 'msmtp --read-recipients --read-envelope-from'
#send_mail = { hostname = "smtp.example.com", port = 587, auth = { type = "auto", username = "user", password = { command = "gpg2 --no-tty -q -d ~/.passwords/user.gpg" } }, security = { type = "STARTTLS" } }
# Set mailbox-specific settings
[accounts.account-name.mailboxes]
"INBOX" = { alias="Inbox" } #inline table
"drafts" = { alias="Drafts" } #inline table
[accounts.account-name.mailboxes."foobar-devel"] # or a regular table
ignore = true # don't show notifications for this mailbox
MBOX ACCOUNT¶
An example configuration:
[accounts.account-name] root_mailbox = "/var/mail/username" format = "mbox" listing.index_style = "Compact" identity="username@hostname.local" send_mail = '/bin/false'
IMAP ACCOUNT¶
[accounts."account-name"]
root_mailbox = "INBOX"
format = "imap"
server_hostname="mail.example.com"
server_password="pha2hiLohs2eeeish2phaii1We3ood4chakaiv0hien2ahie3m"
server_username="username@example.com"
#server_port="993" # imaps
server_port="143" # STARTTLS
use_starttls=true #optional
send_mail = { hostname = "smtp.example.com", port = 587, auth = { type = "auto", username = "user", password = { command = "gpg2 --no-tty -q -d ~/.passwords/user.gpg" } }, security = { type = "STARTTLS" } }
display_name = "Name Name"
identity = "username@example.com"
## show only specific mailboxes:
#subscribed_mailboxes = ["INBOX", "INBOX/Sent", "INBOX/Drafts", "INBOX/Junk"]
Gmail account example¶
[accounts."account-name"]
root_mailbox = '[Gmail]'
format = "imap"
send_mail = { hostname = "smtp.gmail.com", port = 587, auth = { type = "auto", username = "user", password = { command = "gpg2 --no-tty -q -d ~/.passwords/user.gpg" } }, security = { type = "STARTTLS" } }
server_hostname='imap.gmail.com'
server_password="password"
server_username="username@gmail.com"
server_port="993"
listing.index_style = "Conversations"
identity = "username@gmail.com"
display_name = "Name Name"
# Gmail auto saves sent mail to Sent folder, so don't duplicate the effort:
composing.store_sent_mail = false
JMAP ACCOUNT¶
The server_url option must hold the
address of the server's session endpoint.
[accounts."account-name"] root_mailbox = "INBOX" format = "jmap" send_mail = 'server_submission' server_url="http://localhost:8080" server_username="user@hostname.local" server_password="changeme" identity = "user@hostname.local"
fastmail.com account example¶
Fastmail uses the
Bearer
token authentication mechanism, so the option
use_token must be enabled:
[accounts."fastmail-jmap"] root_mailbox = "INBOX" format = "jmap" server_url="https://api.fastmail.com/jmap/session" server_username="user@fastmail.com" server_password="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" use_token=true identity = "My Name <user@fastmail.com>" send_mail = "server_submission"
NOTMUCH ACCOUNT¶
An example configuration:
[accounts.notmuch]
format = "notmuch"
#library_file_path = "/opt/homebrew/lib/libnotmuch.5.dylib"
# Note that the notmuch backend does not support trash folders
# So add a shortcut to add/remove a trash tag
shortcuts.listing.commands = [ { command = [ "tag remove trash" ], shortcut = "D" }, { command = [ "tag add trash" ], shortcut = "d"} ]
...
[accounts.notmuch.mailboxes]
"INBOX" = { query="tag:inbox", subscribe = true, usage = "Inbox", save_to = { path = "/path/to/INBOX", add_tags = ["inbox"] } }
"Drafts" = { query="tag:draft", usage = "Drafts", save_to = { path = "/path/to/Drafts", add_tags = ["draft"] }, subscribe = true }
"Sent" = { query="from:username@example.com from:username2@example.com", usage = "Sent", save_to = { path = "/path/to/Sent", add_tags = ["sent"] }, subscribe = true }
"Archives" = { query="tag:archived", subscribe = true }
"Archives/2019" = { query="tag:archived date:01-2019..12-2019", parent="Archives", subscribe = true }
NNTP / USENET ACCOUNT¶
An example configuration:
[accounts.eternal-september]
format = "nntp"
server_hostname = "news.eternal-september.org"
server_username = "user"
server_password = "password"
require_auth = true
use_tls = true
server_port = 563
root_mailbox = "comp.arch.storage"
subscribed_mailboxes = ["comp.arch.storage",]
identity = "user@example.com"
composing.send_mail = "server_submission"
[accounts.eternal-september.mailboxes]
"comp.arch.storage" = {}
"comp.bbs.majorbbs" = {}
"comp.bbs.misc" = {}
"comp.bbs.waffle" = {}
"comp.benchmarks" = {}
"comp.binaries.cbm" = {}
"comp.bugs" = {}
SEE ALSO¶
AUTHORS¶
Copyright 2017–2024 Manos Pitsidianakis <manos@pitsidianak.is>
Released under the GPL, version 3 or greater. This software carries no warranty of any kind. (See COPYING for full copyright and warranty notices.)
Links¶
| November 22, 2024 | Nixpkgs |