mirror of https://git.meli.delivery/meli/meli
You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
940 lines
22 KiB
Groff
940 lines
22 KiB
Groff
.\" meli - meli.1
|
|
.\"
|
|
.\" Copyright 2017-2019 Manos Pitsidianakis
|
|
.\"
|
|
.\" This file is part of meli.
|
|
.\"
|
|
.\" meli is free software: you can redistribute it and/or modify
|
|
.\" it under the terms of the GNU General Public License as published by
|
|
.\" the Free Software Foundation, either version 3 of the License, or
|
|
.\" (at your option) any later version.
|
|
.\"
|
|
.\" meli is distributed in the hope that it will be useful,
|
|
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
.\" GNU General Public License for more details.
|
|
.\"
|
|
.\" You should have received a copy of the GNU General Public License
|
|
.\" along with meli. If not, see <http://www.gnu.org/licenses/>.
|
|
.\"
|
|
.de HorizontalRule
|
|
.\"\l'\n(.l\(ru1.25'
|
|
.sp
|
|
..
|
|
.de Shortcut
|
|
.Sm
|
|
.Aq \\$1
|
|
\
|
|
.Po
|
|
.Em shortcuts.\\$2\&. Ns
|
|
.Em \\$3
|
|
.Pc
|
|
.Sm
|
|
..
|
|
.de ShortcutPeriod
|
|
.Aq \\$1
|
|
.Po
|
|
.Em shortcuts.\\$2\&. Ns
|
|
.Em \\$3
|
|
.Pc Ns
|
|
..
|
|
.de Command
|
|
.Bd -ragged
|
|
.Cm \\$*
|
|
.Ed
|
|
.sp
|
|
..
|
|
.\".Dd November 11, 2022
|
|
.Dd March 10, 2024
|
|
.Dt MELI 1
|
|
.Os
|
|
.Sh NAME
|
|
.Nm meli
|
|
.Nd terminal e\-mail client
|
|
.Em μέλι
|
|
is the Greek word for honey
|
|
.Sh SYNOPSIS
|
|
.Nm
|
|
.Op Fl -help | h
|
|
.Op Fl -version | v
|
|
.Op Fl -config Ar path
|
|
.Bl -tag -width flag -offset indent
|
|
.It Fl -help | h
|
|
Show help message and exit.
|
|
.It Fl -version | v
|
|
Show version and exit.
|
|
.It Fl -config Ar path
|
|
Start meli with given configuration file.
|
|
.It Cm create-config Op Ar path
|
|
Create configuration file in
|
|
.Pa path
|
|
if given, or at
|
|
.Pa $XDG_CONFIG_HOME/meli/config.toml
|
|
.It Cm test-config Op Ar path
|
|
Test a configuration file for syntax issues or missing options.
|
|
.It Cm man Op Ar page
|
|
Print documentation page and exit (Piping to a pager is recommended).
|
|
.It Cm install-man Op Ar path
|
|
Install manual pages to the first location provided by
|
|
.Ev MANPATH
|
|
or
|
|
.Xr manpath 1 ,
|
|
unless you specify the directory as an argument.
|
|
.It Cm compiled-with
|
|
Print compile time feature flags of this binary.
|
|
.It Cm edit-config
|
|
Edit configuration files with
|
|
.Ev EDITOR
|
|
or
|
|
.Ev VISUAL Ns
|
|
\&.
|
|
.It Cm help
|
|
Prints help information or the help of the given subcommand(s).
|
|
.It Cm print-app-directories
|
|
Print all directories that
|
|
.Ns Nm
|
|
creates and uses.
|
|
.It Cm print-config-path
|
|
Print location of configuration file that will be loaded on normal app startup.
|
|
.It Cm print-default-theme
|
|
Print default theme keys and values in TOML syntax, to be used as a blueprint.
|
|
.It Cm print-loaded-themes
|
|
Print all loaded themes in TOML syntax.
|
|
.It Cm print-log-path
|
|
Print log file location.
|
|
.It Cm view
|
|
View mail from input file.
|
|
.El
|
|
.Sh DESCRIPTION
|
|
.Nm
|
|
is a terminal mail client aiming for extensive and user-friendly configurability.
|
|
.Bd -literal
|
|
^^ .-=-=-=-. ^^
|
|
^^ (`-=-=-=-=-`) ^^
|
|
(`-=-=-=-=-=-=-`) ^^ ^^
|
|
^^ (`-=-=-=-=-=-=-=-`) ^^
|
|
( `-=-=-=-(@)-=-=-` ) ^^
|
|
(`-=-=-=-=-=-=-=-=-`) ^^
|
|
(`-=-=-=-=-=-=-=-=-`) ^^
|
|
(`-=-=-=-=-=-=-=-=-`)
|
|
^^ (`-=-=-=-=-=-=-=-=-`) ^^
|
|
^^ (`-=-=-=-=-=-=-=-`) ^^
|
|
(`-=-=-=-=-=-=-`) ^^
|
|
^^ (`-=-=-=-=-`)
|
|
`-=-=-=-=-` ^^
|
|
.Ed
|
|
.Sh STARTING WITH meli
|
|
When launched for the first time,
|
|
.Nm
|
|
will search for its configuration directory,
|
|
.Pa $XDG_CONFIG_HOME/meli/ Ns
|
|
\&.
|
|
If it doesn't exist, you will be asked if you want to create one and presented with a sample configuration file
|
|
.Pq Pa $XDG_CONFIG_HOME/meli/config.toml
|
|
that includes the basic settings required for setting up accounts allowing you to copy and edit right away.
|
|
See
|
|
.Xr meli.conf 5
|
|
for the available configuration options.
|
|
.Pp
|
|
At any time, you may press
|
|
.Shortcut \&? general toggle_help
|
|
for a searchable list of all available actions and shortcuts, along with every possible setting and command that your version supports.
|
|
.Pp
|
|
The main visual navigation tool, the left-side sidebar may be toggled with
|
|
.ShortcutPeriod \(ga listing toggle_menu_visibility
|
|
\&.
|
|
.Pp
|
|
Each mailbox may be viewed in 4 modes:
|
|
.Bl -dash -compact
|
|
.It
|
|
.Tg index-style-plain
|
|
.Em Plain
|
|
views each mail individually,
|
|
.It
|
|
.Tg index-style-threaded
|
|
.Em Threaded
|
|
shows their thread relationship visually,
|
|
.It
|
|
.Tg index-style-conversations
|
|
.Em Conversations
|
|
collapses each thread of e\-mails into a single entry,
|
|
.It
|
|
.Tg index-style-compact
|
|
.Em Compact
|
|
shows one row per thread.
|
|
.El
|
|
.Pp
|
|
If you're using a light color palette in your terminal, you should set
|
|
.Em theme = "light"
|
|
in the
|
|
.Em terminal
|
|
section of your configuration.
|
|
See
|
|
.Xr meli-themes 5
|
|
for complete documentation on user themes.
|
|
.Pp
|
|
See
|
|
.Xr meli 7
|
|
for a more detailed tutorial on using
|
|
.Nm Ns
|
|
\&.
|
|
.Sh SHORTCUTS
|
|
See
|
|
.Xr meli.conf 5 SHORTCUTS
|
|
for shortcuts and their default values.
|
|
.Sh VIEWING MAIL
|
|
Open attachments by typing their index in the attachments list and then
|
|
.ShortcutPeriod a envelope_view open_attachment
|
|
\&.
|
|
.Nm
|
|
will attempt to open text inside its pager, and other content via
|
|
.Cm xdg-open Ns
|
|
\&.
|
|
Press
|
|
.Shortcut m envelope_view open_mailcap
|
|
instead to use the mailcap entry for the MIME type of the attachment, if any.
|
|
See
|
|
.Sx FILES
|
|
for the location of the mailcap files and
|
|
.Xr mailcap 5
|
|
for their syntax.
|
|
You can save individual attachments with the
|
|
.Command save-attachment Ar INDEX Ar path-to-file
|
|
command.
|
|
.Ar INDEX
|
|
is the attachment's index in the listing.
|
|
If the path provided is a directory, the attachment is saved with its filename set to the filename in the attachment, if any.
|
|
If the 0th index is provided, the entire message is saved.
|
|
If the path provided is a directory, the message is saved as an eml file with its filename set to the messages message-id.
|
|
.Sh SEARCH
|
|
Each e\-mail storage backend has a default search method assigned.
|
|
.Em IMAP
|
|
uses the SEARCH command,
|
|
.Em notmuch
|
|
uses libnotmuch and
|
|
.Em Maildir/mbox
|
|
performs a slow linear search.
|
|
It is advised to use a search backend on
|
|
.Em Maildir/mbox
|
|
accounts.
|
|
.Nm Ns
|
|
, if built with sqlite3, includes the ability to perform full text search on the following fields:
|
|
.Em From ,
|
|
.Em To ,
|
|
.Em Cc ,
|
|
.Em Bcc ,
|
|
.Em In-Reply-To ,
|
|
.Em References ,
|
|
.Em Subject
|
|
and
|
|
.Em Date .
|
|
The message body (in plain text human readable form) and the flags can also be queried.
|
|
To enable sqlite3 indexing for an account set
|
|
.Em search_backend
|
|
to
|
|
.Em sqlite3
|
|
in the configuration file and to create the sqlite3 index issue command:
|
|
.Command index Ar ACCOUNT_NAME Ns
|
|
To search in the message body type your keywords without any special formatting.
|
|
To search in specific fields, prepend your search keyword with "field:" like so:
|
|
.Pp
|
|
.D1 subject:helloooo or subject:\&"call for help\&" or \&"You remind me today of a small, Mexican chihuahua.\&"
|
|
.Pp
|
|
.D1 not ((from:unrealistic and (to:complex or not "query")) or flags:seen,draft)
|
|
.Pp
|
|
.D1 alladdresses:mailing@example.com and cc:me@example.com
|
|
.Pp
|
|
Boolean operators are
|
|
.Em or Ns
|
|
,
|
|
.Em and
|
|
and
|
|
.Em not
|
|
.Po
|
|
alias:
|
|
.Em \&!
|
|
.Pc
|
|
String keywords with spaces must be quoted.
|
|
Quotes should always be escaped.
|
|
.Ss Important Notice about IMAP/JMAP
|
|
.HorizontalRule
|
|
To prevent downloading all your messages from your IMAP/JMAP server, don't set
|
|
.Em search_backend
|
|
to
|
|
.Em sqlite3 Ns
|
|
\&.
|
|
.Nm
|
|
will relay your queries to the IMAP server.
|
|
Expect a delay between query and response.
|
|
Sqlite3 on the contrary at reasonable mailbox sizes should have a non noticeable delay.
|
|
.Ss QUERY ABNF SYNTAX
|
|
.HorizontalRule
|
|
.Bl -dash -compact
|
|
.It
|
|
.Li query = \&"(\&" query \&")\&" | from | to | cc | bcc | alladdresses | subject | flags | has_attachments | query \&"or\&" query | query \&"and\&" query | not query
|
|
.It
|
|
.Li not = \&"not\&" | \&"!\&"
|
|
.It
|
|
.Li quoted = ALPHA / SP *(ALPHA / DIGIT / SP)
|
|
.It
|
|
.Li term = ALPHA *(ALPHA / DIGIT) | DQUOTE quoted DQUOTE
|
|
.It
|
|
.Li tagname = term
|
|
.It
|
|
.Li flagval = \&"passed\&" | \&"replied\&" | \&"seen\&" | \&"read\&" | \&"junk\&" | \&"trash\&" | \&"trashed\&" | \&"draft\&" | \&"flagged\&" | tagname
|
|
.It
|
|
.Li flagterm = flagval | flagval \&",\&" flagterm
|
|
.It
|
|
.Li from = \&"from:\&" term
|
|
.It
|
|
.Li to = \&"to:\&" term
|
|
.It
|
|
.Li cc = \&"cc:\&" term
|
|
.It
|
|
.Li bcc = \&"bcc:\&" term
|
|
.It
|
|
.Li alladdresses = \&"alladdresses:\&" term
|
|
.It
|
|
.Li subject = \&"subject:\&" term
|
|
.It
|
|
.Li flags = \&"flags:\&" flag | \&"tags:\&" flag | \&"is:\&" flag
|
|
.El
|
|
.Sh FLAGS
|
|
.Nm
|
|
supports the basic maildir flags: passed, replied, seen, trashed, draft and flagged.
|
|
Flags can be searched with the
|
|
.Ns Ql flags:
|
|
prefix in a search query, and can be modified by
|
|
.Command flag set FLAG
|
|
and
|
|
.Command flag unset FLAG
|
|
.Sh TAGS
|
|
.Nm
|
|
supports tagging in notmuch and IMAP/JMAP backends.
|
|
Tags can be searched with the
|
|
.Ns Ql tags:
|
|
or
|
|
.Ns Ql flags:
|
|
prefix in a search query, and can be modified by
|
|
.Command tag add TAG
|
|
and
|
|
.Command tag remove TAG
|
|
(see
|
|
.Xr meli.conf 5 TAGS Ns
|
|
, settings
|
|
.Ic colors
|
|
and
|
|
.Ic ignore_tags
|
|
for how to set tag colors and tag visibility)
|
|
.Sh COMPOSING
|
|
.Ss Opening the message Composer tab
|
|
To create a new mail message, press
|
|
.Shortcut m listing new_mail
|
|
while viewing a mailbox.
|
|
To reply to a mail, press
|
|
.ShortcutPeriod R envelope_view reply
|
|
\&.
|
|
Both these actions open the mail composer view in a new tab.
|
|
.Ss Editing text
|
|
.HorizontalRule
|
|
.Bl -dash -compact
|
|
.It
|
|
Edit the header fields by selecting with the arrow keys and pressing
|
|
.Shortcut Enter general focus_in_text_field
|
|
to enter
|
|
.Em INSERT
|
|
mode and
|
|
.Cm Esc
|
|
key to exit.
|
|
.It
|
|
At any time you may press
|
|
.Shortcut e composing edit Ns
|
|
to launch your editor (see
|
|
.Xr meli.conf 5 COMPOSING Ns
|
|
, setting
|
|
.Ic editor_command
|
|
for how to select which editor to launch).
|
|
.It
|
|
Your editor can be used in
|
|
.Nm Ns
|
|
\&'s embed terminal emulator by setting
|
|
.Ic embed
|
|
to
|
|
.Em true
|
|
in your composing settings
|
|
.Po
|
|
You can return to
|
|
.Nm
|
|
at any time by pressing
|
|
.Aq Ctrl-Z
|
|
.Pc
|
|
.It
|
|
When launched, your editor captures all input until it exits or stops.
|
|
.It
|
|
To stop your editor and return to
|
|
.Nm
|
|
press
|
|
.Aq Ctrl-z
|
|
and to resume editing press the
|
|
.Ic edit
|
|
command again.
|
|
.El
|
|
.Ss Attachments
|
|
.HorizontalRule
|
|
Attachments may be handled with the
|
|
.Cm add-attachment Ns
|
|
,
|
|
.Cm remove-attachment
|
|
commands (see below).
|
|
.Ss Sending
|
|
.HorizontalRule
|
|
Finally, pressing
|
|
.Shortcut s composing send_mail
|
|
will send your message according to your settings
|
|
.Po
|
|
see
|
|
.Xr meli.conf 5 COMPOSING Ns
|
|
, setting name
|
|
.Ic send_mail
|
|
.Pc Ns
|
|
\&.
|
|
With no Draft or Sent mailbox,
|
|
.Nm
|
|
tries first saving mail in your INBOX and then at any other mailbox.
|
|
On complete failure to save your draft or sent message it will be saved in your
|
|
.Em tmp
|
|
directory instead and you will be notified of its location.
|
|
.Ss Drafts
|
|
.HorizontalRule
|
|
To save your draft without sending it, issue
|
|
.Em COMMAND
|
|
.Cm close
|
|
and select 'save as draft'.
|
|
.sp
|
|
To open a draft for further editing, select your draft in the mail listing and press
|
|
.Ic edit Ns
|
|
\&.
|
|
.Sh CONTACTS
|
|
.Nm
|
|
supports three kinds of contact backends:
|
|
.Bl -enum -compact
|
|
.It
|
|
an internal format that gets saved under
|
|
.Pa $XDG_DATA_HOME/meli/account_name/addressbook Ns
|
|
\&.
|
|
.It
|
|
vCard files (v3, v4) through the
|
|
.Ic vcard_folder
|
|
option in the account section.
|
|
The path defined as
|
|
.Ic vcard_folder
|
|
can hold multiple vCards per file.
|
|
They are loaded read only.
|
|
.It
|
|
a
|
|
.Xr mutt 1
|
|
compatible alias file in the option
|
|
.Ic mutt_alias_file
|
|
.El
|
|
.sp
|
|
See
|
|
.Xr meli.conf 5 ACCOUNTS
|
|
for the complete account contact configuration values.
|
|
.Sh MODES
|
|
.Bl -tag -compact -width 8n
|
|
.It NORMAL
|
|
is the default mode
|
|
.It COMMAND
|
|
commands are issued in
|
|
.Em COMMAND
|
|
mode, by default started with
|
|
.Shortcut \&: general enter_command_mode
|
|
and exited with
|
|
.Aq Esc
|
|
key.
|
|
.It EMBED
|
|
is the mode of the embed terminal emulator
|
|
.It INSERT
|
|
captures all input as text input, and is exited with
|
|
.Cm Esc
|
|
key.
|
|
.El
|
|
.Sh COMMAND
|
|
.Ss Mail listing commands
|
|
.HorizontalRule
|
|
.Bl -tag -width 36n
|
|
.It Cm set Ar plain | threaded | compact | conversations
|
|
set the way mailboxes are displayed
|
|
.El
|
|
.TS
|
|
allbox tab(:);
|
|
lb l.
|
|
conversations:shows one entry per thread
|
|
compact:shows one row per thread
|
|
threaded:shows threads as a tree structure
|
|
plain:shows one row per mail, regardless of threading
|
|
.TE
|
|
.Bl -tag -width 36n
|
|
.It Cm sort Ar subject | date \ Ar asc | desc
|
|
sort mail listing
|
|
.It Cm subsort Ar subject | date \ Ar asc | desc
|
|
sorts only the first level of replies.
|
|
.It Cm go Ar n
|
|
where
|
|
.Ar n
|
|
is a mailbox prefixed with the
|
|
.Ar n
|
|
number in the side menu for the current account
|
|
.It Cm toggle thread_snooze
|
|
don't issue notifications for thread under cursor in thread listing
|
|
.It Cm search Ar STRING
|
|
search mailbox with
|
|
.Ar STRING
|
|
query.
|
|
Escape exits search results.
|
|
.It Cm select Ar STRING
|
|
select threads matching
|
|
.Ar STRING
|
|
query.
|
|
.It Cm clear-selection
|
|
Clear current selection.
|
|
.It Cm set seen, set unseen
|
|
Set seen status of message.
|
|
.It Cm import Ar FILEPATH Ar MAILBOX_PATH
|
|
Import mail from file into given mailbox.
|
|
.It Cm copyto, moveto Ar MAILBOX_PATH
|
|
Copy or move to other mailbox.
|
|
.It Cm copyto, moveto Ar ACCOUNT Ar MAILBOX_PATH
|
|
Copy or move to another account's mailbox.
|
|
.It Cm delete
|
|
Delete selected threads.
|
|
.It Cm export-mbox Ar FILEPATH
|
|
Export selected threads to mboxcl2 file.
|
|
.It Cm create\-mailbox Ar ACCOUNT Ar MAILBOX_PATH
|
|
create mailbox with given path.
|
|
Be careful with backends and separator sensitivity (eg IMAP)
|
|
.It Cm subscribe\-mailbox Ar ACCOUNT Ar MAILBOX_PATH
|
|
subscribe to mailbox with given path
|
|
.It Cm unsubscribe\-mailbox Ar ACCOUNT Ar MAILBOX_PATH
|
|
unsubscribe to mailbox with given path
|
|
.It Cm rename\-mailbox Ar ACCOUNT Ar MAILBOX_PATH_SRC Ar MAILBOX_PATH_DEST
|
|
rename mailbox
|
|
.It Cm delete\-mailbox Ar ACCOUNT Ar MAILBOX_PATH
|
|
deletes mailbox in the mail backend.
|
|
This action is irreversible.
|
|
.El
|
|
.Ss Mail view commands
|
|
.HorizontalRule
|
|
.Bl -tag -width 36n
|
|
.It Cm pipe Ar EXECUTABLE Ar ARGS
|
|
pipe pager contents to binary
|
|
.It Cm filter Ar EXECUTABLE Ar ARGS
|
|
filter and display pager contents through command
|
|
.It Cm list-post
|
|
post in list of viewed envelope
|
|
.It Cm list-unsubscribe
|
|
unsubscribe automatically from list of viewed envelope
|
|
.It Cm list-archive
|
|
open list archive with
|
|
.Cm xdg-open
|
|
.El
|
|
.Ss Composing mail commands
|
|
.HorizontalRule
|
|
.Bl -tag -width 36n
|
|
.It Cm mailto Ar MAILTO_ADDRESS
|
|
Opens a composer tab with initial values parsed from the
|
|
.Li mailto:
|
|
address.
|
|
.It Cm add-attachment Ar PATH
|
|
in composer, add
|
|
.Ar PATH
|
|
as an attachment
|
|
.It Cm add-attachment < Ar CMD Ar ARGS
|
|
in composer, pipe
|
|
.Ar CMD Ar ARGS
|
|
output into an attachment
|
|
.It Cm add-attachment-file-picker
|
|
Launch command defined in the configuration value
|
|
.Ic file_picker_command
|
|
in
|
|
.Xr meli.conf 5 TERMINAL
|
|
.It Cm add-attachment-file-picker < Ar CMD Ar ARGS
|
|
Launch command
|
|
.Ar CMD Ar ARGS Ns
|
|
\&.
|
|
The command should print file paths in stderr, separated by NULL bytes.
|
|
.It Cm remove-attachment Ar INDEX
|
|
remove attachment with given index
|
|
.It Cm toggle sign
|
|
toggle between signing and not signing this message.
|
|
If the gpg invocation fails then the mail won't be sent.
|
|
See
|
|
.Xr meli.conf 5 PGP
|
|
for PGP configuration.
|
|
.It Cm save-draft
|
|
saves a copy of the draft in the Draft folder
|
|
.El
|
|
.Ss Generic commands
|
|
.HorizontalRule
|
|
.Bl -tag -width 36n
|
|
.It Cm open-in-tab
|
|
opens envelope view in new tab
|
|
.It Cm close
|
|
closes closeable tabs
|
|
.It Cm setenv Ar KEY=VALUE
|
|
set environment variable
|
|
.Ar KEY
|
|
to
|
|
.Ar VALUE
|
|
.It Cm printenv Ar KEY
|
|
print environment variable
|
|
.Ar KEY
|
|
.It Cm quit
|
|
Quits
|
|
.Nm Ns
|
|
\&.
|
|
.It Cm reload-config
|
|
Reloads configuration but only if account configuration is unchanged.
|
|
Useful if you want to reload some settings without restarting
|
|
.Nm Ns
|
|
\&.
|
|
.El
|
|
.Sh EXIT STATUS
|
|
.Nm
|
|
exits with 0 on a successful run.
|
|
Other exit statuses are:
|
|
.Bl -tag -width 5n
|
|
.It 1
|
|
catchall for general errors
|
|
.It 101
|
|
process panic
|
|
.El
|
|
.Sh ENVIRONMENT
|
|
.Bl -tag -width "$XDG_CONFIG_HOME/meli/plugins/*" -offset indent
|
|
.It Ev EDITOR
|
|
Specifies the editor to use
|
|
.It Ev MELI_CONFIG
|
|
Override the configuration file
|
|
.It Ev NO_COLOR
|
|
When defined (regardless of its value), prevents the addition of
|
|
.Tn ANSI
|
|
color.
|
|
The configuration value
|
|
.Ic use_color
|
|
overrides this.
|
|
.El
|
|
.Sh FILES
|
|
.Nm
|
|
uses the following parts of the XDG standard:
|
|
.Bl -tag -width "$XDG_CONFIG_HOME/meli/plugins/*" -offset indent
|
|
.It Ev XDG_CONFIG_HOME
|
|
defaults to
|
|
.Pa ~/.config/
|
|
.It Ev XDG_CACHE_HOME
|
|
defaults to
|
|
.Pa ~/.cache/
|
|
.El
|
|
.Pp
|
|
and appropriates the following locations:
|
|
.Bl -tag -width "$XDG_CONFIG_HOME/meli/plugins/*" -offset indent
|
|
.It Pa $XDG_CONFIG_HOME/meli/
|
|
User configuration directory
|
|
.It Pa $XDG_CONFIG_HOME/meli/config.toml
|
|
User configuration file, see
|
|
.Xr meli.conf 5
|
|
for its syntax and values.
|
|
.It Pa $XDG_CONFIG_HOME/meli/hooks/*
|
|
Reserved for event hooks.
|
|
.It Pa $XDG_CONFIG_HOME/meli/plugins/*
|
|
Reserved for plugin files.
|
|
.It Pa $XDG_CACHE_HOME/meli/*
|
|
Internal cached data used by meli.
|
|
.It Pa $XDG_DATA_HOME/meli/*
|
|
Internal data used by meli.
|
|
.It Pa $XDG_DATA_HOME/meli/meli.log
|
|
Operation log.
|
|
.It Pa /tmp/meli/*
|
|
Temporary files generated by
|
|
.Nm Ns
|
|
\&.
|
|
.El
|
|
.Pp
|
|
Mailcap entries are searched for in the following files, in this order:
|
|
.Pp
|
|
.Bl -enum -compact -offset indent
|
|
.It
|
|
.Pa $XDG_CONFIG_HOME/meli/mailcap
|
|
.It
|
|
.Pa $XDG_CONFIG_HOME/.mailcap
|
|
.It
|
|
.Pa $HOME/.mailcap
|
|
.It
|
|
.Pa /etc/mailcap
|
|
.It
|
|
.Pa /usr/etc/mailcap
|
|
.It
|
|
.Pa /usr/local/etc/mailcap
|
|
.El
|
|
.Sh STANDARDS
|
|
.Bl -dash -compact
|
|
.It
|
|
.Rs
|
|
.%B XDG Base Directory Specification
|
|
.%O Version 0.8
|
|
.%A Waldo Bastian
|
|
.%A Allison Karlitskaya
|
|
.%A Lennart Poettering
|
|
.%A Johannes Löthberg
|
|
.%U https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html
|
|
.%D May 08, 2021
|
|
.Re
|
|
.It
|
|
.Rs
|
|
.%B maildir
|
|
.%A Daniel J. Bernstein
|
|
.%U https://cr.yp.to/proto/maildir.html
|
|
.%D 1995
|
|
.Re
|
|
.It
|
|
.Rs
|
|
.%B RFC1524 A User Agent Configuration Mechanism For Multimedia Mail Format Information
|
|
.%O mailcap file
|
|
.%I Legacy
|
|
.%D September 01, 1993
|
|
.%A Dr. Nathaniel S. Borenstein
|
|
.%U https://datatracker.ietf.org/doc/rfc1524/
|
|
.Re
|
|
.It
|
|
.Rs
|
|
.%B RFC2047 MIME (Multipurpose Internet Mail Extensions) Part Three: Message Header Extensions for Non-ASCII Text
|
|
.%I IETF
|
|
.%D November 01, 1996
|
|
.%A Keith Moore
|
|
.%U https://datatracker.ietf.org/doc/rfc2047/
|
|
.Re
|
|
.It
|
|
.Rs
|
|
.%B RFC2183 Communicating Presentation Information in Internet Messages: The Content-Disposition Header Field
|
|
.%I Legacy
|
|
.%D August 01, 1997
|
|
.%A Rens Troost
|
|
.%A Steve Dorner
|
|
.%A Keith Moore
|
|
.%U https://datatracker.ietf.org/doc/rfc2183/
|
|
.Re
|
|
.It
|
|
.Rs
|
|
.%B RFC2369 The Use of URLs as Meta-Syntax for Core Mail List Commands and their Transport through Message Header Fields
|
|
.%I Legacy
|
|
.%D July 01, 1998
|
|
.%A Joshua D. Baer
|
|
.%A Grant Neufeld
|
|
.%U https://datatracker.ietf.org/doc/rfc2369/
|
|
.Re
|
|
.It
|
|
.Rs
|
|
.%B RFC2426 vCard MIME Directory Profile
|
|
.%O vCard Version 3
|
|
.%I IETF
|
|
.%D September 01, 1998
|
|
.%A Frank Dawson
|
|
.%A Tim Howes
|
|
.%U https://datatracker.ietf.org/doc/rfc2426/
|
|
.Re
|
|
.It
|
|
.Rs
|
|
.%B RFC3156 MIME Security with OpenPGP
|
|
.%I IETF
|
|
.%D August 01, 2001
|
|
.%A Thomas Roessler
|
|
.%A Michael Elkins
|
|
.%A Raph Levien
|
|
.%A Dave Del Torto
|
|
.%U https://datatracker.ietf.org/doc/rfc3156/
|
|
.Re
|
|
.It
|
|
.Rs
|
|
.%B RFC3461 Simple Mail Transfer Protocol (SMTP) Service Extension for Delivery Status Notifications (DSNs)
|
|
.%I IETF
|
|
.%D January 23, 2003
|
|
.%A Keith Moore
|
|
.%U https://datatracker.ietf.org/doc/rfc3461/
|
|
.Re
|
|
.It
|
|
.Rs
|
|
.%B RFC3501 INTERNET MESSAGE ACCESS PROTOCOL - VERSION 4rev1
|
|
.%I IETF
|
|
.%D March 18, 2003
|
|
.%A Mark Crispin
|
|
.%U https://datatracker.ietf.org/doc/rfc3501/
|
|
.Re
|
|
.It
|
|
.Rs
|
|
.%B RFC3676 The Text/Plain Format and DelSp Parameters
|
|
.%I IETF
|
|
.%D February 19, 2004
|
|
.%A Randall Gellens
|
|
.%U https://datatracker.ietf.org/doc/rfc3676/
|
|
.Re
|
|
.It
|
|
.Rs
|
|
.%B RFC3691 Internet Message Access Protocol (IMAP) UNSELECT command
|
|
.%I IETF
|
|
.%D February 20, 2004
|
|
.%A Alexey Melnikov
|
|
.%U https://datatracker.ietf.org/doc/rfc3691/
|
|
.Re
|
|
.It
|
|
.Rs
|
|
.%B RFC3977 Network News Transfer Protocol (NNTP)
|
|
.%I IETF
|
|
.%D October 26, 2006
|
|
.%A Clive Feather
|
|
.%U https://datatracker.ietf.org/doc/rfc3977/
|
|
.Re
|
|
.It
|
|
.Rs
|
|
.%B RFC4549 Synchronization Operations for Disconnected IMAP4 Clients
|
|
.%I IETF
|
|
.%D June 16, 2006
|
|
.%A Alexey Melnikov
|
|
.%U https://datatracker.ietf.org/doc/rfc4549/
|
|
.Re
|
|
.It
|
|
.Rs
|
|
.%B RFC4616 The PLAIN Simple Authentication and Security Layer (SASL) Mechanism
|
|
.%I IETF
|
|
.%D August 31, 2006
|
|
.%A Kurt Zeilenga
|
|
.%U https://datatracker.ietf.org/doc/rfc4616/
|
|
.Re
|
|
.It
|
|
.Rs
|
|
.%B RFC4954 SMTP Service Extension for Authentication
|
|
.%I IETF
|
|
.%D July 23, 2007
|
|
.%A Rob Siemborski
|
|
.%A Alexey Melnikov
|
|
.%U https://datatracker.ietf.org/doc/rfc4954/
|
|
.Re
|
|
.It
|
|
.Rs
|
|
.%B RFC5321 Simple Mail Transfer Protocol
|
|
.%I IETF
|
|
.%D October 01, 2008
|
|
.%A Dr. John C. Klensin
|
|
.%U https://datatracker.ietf.org/doc/rfc5321/
|
|
.Re
|
|
.It
|
|
.Rs
|
|
.%B RFC5322 Internet Message Format
|
|
.%I IETF
|
|
.%D October 01, 2008
|
|
.%A Pete Resnick
|
|
.%U https://datatracker.ietf.org/doc/rfc5322/
|
|
.Re
|
|
.It
|
|
.Rs
|
|
.%B RFC6048 Network News Transfer Protocol (NNTP) Additions to LIST Command
|
|
.%I IETF
|
|
.%D November 22, 2010
|
|
.%A Julien ÉLIE
|
|
.%U https://datatracker.ietf.org/doc/rfc6048/
|
|
.Re
|
|
.It
|
|
.Rs
|
|
.%B RFC6152 SMTP Service Extension for 8-bit MIME Transport
|
|
.%I IETF
|
|
.%D March 07, 2011
|
|
.%A Dave Crocker
|
|
.%A Dr. John C. Klensin
|
|
.%A Dr. Marshall T. Rose
|
|
.%A Ned Freed
|
|
.%U https://datatracker.ietf.org/doc/rfc6152/
|
|
.Re
|
|
.It
|
|
.Rs
|
|
.%B RFC6350 vCard Format Specification
|
|
.%O vCard Version 4
|
|
.%I IETF
|
|
.%D August 31, 2011
|
|
.%A Simon Perreault
|
|
.%U https://datatracker.ietf.org/doc/rfc6350/
|
|
.Re
|
|
.It
|
|
.Rs
|
|
.%B RFC6532 Internationalized Email Headers
|
|
.%I IETF
|
|
.%D February 17, 2012
|
|
.%A Abel Yang
|
|
.%A Shawn Steele
|
|
.%A Ned Freed
|
|
.%U https://datatracker.ietf.org/doc/rfc6532/
|
|
.Re
|
|
.It
|
|
.Rs
|
|
.%B RFC6868 Parameter Value Encoding in iCalendar and vCard
|
|
.%I IETF
|
|
.%D February 14, 2013
|
|
.%A Cyrus Daboo
|
|
.%U https://datatracker.ietf.org/doc/rfc6868/
|
|
.Re
|
|
.It
|
|
.Rs
|
|
.%B RFC7162 IMAP Extensions: Quick Flag Changes Resynchronization (CONDSTORE) and Quick Mailbox Resynchronization (QRESYNC)
|
|
.%I IETF
|
|
.%D May 23, 2014
|
|
.%A Alexey Melnikov
|
|
.%A Dave Cridland
|
|
.%U https://datatracker.ietf.org/doc/rfc7162/
|
|
.Re
|
|
.It
|
|
.Rs
|
|
.%B RFC8620 The JSON Meta Application Protocol (JMAP)
|
|
.%I IETF
|
|
.%D July 18, 2019
|
|
.%A Neil Jenkins
|
|
.%A Chris Newman
|
|
.%U https://datatracker.ietf.org/doc/rfc8620/
|
|
.Re
|
|
.It
|
|
.Rs
|
|
.%B RFC8621 The JSON Meta Application Protocol (JMAP) for Mail
|
|
.%I IETF
|
|
.%D August 08, 2019
|
|
.%A Neil Jenkins
|
|
.%A Chris Newman
|
|
.%U https://datatracker.ietf.org/doc/rfc8621/
|
|
.Re
|
|
.El
|
|
.Sh SEE ALSO
|
|
.Xr meli.conf 5 ,
|
|
.Xr meli-themes 5 ,
|
|
.Xr meli 7 ,
|
|
.Xr xdg-open 1 ,
|
|
.Xr mailcap 5
|
|
.Sh AUTHORS
|
|
Copyright 2017\(en2024
|
|
.An Manos Pitsidianakis Aq Mt manos@pitsidianak.is
|
|
.Pp
|
|
Released under the GPL, version 3 or greater.
|
|
This software carries no warranty of any kind.
|
|
.Po
|
|
See
|
|
.Pa COPYING
|
|
for full copyright and warranty notices.
|
|
.Pc
|
|
.Ss Links
|
|
.Bl -item -compact
|
|
.It
|
|
.Lk https://meli\-email.org "Website"
|
|
.It
|
|
.Lk https://git.meli\-email.org/meli/meli "Main\ git\ repository\ and\ issue\ tracker"
|
|
.It
|
|
.Lk https://codeberg.org/meli/meli "Official\ read-only\ git\ mirror\ on\ codeberg.org"
|
|
.It
|
|
.Lk https://github.com/meli/meli "Official\ read-only\ git\ mirror\ on\ github.com"
|
|
.It
|
|
.Lk https://crates.io/crates/meli "meli\ crate\ on\ crates.io"
|
|
.El
|