summaryrefslogtreecommitdiff
path: root/INSTALL
blob: 786c6fb4c96b63d8d505b80334e7e6d4187758f3 (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
INSTALL
=======

Alot depends on development versions of notmuch and urwid.
Note that due to restrictions on argparse and subprocess,
you need to run *python v>=2.7*.

1. urwid
--------
make sure you have urwid V>= 1.0

    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

2. 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
    sudo python setup.py install

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

    git clone git://github.com/pazz/alot alot
    cd alot
    sudo python setup.py install

That's it, now `alot` should be in your path.

Alot tries to be as unobtrusive as possible, with one exception:
It forces you to use UTF-8 encoding whereever it can:
All text parts and headers of outgoing emails are converted to utf-8,
notmuch tagstrings, edited emails and config files are interpreted as utf-8.

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

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

See USAGE for default keymaps and how to do fancy customization.