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:
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.