Email to Fax Gateway!

This is an awasome feature of hylafax. User can send fax using email applications. Ex: riyesh@23656237.fax

We need to add some simple scipts to activate this feature.By defult hylafax will not decode the attachments.So you need to edit /etc/hylafax/hyla.conf.

specify mime type directory location in /etc/hylafax/hyla.conf

add the following line

MIMEConverters: /var/spool/hylafax/mimetype

Then create the converting scripts under /var/spool/hylafax/mimetype

mkdir /var/spool/hylafax/mimetype

you need to create followin directories under /var/spool/hylafax/mimetype

mkdir application

mkdir image

mkdir text

the tree look like this

/var/spool/hylafax/mimetype/
/var/spool/hylafax/mimetype/application/pdf
/var/spool/hylafax/mimetype/application/ps
/var/spool/hylafax/mimetype/image/tiff

/var/spool/hylafax/mimetype/text/html

For msword type of files create msword under /var/spool/hylafax/mimetype/application/

cd /var/spool/hylafax/mimetype/application/

touch msword

chmod +x msword

vi msword

add the following lines in msword script

#!/bin/bash
antiword $1
exit

For PDF type of files create pdf under /var/spool/hylafax/mimetype/application/

cd /var/spool/hylafax/mimetype/application/

touch pdf

chmod +x pdf

vi pdf

add the following lines in pdf script

#!/bin/sh
#/application/pdf
# convert PDF attachment to Postscript for HylaFAX to send
pdf2ps $1 -
# if you want to send multipage pdf attachments it is better to use “pdftops”
# use the line below instead of “pdf2ps $1 -”
# /usr/bin/pdftops $1 -

For postscript type of files create postscript under /var/spool/hylafax/mimetype/application/

cd /var/spool/hylafax/mimetype/application/

touch postscript

chmod +x postscript

vi postscript

add the following lines in postscript script

#!/bin/sh
#/application/pdf
# convert PDF attachment to Postscript for HylaFAX to send
pdf2ps $1 -
# if you want to send multipage pdf attachments it is better to use “pdftops”
# use the line below instead of “pdf2ps $1 -”
# /usr/bin/pdftops $1 -
mail:/var/spool/hylafax/mimetype/application #
mail:/var/spool/hylafax/mimetype/application # cat postscript
#!/bin/sh
#/application/ps
# convert PS attachment to Postscript for HylaFAX to send
echo $1

For PS attachment files create ps under /var/spool/hylafax/mimetype/application

cd /var/spool/hylafax/mimetype/application/

touch postscript

chmod +x postscript

vi postscript

add the following lines in ps script

#!/bin/sh
#/application/ps
# convert PS attachment to Postscript for HylaFAX to send
echo $1

For rtf attachement files create rtf under /var/spool/hylafax/mimetype/application

cd /var/spool/hylafax/mimetype/application/

touch rtf

chmod +x rtf

vi rtf

add the following lines in rtf

#!/bin/sh
#/application/rtf
# convert RTF attachment to Postscript for HylaFAX to send
/usr/bin/unrtf –html $1 | /usr/bin/html2ps

For jpeg attachment files create jpeg under /var/spool/hylafax/mimetype/image

cd /var/spool/hylafax/mimetype/image

touch image

chmod +x image

vi image

add the following lines in jpeg

#! /bin/sh
/usr/bin/jpeg2ps $1
exit

For tiff attachment files create tiff under /var/spool/hylafax/mimetype/image

cd /var/spool/hylafax/mimetype/image

touch tiff

chmod +x tiff
vi tiff

Then add the following lines

#! /bin/sh
/usr/bin/jpeg2ps $1
exit
mail:/var/spool/hylafax/mimetype/image # cat tiff
#!/bin/sh
#/image/tif
# convert TIF attachment to Postscript for HylaFAX to send
/usr/bin/tiff2ps $1
# if you want to send multipage tiff images, than you have to add the option “-a”
# for example:
#/usr/bin/tiff2ps -a $1

For HTML type files create html under /var/spool/hylafax/mimetype/text

cd /var/spool/hylafax/mimetype/text

touch html

chmod +x html
vi html

then add the following lines.

#! /bin/sh
/usr/bin/html2ps $1
exit

Integrating with MTA’s

cd /usr/src/hylafax-(source package)

cd faxmail

there you can see the files

mailfax.sh-sendmail

mailfax.sh-postfix

mailfax.sh-qmail

mailfax.sh-smail

do as per the files says.

May 9, 2009
8:47 am

Fax Gateway had this to say, #1

The features of hylafax are really awesome. I apprecite you for presenting so many tips in this site.Thank you.

May 9, 2009
10:19 am

Riyesh had this to say, #2

Thanks for the comments buddy….

May 28, 2009
8:46 am

tomillo had this to say, #3

how to create pdf file in /var/spool/hylafax/mimetype/application?
pdf is a directory

May 28, 2009
9:01 am

Riyesh had this to say, #4

No.. /var/spool/hylafax/mimetype/application/pdf is an file. you just need to copy the following contents to work this.

code:

Please note that .. u need to install pdf2ps rpm to run this.

May 28, 2009
9:37 am

tomillo had this to say, #5

“the tree look like this
/var/spool/hylafax/mimetype/
/var/spool/hylafax/mimetype/application/pdf
/var/spool/hylafax/mimetype/application/ps”
it confused me.
Thank you. I’m gonna try

May 28, 2009
9:42 am

Riyesh had this to say, #6

…mm.. Good … Try…

Jun 1, 2009
12:06 pm

tomillo had this to say, #7

Working…
Thank you so much.

Jun 1, 2009
12:09 pm

Riyesh had this to say, #8

