Manpage

Synopsis

alot [options ...] [subcommand]

Description

Alot is a terminal-based mail user agent for the notmuch mail system. It features a modular and command prompt driven interface to provide a full MUA experience as an alternative to the Emacs mode shipped with notmuch.

Options

-r, --read-only
 open db in read only mode
-c, --config=FILENAME
 config file (default: ~/.config/alot/config)
-n, --notmuch-config=FILENAME
 notmuch config (default: $NOTMUCH_CONFIG or ~/.notmuch-config)
-C, --colour-mode=COLOUR
 terminal colour mode (default: 256). Must be 1, 16 or 256
-p, --mailindex-path=PATH
 path to notmuch index
-d, --debug-level=LEVEL
 debug log (default: info). Must be one of debug,info,warning or error
-l, --logfile=FILENAME
 logfile (default: /dev/null)
-v, --version Display version string and exit
-h, --help Display help and exit

Commands

search
start in a search buffer using the querystring provided as parameter. See also notmuch-search-terms(7).
compose
compose a new message
bufferlist
start with only a bufferlist buffer open
taglist
start with only a taglist buffer open
pyshell
start the interactive python shell inside alot

Usage

The arrow keys, page-up/down, j, k and Space can be used to move the focus. Escape cancels prompts and Enter selects. Hit : at any time and type in commands to the prompt.

The interface shows one buffer at a time, you can use Tab and Shift-Tab to switch between them, close the current buffer with d and list them all with ;.

The buffer type or mode (displayed at the bottom left) determines which prompt commands are available. Usage information on any command can be listed by typing help YOURCOMMAND to the prompt; The key bindings for the current mode are listed upon pressing ?.

UNIX Signals

SIGUSR1
Refreshes the current buffer.
SIGINT
Shuts down the user interface.

See Also

notmuch(1)