email2fax and Asterisk to do eFaxing

It's basically free bash shell script available from: http://wpkg.org/email2fax/index.php/Main_Page

Make sure you have the required tools:

  1. libtiff
  2. ghostscript
  3. mpack/munpack

Where you can e-mail your Asterisk box and it will fax it to the phone number in the subject line.  The good news ends there, it is fairly undocumented and buggy.

Take for example how the documentation mentions you can invoke from the command line like this:

cat "somefile.eml"|email2fax --nodebug

Instead it keeps displaying the help message, I guess this is an oversight but this is supposed to be the stable version.

email2fax
email2fax v1.2beta, email to fax gateway for Asterisk

Usage:

"piped message" | email2fax [OPTIONS]

Options:
--nomail        don't send a confirmation email (default: send confirmation email)
--nodelete      don't delete temporary files (default: delete temporary files)
--nofax         don't send the fax (default: send fax)
--debug         enable debug logging

Email has to contain either one PDF attachment OR one TIFF attachment, and
a destination fax number as a subject.

Examples:

This one sends a fax from the command line, and enables debug logging:

cat message.eml | sudo -u root email2fax --debug


This one enables debug logging, doesn't send a confirmation email,
doesn't delete temporary files, and doesn't send a fax (useful for testing etc.):

cat message.eml | sudo -u root email2fax --debug --nomail --nodelete --nofax


This entry in .procmailrc located in asterisk home directory intercepts all emails
to asterisk, and passes them to email2fax:

:0fw
| /usr/local/bin/email2fax


By default, email2fax logs ALL messages to /var/log/asterisk/faxlog, and saves temporary files in /tmp/email2fax.
These paths, along with several different variables, can be changed
at the beginning of this script (/usr/bin/email2fax).

See http://wpkg.org/email2fax for updates, bug reports, and answers.

I've tried hacking around with the code, it may work if you e-mail and use procmail but judging from the mailing list it sounds like others are having difficulty too.

It's too bad but I thought I'd try this tool, perhaps another day when I have more time.


Tags:

email, asterisk, efaxingit, bash, shell, http, wpkg, org, index, php, main_page, libtiff, ghostscript, mpack, munpack, undocumented, buggy, documentation, mentions, invoke, quot, somefile, eml, nodebug, displaying, oversight, beta, gateway, usage, piped, nomail, confirmation, default, nodelete, delete, nofax, debug, enable, logging, contain, pdf, attachment, tiff, destination, examples, enables, sudo, doesn, etc, entry, procmailrc, located, directory, intercepts, emails, fw, usr, bin, logs, var, faxlog, saves, tmp, paths, variables, updates, ve, hacking, procmail, mailing, difficulty,

Latest Articles

  • ImageMagick Convert PDF Not Authorized
  • ImageMagick Converted PDF to JPEG some files have a black background solution
  • Linux Mint Mate Customize the Lock screen messages and hide username and real name
  • Ubuntu/Gnome/Mint/Centos How To Take a partial screenshot
  • ssh how to verify your host key / avoid MIM attacks
  • Cisco IP Phone CP-8845 8800/8900 Series How To Reset To Factory Settings Instructions
  • ls how to list ONLY directories
  • How to encrypt your SSH private key file id_rsa
  • Linux Mint 18 Disable User Name List from showing on Login Screen
  • Firefox Cannot Hit Enter Key In Address Bar and Location History Not Working
  • Cisco Unified Communications Manager / CUCM IP 8.6,10,12 Install Error Solution
  • Ubuntu Debian Mint Linux SSHD OpenSSH Server Not Starting After Reboot Solution
  • nmap how to scan for all ports and not just the 1000 most common ports
  • Windows 7,8,10 and Server 2008, 2012, 2016, 2019 Read Only Attribute Won't Go Away
  • bind / named how to make a wildcard record and retain defined A records
  • Cisco Unified Communications Manager 12 Install Errors on Proxmox/KVM
  • Local Vs Universally Administered MAC Address NIC Refuses to come up
  • Cisco Unified Communications Manager 12 CUCM 12 - How To Enable Video Calling
  • Windows 7, 8, 10, Windows Server 2008, 2012, 2016, 2019 How To AC97 Audio Drivers and Other Unsigned Drivers
  • Cisco Unified Communications Manager / CUCM IP Telephony Definitions