meli/meli.1

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

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

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

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 can 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 can press e to
     launch your editor (see meli.conf(5) COMPOSING for how to select which
     editor to launch). Attachments can 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'.

     If there is 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.

EXECUTE mode
     Commands are issued in EXECUTE mode, by default started with the space
     character 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
                                                             plain          shows
                                                                            one
                                                                            row
                                                                            per
                                                                            mail,
                                                                            regardless
                                                                            of
                                                                            threading
                                                             threaded       shows
                                                                            threads
                                                                            as
                                                                            a
                                                                            tree
                                                                            structure,
                                                                            with
                                                                            one
                                                                            row
                                                                            per
                                                                            thread
                                                                            entry
                                                             conversations  shows
                                                                            one
                                                                            entry
                                                                            per
                                                                            thread
                                                             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.

     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
                                                                   currently
                                                                   viewed
                                                                   envelope

           list-unsubscribe                                        unsubscribe
                                                                   automatically
                                                                   from list
                                                                   of
                                                                   currently
                                                                   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

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

           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.

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

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⟩

Linux                            July 29, 2019                           Linux