Fetching contributors…
Cannot retrieve contributors at this time
63 lines (39 sloc) 2.27 KB


These days, alot can be installed directly using your favourite package manager. On a recent Debian (-derived) systems for instance, just do sudo apt install alot and you're done.


Alot uses mailcap to look up mime-handler for inline rendering and opening of attachments. To avoid surprises you should at least have an inline renderer (copiousoutput) set up for text/html in your :file:`~/.mailcap`:

text/html;  w3m -dump -o document_charset=%{charset} '%s'; nametemplate=%s.html; copiousoutput

See the manpage :manpage:`mailcap(5)` or RFC 1524 for more details on your mailcap setup.

Manual installation

Alot depends on recent versions of notmuch and urwid. Note that due to restrictions on argparse and subprocess, you need to run python ≥ 3.5 (see :ref:`faq <faq_7>`). A full list of dependencies is below:

On Debian/Ubuntu these are packaged as:

python3-setuptools python3-magic python3-configobj python3-notmuch python3-urwid python3-urwidtrees python3-gpg

On Fedora/Redhat these are packaged as:

python-setuptools python-magic python-configobj python-notmuch python-urwid python-urwidtrees python-gpg

To set up and install the latest development version:

git clone
./ develop --user

Make sure :file:`~/.local/bin` is in your :envvar:`PATH`. For system-wide installation omit the --user flag and call with the respective permissions.

Generating the Docs

This requires sphinx, ≥ 1.3 to be installed. To generate the documentation from the source directory simply do:

make -C docs html

A man page can be generated using:

make -C docs man

Both will end up in their respective subfolders in :file:`docs/build`.