meli/meli.1

12 KiB
Raw Blame History

MELI(1)                     General Commands Manual                    MELI(1)

NAME
     meli  Meli Mail User Agent. meli is the Greek word for honey

SYNOPSIS
     meli [--help | -h] [--version | -v] [--create-config [path]]
          [--test-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

           --test-config [path]
                 Test a configuration file for syntax issues or missing
                 options.

           --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. See meli.conf(5) for the available configuration
     options.

     At any time, you may 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 may be toggled with ` (shortcuts.listing:
     toggle_menu_visibility).

     The view into each folder has 4 modes: plain, threaded, conversations and
     compact. Plain views each mail indvidually, threaded shows their thread
     relationship visually, and conversations includes one entry per thread of
     emails (compact is one row per thread).

     If you're using a light color palette in your terminal, you may set theme
     = light in the terminal section of your configuration.

              ^^      .-=-=-=-.  ^^
          ^^        (`-=-=-=-=-`)         ^^
                  (`-=-=-=-=-=-=-`)  ^^         ^^
            ^^   (`-=-=-=-=-=-=-=-`)   ^^
                ( `-=-=-=-(@)-=-=-` )      ^^
                (`-=-=-=-=-=-=-=-=-`)  ^^
                (`-=-=-=-=-=-=-=-=-`)          ^^
                (`-=-=-=-=-=-=-=-=-`)
         ^^     (`-=-=-=-=-=-=-=-=-`)  ^^
            ^^   (`-=-=-=-=-=-=-=-`)          ^^
                  (`-=-=-=-=-=-=-`)  ^^
           ^^       (`-=-=-=-=-`)
                     `-=-=-=-=-`          ^^

VIEWING MAIL
     Open attachments by typing their index in the attachments list and then
     a.  meli will attempt to open text inside its pager and other content via
     xdg-open. Press m instead to use the mailcap entry for the MIME type of
     the attachment, if any. See FILES for the location of the mailcap files
     and mailcap(5) for their syntax.

SEARCH
     Each e-mail storage backend has its default search method.  IMAP uses the
     SEARCH command, notmuch uses libnotmuch and Maildir/mbox have to do a
     slow linear search. Thus it is advised to use a cache on Maildir/mbox
     accounts.  meli, if built with sqlite3, includes the ability to perform
     full text search on the following fields: From, To, Cc, Bcc, In-Reply-To,
     References, Subject and 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 cache_type to sqlite3 in the configuration
     file and to create the sqlite3 index issue command index ACCOUNT_NAME.

     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:

           subject:helloooo or subject:"call for help" or "You remind me today
           of a small, Mexican chihuahua."

           not ((from:unrealistic and (to:complex or not query )) or
           flags:seen,draft)

           alladdresses:mailing@list.tld and cc:me@domain.tld

     Boolean operators are or, and and not (alias: !) String keywords with
     spaces must be quoted. Quotes should always be escaped.

     Important Notice about IMAP

     To prevent downloading all your messages from your IMAP server, don't set
     cache_type to sqlite3.  meli 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 noticable delay.

TAGS
     meli supports tagging in notmuch and IMAP backends. Tags can be searched
     with the `tags:` or `flags:` prefix in a search query, and can be
     modified by tag add TAG and tag remove TAG (see meli.conf(5) TAGS,
     settings colors and ignore_tags for how to set tag colors and tag
     visiblity)

COMPOSING
     To send mail, press m while viewing the appropriate account to open a new
     composing tab. To reply to a mail, press R. You may edit some of the
     header fields from within the view, by selecting with the arrow keys and
     pressing enter to enter INSERT mode. At any time you may press e to
     launch your editor (see meli.conf(5) COMPOSING, setting editor_cmd for
     how to select which editor to launch). Attachments may be handled with
     the add-attachment, remove-attachment commands (see below). Finally,
     pressing s will send your message by piping it into a binary of your
     choosing (see meli.conf(5) COMPOSING, setting mailer_cmd). To save your
     draft without sending it, issue command close and select 'save as draft'.

     With no Draft or Sent folder, meli tries first saving mail in your INBOX
     and then at any other folder. On complete failure to save your draft or
     sent message it will be saved in your tmp directory instead and you will
     be notified of its location.

     To open a draft for editing later, select your draft in the mail listing
     and press e.

     Your editor can be used in meli's embed terminal emulator by setting
     embed to true in your composing settings. When launched, your editor
     captures all input until it exits or stops. To stop your editor and
     return to meli issue Ctrl-z and to resume editing press the edit_mail
     command again (default e).

CONTACTS
     meli supports two kinds of contact backends:

           1.   an internal format that gets saved under
                $XDG_DATA_HOME/meli/account_name/addressbook.
           2.   vCard files (v3, v4) through the vcard_folder option in the
                account section. The path defined as vcard_folder can hold
                multiple vCards per file. They are loaded read only.

     See meli.conf(5) ACCOUNTS for the complete account configuration values.

EXECUTE mode
     Commands are issued in EXECUTE mode, by default started with Space and
     exited with Escape key.

     the following commands are valid in the mail listing context:

     set plain | threaded | compact | conversations
                                           set the way mailboxes are displayed
     ┌──────────────┬─────────────────────────────────────────────────┐
     │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 │
     └──────────────┴─────────────────────────────────────────────────┘
     sort subject | date   asc | desc      sort mail listing

     subsort subject | date   asc | desc   sorts only the first level of
                                           replies.

     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

     set read, set unread

     create-folder ACCOUNT FOLDER_PATH     create folder with given path. be
                                           careful with backends and separator
                                           sensitivity (eg IMAP)

     subscribe-folder ACCOUNT FOLDER_PATH  subscribe to folder with given path

     unsubscribe-folder ACCOUNT FOLDER_PATH
                                           unsubscribe to folder with given
                                           path

     rename-folder ACCOUNT FOLDER_PATH_SRC FOLDER_PATH_DEST
                                           rename folder

     delete-folder ACCOUNT FOLDER_PATH     delete folder

     envelope view commands:

     pipe EXECUTABLE ARGS                  pipe pager contents to binary

     list-post                             post in list of viewed envelope

     list-unsubscribe                      unsubscribe automatically from list
                                           of viewed envelope

     list-archive                          open list archive with xdg-open

     composing mail commands:

     add-attachment PATH                   in composer, add PATH as an
                                           attachment

     remove-attachment INDEX               remove attachment with given index

     toggle sign                           toggle between signing and not
                                           signing this message. If the gpg
                                           invocation fails then the mail
                                           won't be sent.

     generic commands:

     open-in-tab                           opens envelope view in new tab

     close                                 closes closeable tabs

     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

     toggle-menu-visibility                '`'

     select                                'v'

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

     nm                                    opens the nth attachment according
                                           to its mailcap entry.

     v                                     (un)selects mail entries in mail
                                           listings

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. See
                                            meli.conf(5) for its syntax and
                                            values.

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

           $XDG_DATA_HOME/meli/*            Internal data used by meli.

           $XDG_DATA_HOME/meli/meli.log     Operation log.

           /tmp/meli/*                      Temporary files generated by meli.

     Mailcap entries are searched for in the following files, in this order:

           1.   $XDG_CONFIG_HOME/meli/mailcap
           2.   $XDG_CONFIG_HOME/.mailcap
           3.   $HOME/.mailcap
           4.   /etc/mailcap
           5.   /usr/etc/mailcap
           6.   /usr/local/etc/mailcap

SEE ALSO
     meli.conf(5), xdg-open(1), mailcap(5)

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

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⟩

Debian                           July 29, 2019                          Debian