NAME

meliMeli Mail User Agent. meli is the Greek word for honey.

SYNOPSIS

meli [--help | -h] [--version | -v] [--create-config [path]] [--config path]

DESCRIPTION

Experimental terminal mail client
--help, -h
Show help message and exit.
--version, -v
Show version and exit.
--create-config [path]
Create configuration file in path if given, or at $XDG_CONFIG_HOME/meli/config
--config path
Start meli with given configuration file.

STARTING WITH meli

When launched for the first time, meli will search for its configuration directory, $XDG_CONFIG_HOME/meli/. If it doesn't exist, you will be asked if you want to create one along with a sample configuration. The sample configuration $XDG_CONFIG_HOME/meli/config includes comments with the basic settings required for setting up accounts allowing you to copy and edit right away.
At any time, you can press ? to show a searchable list of all available actions and shortcuts, along with every possible setting and command that your version supports.
The main visual navigation tool is the left-side sidebar. The menu's visibility can be toggled (default shortcut `).
The view into each folder has 3 modes: plain, threaded and compact. Plain views each mail indvidually, threaded shows their thread relationship visually, and compact includes one entry per thread of emails.
         ^^      .-=-=-=-.  ^^ 
     ^^        (`-=-=-=-=-`)         ^^ 
             (`-=-=-=-=-=-=-`)  ^^         ^^ 
       ^^   (`-=-=-=-=-=-=-=-`)   ^^ 
           ( `-=-=-=-(@)-=-=-` )      ^^ 
           (`-=-=-=-=-=-=-=-=-`)  ^^ 
           (`-=-=-=-=-=-=-=-=-`)          ^^ 
           (`-=-=-=-=-=-=-=-=-`) 
    ^^     (`-=-=-=-=-=-=-=-=-`)  ^^ 
       ^^   (`-=-=-=-=-=-=-=-`)          ^^ 
             (`-=-=-=-=-=-=-`)  ^^ 
      ^^       (`-=-=-=-=-`) 
                `-=-=-=-=-`          ^^

EXECUTE mode

Commands are issued in EXECUTE mode, by default started with the space character and exited with Escape key.
set plain | threaded | compact
set the way mailboxes are displayed
plain
shows one row per mail, regardless of threading
threaded
shows threads as a tree structure, with one row per thread entry
compact
shows one row per thread
sort subject | date   asc | desc
sort mail listing
subsort subject | date   asc | desc
sorts only the first level of replies.
close
closes closeable tabs
go n
where n is a mailbox prefixed with the n number in the side menu for the current account
toggle_thread_snooze
don't issue notifications for thread under cursor in thread listing
filter STRING
filter mailbox with STRING key. Escape exits filter results
list-post
post in list of currently viewed envelope
list-unsubscribe
unsubscribe automatically from list of currently viewed envelope
list-archive
open list archive with xdg-open
set read, set unread
setenv KEY=VALUE
set environment variable KEY to VALUE
printenv KEY
print environment variable KEY

SHORTCUTS

Non-complete list of shortcuts and their default values.
open_thread
'\n'
exit_thread
'i'
create_contact
'c'
edit_contact
'e'
prev_page
PageUp,
next_page
PageDown
prev_folder
'K'
next_folder
'J'
prev_account
'l'
next_account
'h'
new_mail
'm'
scroll_up
'k'
scroll_down
'j'
page_up
PageUp
page_down
PageDown
`
toggles hiding of sidebar in mail listings
?
opens up a shortcut window that shows available actions in the current component you are using (eg mail listing, contact list, mail composing)
m
starts a new mail composer
R
replies to the currently viewed mail.
u
displays numbers next to urls in the body text of an email and ng opens the nth url with xdg-open
na
opens the nth attachment.

EXIT STATUS

meli exits with 0 on a successful run. Other exit statuses are:
1
catchall for general errors

ENVIRONMENT

EDITOR
Specifies the editor to use
MELI_CONFIG
Override the configuration file

FILES

meli uses the following parts of the XDG standard:
XDG_CONFIG_HOME
defaults to ~/.config/
XDG_CACHE_HOME
defaults to ~/.cache/
and appropriates the following locations:
$XDG_CONFIG_HOME/meli/
User configuration directory.
$XDG_CONFIG_HOME/meli/config
User configuration file.
$XDG_CONFIG_HOME/meli/hooks/*
Reserved for event hooks.
$XDG_CONFIG_HOME/meli/plugins/*
Reserved for plugin files.
$XDG_CACHE_HOME/meli/*
Internal cached data used by meli.
/tmp/meli/*
Temporary files generated by meli.

SEE ALSO

xdg-open(1)

CONFORMING TO

XDG Standard ⟨https://standards.freedesktop.org/basedir-spec/basedir-spec-latest.html⟩, maildir ⟨https://cr.yp.to/proto/maildir.html⟩

AUTHORS

Copyright 2017-2019 Manos Pitsidianakis ⟨epilys@nessuent.xyz⟩ Released under the GPL, version 3 or greater. This software carries no warranty of any kind. (See COPYING for full copyright and warranty notices.)
⟨https://meli.delivery⟩