Scroll to navigation

ALOT(1) alot ALOT(1)


alot - Terminal MUA using notmuch mail


alot [options …] [subcommand]


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.


open notmuch database in read-only mode
configuration file (default: ~/.config/alot/config)
notmuch configuration file (default: $NOTMUCH_CONFIG or ~/.notmuch-config)
number of colours to use on the terminal; must be 1, 16 or 256 (default: configuration option colourmode or 256)
path to notmuch index
debug level; must be one of debug, info, warning or error (default: info)
log file (default: /dev/null)
display help and exit
output version information and exit


start in a search buffer using the query string provided as parameter (see notmuch-search-terms(7))
compose a new message
start with only a bufferlist buffer open
start with only a taglist buffer open
start with list of named queries
start the interactive python shell inside alot


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 keybindings for the current mode are listed upon pressing ?.


Refreshes the current buffer.
Shuts down the user interface.




Patrick Totzke


Copyright (C) 2012-20 Patrick Totzke

July 10, 2020 0.9.1