summaryrefslogtreecommitdiff
path: root/INSTALL.md
blob: e5ef3937285215ace6b306c96b89b8045531c9f0 (plain)
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
INSTALL
=======

Alot depends on recent versions of notmuch (>=0.10) and urwid (>=1.0). Note that due to restrictions
on argparse and subprocess, you need to run *python v>=2.7*, which only recently made it
into debian testing.

urwid
-----
make sure you have urwid v >=1.0. It is available on debian (wheezy)
and in *buntu 12.04. To install from git use:

    git clone http://github.com/wardi/urwid
    cd urwid
    sudo python setup.py install

It seems you need the python headers for this. On debian/ubuntu:

    aptitude install python2.7-dev


notmuch
-------
install notmuch *and* python bindings from git:

    git clone git://notmuchmail.org/git/notmuch

    cd notmuch
    ./configure
    make
    sudo make install
    cd bindings/python
    python setup.py install --user


alot
----
get alot and install it from git:

    git clone git://github.com/pazz/alot alot
    cd alot
    python setup.py install --user
    make sure `~/.local/bin` is in your path.


other dependencies
------------------
 * python-magic (python bindings to the file(1) utility)
 * a mailcap file (I recommend installing 'mime-support' on debian/ubuntu).


All configs are optional, but if you want to send mails you need to specify at least one
account section in your config:

    [account uoe]
    realname = Your Name
    address = your@address

See `CUSTOMIZE.md` on how to do fancy customization.