welcome…. keep touch on Linux buddies.. also post some intersting subjects….

Sep 1, 2009
10:52 am

hercross had this to say, #9

Hi, I try to do this, but when I try to send a .doc, for example, hylafax say me that:
Microsoft Word Document support not configured
And I can’t send .doc, .jpeg, .html…… only I can send .pdf, .txt, .ps
Any idea??
thansk

Sep 1, 2009
11:11 am

Riyesh had this to say, #10

Hi,

Did you edited “typerules” files under /etc/hylafax ?

you have to uncomment the html, jpeg, msword section…

for msword

0 short 0xd0cf error Microsoft Word Document support not configured

for jpeg

>6 string JFIF ps jpeg2ps -a -o %o %i

for html

0 istring <!DOCTYPE HTML ps html2ps %i >%o

0 istring <HTML ps html2ps %i >%o

0 istring <TITLE ps html2ps %i >%o

0 istring <HEAD ps html2ps %i >%o

0 istring <BODY ps html2ps %i >%o

0 istring <DIV ps html2ps %i >%o

0 istring This ps html2ps %i >%o

0 istring To: ps html2ps %i >%o

Sep 1, 2009
11:29 am

hercross had this to say, #11

Hi, I trying it, but when I try to send a .doc file, hylafax say me:
Microsoft Word Document support not configured

Any idea what is this?
Thanks

Sep 1, 2009
11:39 am

Riyesh had this to say, #12

did you installed antiword ? for msword support

Sep 1, 2009
11:57 am

hercross had this to say, #13

Yes I installed it. But when i try to send it, I see that.

Sep 1, 2009
12:01 pm

hercross had this to say, #14

Sorry for two same post, I have a problem…..
The file typerules, I have it in var/spool/hylafax/etc/typerules, and I don’t see that section.
I’ve instaled hylafax +, could be for that?
Thanks

Sep 1, 2009
12:06 pm

Riyesh had this to say, #15

upgrade your hylafax version

hercross had this to say, #16

Ahh ok, I have it in /usr/local/lib/fax/typerules.
I’ve probe .doc and its ok, now jpeg, html,…..
Thanksd

Sep 1, 2009
12:09 pm

Riyesh had this to say, #17

Good. Stil you have any doubts… Please use :”chat with admin” on this site.. or click this link http://www.google.com/talk/service/badge/Show?tk=z01q6amlqu5vg7qtpdvoig4abjdmirc3af92vfchak0ckol58vos0i8knbn8n68dp17nod4ucv7g46btrhjq1r1popcmbp35pdqqlqs7qqsv61qbpj21dmkdumomfhcq0h3uhs37qkfsgv5kfo2sqsglbr2o00robdi8psiujj2onr52jr0iq5lvcs150519d7c&w=200&h=60#

Sep 4, 2009
6:51 am

hercross had this to say, #18

Hi, it’s works fine fine.
But one question. If a doc file have an images?
When I try to send, hylafax send the file without images.
Can I do to hylafax send the file with the images?

Sep 5, 2009
6:53 am

Riyesh had this to say, #19

hi,

for that u have to enable multi-part messages. The same way which u have enabled pdf , doc, support.

Sep 7, 2009
6:55 am

hercross had this to say, #20

In the file, that I activated support, I see:
pdf, ps, PBM, PGM, PPM, txt, GIF, JPEG, FIG, DOC. But I don’t see multi-part.
In what line is it?
Thanks

Sep 7, 2009
3:20 pm

Riyesh had this to say, #21

For HTML emails that contain inline graphics
This is a preprocessor script that will split the email message into parts. These parts include the main html part and any inline graphics. The pyhton module tempfile is used to safely and securely create a temp directory to write all the parts out to. Then html2ps is called to convert the temporary directory to a PS stream that is sent to stdout. Once this work is completed the script removes the temporary directory.

#!/usr/bin/python

“”"Unpack a MIME message into a directory of files.”"”

import os
import sys
import email
import mimetypes
import re
import tempfile
import shutil

def main():

#Get the message from stdin
fp = sys.stdin.read()

#Convert this to a message object
msg = email.message_from_string(fp)

#Create temp directory to store contents
tempcon = tempfile.mkdtemp()

#Change to our tempcon
os.chdir(tempcon)

patt1 = re.compile(‘< ')
patt2 = re.compile('>‘)

for part in msg.walk():
# multipart/* are just containers
if part.get_content_maintype() == ‘multipart’:
continue
# Applications should really sanitize the given filename so that an
# email message can’t be used to overwrite important files

ext = mimetypes.guess_extension(part.get_content_type())
ctype = part.get(‘content-id’)

if ctype:
doit = re.sub(patt2, ”, re.sub(patt1, ‘cid:’, ctype))
else:
doit = ‘main.html’

if not ext:
# Use a generic bag-of-bits extension
ext = ‘.bin’
fp = open(tempcon + ‘/’ + doit, ‘wb’)
fp.write(part.get_payload(decode=True))
fp.close()

os.system(‘/usr/local/bin/html2ps main.html’)
os.chdir(‘..’)
shutil.rmtree(tempcon)

if __name__ == ‘__main__’:
main()

You will likely call the above preprocessor from an initial bash script that is first called from your MTA (ie, sendmail, postfix, etc). For example, my sendmail calls this first script. Note that ‘multi-write-0.1.py’ is the HTML multipart script listed above.

#!/bin/bash

#/usr/bin/formail -a ‘X-FAX-Headers: clear’ | /usr/local/bin/multi-write-0.1.py | \
/usr/bin/sendfax -n -m -R -f “$2″ -d “$1″

Informations copied from hylafax.org website.