1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
|
Installation
************
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.
.. note::
Alot uses `mailcap <http://en.wikipedia.org/wiki/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:
* `libmagic and python bindings <http://darwinsys.com/file/>`_, ≥ `5.04`
* `configobj <http://www.voidspace.org.uk/python/configobj.html>`_, ≥ `4.7.0`
* `libnotmuch <http://notmuchmail.org/>`_ and it's python bindings, ≥ `0.27`
* `urwid <http://excess.org/urwid/>`_ toolkit, ≥ `1.3.0`
* `gpg <http://www.gnupg.org/related_software/gpgme>`_ and it's python bindings, ≥ `1.9.0`
* `twisted <https://twistedmatrix.com>`_, ≥ `18.4.0`
On Debian/Ubuntu these are packaged as::
python3-setuptools python3-magic python3-configobj python3-notmuch python3-urwid python3-gpg python3-twisted
On Fedora/Redhat these are packaged as::
python-setuptools python-magic python-configobj python-notmuch python-urwid python-gpg python-twisted
To set up and install the latest development version::
git clone https://github.com/pazz/alot
./setup.py 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 <http://sphinx.pocoo.org/>`_, ≥ `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`.
In order to remove the command docs and automatically re-generate them from inline docstrings, use the make target `cleanall`, as in::
make -C docs cleanall html
.. note:: On Debian you need to overide the variable `PYTHON` used in the makefile
so that it uses "python3", not "python", which by default links to
version 2.7* of the interpreter.
::
make PYTHON="python3" -C docs cleanall html
|