summaryrefslogtreecommitdiff
path: root/INSTALL
blob: 8ed2eaebc9f78cd38c8afeabdf527278f4a4eb5b (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. 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. 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. 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:

  [account uoe]
  realname = Your Name
  address = your@address
  sendmail_command = msmtp
  sent_mailbox = maildir:///home/you/mail/Sent

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