email2fax 1.2 review

by on

License: GPL (GNU General Public License)
File size: 43K
Developer: Tomasz Chmielewski
0 stars award from

email2fax is a bash script that allows you to send a fax through your Asterisk PBX.

email2fax accepts emails with a PDF or a TIFF attachment, and faxes them through Asterisk to a number specified in a subject field of the email.

Here are some key features of "email2fax":
it expects to find a fax number in a subject field,
it expects to find one PDF or one TIFF attachment,
if these conditions are met, it converts an attachment to the right format, and passes it to Asterisk, and instructs it to send it to a specified number.

As mail2fax wasn't really user friendly (it didn't support PDF attachments; TIFF attachments had to be in a special format), I decidet to write my own implementation.

Currently, email2fax depends on AstFax - that means, a processed attachment (which needs to have a right format) is passed to AstFax, which then passes it to Asterisk.


- make sure your Asterisk box can receive faxes - Spandsp has to be set up correctly,
- download and extract email2fax package, don't forget about mpack and munpack, if you don't have them in the system (they are in the package)
- compose a sample message - attach a PDF file, and put a fax number in the subject field - save it on a disk as message.eml; copy it to your Asterisk box
- try to send your first fax from the command line:
cat message.eml | sudo -u asterisk email2fax --debug
- if it worked, congratulations, if not, make sure Spandsp is set up correctly (i.e., you are able to receive faxes), consult /var/log/asterisk/faxlog file, connect to asterisk console (sudo -u asterisk asterisk -crvvvvv), etc.
- if everything works, set up a .procmailrc for the asterisk user:

| /var/lib/asterisk/m2f/email2fax

and try to send this same email directly to asterisk@yourasteriskbox

What's New in This Release:
Handling multi-page TIFF files was fixed.
All *.call files should now have random names.

email2fax 1.2 keywords