email2pdf is a Python script to convert emails to PDF from the command-line.
It is not interactive (it doesn't run from a browser or have a GUI), but is
intended to be run as a mail delivery
agent - it won't retrieve
emails for you, but it will take them from standard input as an MDA will and
'deliver' them to PDF files. It is well-placed to use together with
getmail, perhaps run on a schedule
using cron or similar. You can also just
use it as a standalone utility to convert a raw email (normally an
.eml file) to a
email2pdf --help for more information on usage and options
For more information on hacking/developing email2pdf, please see HACKING.md. Note that use is subject to the license conditions.
Before you can use email2pdf, you need to install some dependencies. The instructions here are split out by platform:
wkhtmltopdf - Install the
.debfrom http://wkhtmltopdf.org/ rather than using apt-get to minimise the dependencies you need to install (in particular, to avoid needing a package manager).
getmail - getmail is optional, but it works well as a companion to email2pdf. Install using
apt-get install getmail.
Others - there are some other Python library dependencies. Run
make builddebto create a
.debpackage, then install it with
dpkg -i mydeb.deb. This will prompt you regarding any missing dependencies.
wkhtmltopdf - Install the package from http://wkhtmltopdf.org/downloads.html.
getmail - TODO: This hasn't been tested, so there are no instructions here yet! Note that getmail is optional.
xcode-select --install(for lxml, because of this)
brew install python3(or otherwise make sure you have Python 3 and
brew install libmagic
pip3 install -r requirements.txt
getmail is not strictly a dependency, but when it is combined with email2pdf,
it can be used to retrieve new emails from a remote IMAP server and
automatically convert them to PDFs locally. The
file in the repository can be used as a starting point for your own getmailrc
to do this. Note that the sample will need editing, of course - see the
getmail documentation for more information on that. Also, it is configured by
default to delete remote emails from the server once they are converted - be
careful with that. You might want to consider setting up your crontab
something like this:
@hourly getmail --verbose | logger
This will ensure that getmail is invoked hourly to fetch email, and log its output to syslog.
If your mailserver is unreliable, you might want to consider wrapping the getmail cron job with cromer.
I don't have any direct experience using procmail with email2pdf, so don't have any specific setup steps, although I understand it can be made to work. You should be aware that currently there is an outstanding issue with I/O encodings with procmail that you may need to work around - see issue #76 for more information.
Harvinderpal Ghotra has refactored email2pdf into a library, which may be helpful if you need to embed email2pdf-like functionality in a Python program (although there is no specific effort to keep these two projects in sync).