AsterFax the Email to Fax Gateway for Asterisk.
---------------   We have moved -----------------

AsterFax and Asterisk IT have both been renamed.

Asterfax is now known as Noojee Fax

Asterisk IT is now known as Noojee Telephony Solutions.

Noojee Fax documentation and support can now be obtained via:

---------------   We have moved -----------------

Asterisk IT is the primary developer and sponsor of AsterFax the Open Source Email to Fax Gateway for Asterisk.
Asterisk I.T. offer a range of support options for AsterFax as well as general Asterisk consulting services.  Contact for more information.
You can also receive support from the Asterfax and Asterisk communities by by posting at the relevant forum.

AsterFax - Asterisk Fax Logo


AsterFax uses Converters to convert a variety of file formats such as MS-Word, Open Office Writer etc. into a tiffg3 file which can then be transmitted as a fax. The standard installation of AsterFax comes with a number of standard file format  converters which are documented here .
AsterFax provides a simple means of adding additional converters by adding a new Converter element in the configuration file (config/AsterFax.xml).
AsterFax uses an attachment's (or the body of an email message's) mime type to determine which Converter to call. If AsterFax cannot match an attachment's mime type to a Converter mime type it will attempt to match the attachment's file name extension to the list of Extensions supported by each Converter. Extensions are used to overcome the limitations of a number of mail clients and mail servers which don't always apply the correct mime type to an attachment..
Once a Converter has been identified the application (or script) defined by the Converters <Application> element is called to convert the attachment to a tiffg3 file. The arguments specified in the <Arguments> element are passed to the application. Once the Converter has run AsterFax expect to find a tiffg3 file at the location specified by %dest%.
Note: tiff and tiffg3 file formats are not compatible so if creating your own Converter make certain that it creates a tiffg3 file.
If you file contains multiple pages all pages must be contained within a single tiffg3 file.

Adding additional converters:

The Converter element has four sub-elements.
Mime-Type - the mime type the converter supports. Mandatory.
Extensions - semicolon separated list of file extensions (without the dot). Optional.
Application - the application to call to convert the file attachment into a tiff file. Mandatory
Arguments - the arguments to pass to the application. Mandatory

The Arguments element can take two special tags which at run time are substituted for the fully qualified path of the source file and the destination file.
%src% - substituted for the name of the source file.
%dest% - substituted for the name of the destination file.
%pagesize% - substituted for the page size set in <AsterFax><Settings><PageSize>
%debug% substituted for the value 1 or 0 dependant on the state of the element <AsterFax><Settings><Debug><Converter> in AsterFax.xml.
    A value of True results in %debug% being replaced with a value of 1 otherwise 0. Note: the value <AsterFax><Settings><Debug><Enabled> must also be set to True.

            -sDEVICE=tiffg3 -sPAPERSIZE=%pagesize% -r204x196 -dNOPAUSE -dNOPAGEPROMPT -dBATCH -sOutputFile=%dest% -c save pop -f %src% -c quit
AsterFax UserGuide
Configuring Email Clients
Supported File Formats
Installing AsterFax
Configuring AsterFax
Testing AsterFax
Trouble Shooting AsterFax
Running AsterFax
Configuring SendMail
Configuring GhostScript
Configuring OpenOffice
Add your own File format

AsterFax is Sponsored by Asterisk I.T.
©2006  Asterisk I.T. all rights reserved. Some parts of this site may be the copyright of other authors. If you want to copy parts of this page you may do so provided you have gained permission from Asterisk I.T. first. Email
AsterFax™ is a trade mark of Asterisk I.T..
I'm not a great believer in Trade Marking Open Source software but unfortunately someone has been running a scam to redirect traffic to a bogus AsterFax web site. As such I've trade marked AsterFax's name to provide protection from such people.