Getting started on MacOS

Leopard 10.6.8

Mailpile depends on lxml, which is a binder for two C libraries (libxml2 and libxslt). The GCC compiler needs to be installed on your os for those dependencies to work but is unfortunately not included with MacOS 10.6.8.

Some people are using XCode (that comes with GCC), others skip downloading the massive XCode installer and use GCC packaged by Kenneth Reitz. Long story short, to install Mailpile you have to have the GCC compiler installed, however you do it, and install lxml when GCC has been successfully installed. You will find several discussion threads regarding this issue if you run into any problems.

Mavericks 10.9.1 (Step-by-Step)

Download and Install Xcode Command Line Tools:

xcode-select --install  

Download and Install PIP for Python:

cd /tmp  
curl -L -o get-pip.py https://raw.github.com/pypa/pip/master/contrib/get-pip.py  
sudo python get-pip.py  

Install latest version of ‘lxml’ using Static Dependencies:

sudo STATIC_DEPS=true pip install lxml  

OR install 'lxml' without pip, macports, or fink

cd /tmp  
curl -o lxml-3.3.0.tgz http://lxml.de/files/lxml-3.3.0.tgz  
tar -xzvf lxml-3.3.0.tgz  
cd lxml-3.3.0  
python setup.py build --static-deps --libxml2-version=2.8.0  --libxslt-version=1.1.24  
sudo python setup.py install

Clone and Install Mailpile (in user 'Sites' directory, but any directory will do):

cd ~/Sites  
git clone -b release/alpha https://github.com/pagekite/Mailpile.git  
cd Mailpile  
sudo pip install -r requirements.txt  

If you run into an error like

    clang: warning: unknown argument: '-mno-fused-madd' [-Wunused-command-line-argument-hard-error-in-future]

it is because you have a newer version of the Apple LLVM compiler in Xcode 5.1 that is stricter about flags, so prefix your build commands with this:

ARCHFLAGS=-Wno-error=unused-command-line-argument-hard-error-in-future 

e.g.,

ARCHFLAGS=-Wno-error=unused-command-line-argument-hard-error-in-future  python setup.py build --static-deps --libxml2-version=2.8.0  --libxslt-version=1.1.24  13ARCHFLAGS=-Wno-error=unused-command-line-argument-hard-error-in-future  python setup.py build --static-deps --libxml2-version=2.8.0  --libxslt-version=1.1.24  

and

sudo ARCHFLAGS=-Wno-error=unused-command-line-argument-hard-error-in-future  pip install -r requirements.txt

[UGLY HACK WARNING - Mailpile calls python2 when opening, but in OS X this binary/symbolic link does not exist, instead we call python or python2.X directly. For this reason, we must accommodate Mailpile by creating a symbolic link in the usr/bin/ directory ]

Create symbolic link from 'python2.7' to 'python2':

sudo ln -s /usr/bin/python2.7 /usr/bin/python2  

Finally - run Mailpile!

./mp  

See "Getting started on linux" for more information on setting up Mailpile for the first time.