Scroll to navigation

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 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

meli.conf(5), meli(1), meli-themes(5)

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.)

November 22, 2024 Nixpkgs