From ArchWiki

Hylafax setup (Contributed by tpowa)

Contents 1 To get it: 2 Setup: 3 Hints and Tips: 3.1 Pagesize 3.2 No Dialtone error or if you are a laptop user 3.3 For laptop users it might be helpfull to deactivate the Dialtone check 3.4 Automatic Fax printing 3.5 Disabling MTA actions 3.6 enable automatic printing of Notifications 3.7 Useful commands 4 4. Where are my files? 5 5. Apps for hylafax:

[edit] To get it:

pacman -S hylafax

it could be that you need a MTA installed like postfix

[edit] Setup:

• After installation please run faxsetup as root.
  Answer the questions and modify it to your needs.
• Run faxaddmodem as root.
  it asks you for the device, attention there is the first trap, leave out the /dev only enter eg. modem, ttyS0 or such things
• answer the other questions, important are maybe the ringtones or max pages or permissions on files or your Name that should be shown.
• after that you have to modify your inittab, add this line to it, where <enteryourdevice> = for example modem ttyS0 etc.

f1:2345:respawn:/usr/lib/fax/faxgetty <enteryourdevice>

• telinit q

• add hylafax to daemons array and if you want to start now /etc/rc.d/hylafax start

[edit] Hints and Tips:

[edit] Pagesize

Hylafax defaults are made for North America settings. Pagesize of send faxes can be adjusted in /usr/lib/fax/pagesizes for A4 default setup please change the file to that:

---snip
Japanese Legal          JP-LEG  12141   17196   11200    15300  900     400
#
#default        NA-LET  10200   13200    9240    12400  472     345
default         A4      9920    14030   9240    13200   472     345
---snap

[edit] No Dialtone error or if you are a laptop user

If you need a special number to get the Dialtone add this to your /var/spool/hylafax/etc/config.<yourdevicename> uncomment the ModemDialCmd line, and change ATDT%s to ATDT<yournumber>%s

[edit] For laptop users it might be helpfull to deactivate the Dialtone check

uncomment the ModemDialCmd line, and change ATDT%s to ATX3DT%s

[edit] Automatic Fax printing

You want your faxes printed. Add this to /var/spool/hylafax/bin/faxrcvd at the end

/usr/bin/tiff2ps -a -h 11.1082 -w 7.8543 $FILE || /usr/bin/lpr -P <yourprintername>

this setup is for A4 pagesize, adjust -h and -w to your needs if you need an other size.

[edit] Disabling MTA actions

normally hylafax uses a MTA to receive faxes, if you don't need that change, your /var/spool/hylafax/bin/faxrcvd change NOTIFY_FAXMASTER=always to never

[edit] enable automatic printing of Notifications

If you want notifications to be printed out and not mailed, change your /var/spool/hylafax/bin/notify change NOTIFY_FAXMASTER=never to always and at the end of that file

comment this line :

) || 2>&1 $SENDMAIL -f$FROMADDR -oi -t

add this as next line:

) || 2>&1 lpr -P <yourprinter> -p

Remember to add your changed file to pacmans NoUpgrade list else your changes might get lost on update.

[edit] Useful commands

faxstat (shows you the status of hylafax)
faxstat -s (shows you the send status)
faxstat -r (shows received faxes)
faxalter -a now <jobid> (forces send retry now)
faxrm <jobid> (deletes fax from sendqueue)

for more options please read the manpages of each program

[edit] 4. Where are my files?

Your received faxes will be saved in /var/spool/hylafax/rcvq/ and deleted after 30 days. Your send faxes will be saved in /var/spool/hylafax/sendq/ # don't know about deletion.

[edit] 5. Apps for hylafax:

Linux Apps:

• kfax is a nice app to view the received tiff files.
• KDE has a printer to send your document to fax, change it to use the hylafax backend.

Windows Apps:

• WFHC is a nice hylafax client for windows. Get it here: http://www.uli-eckhardt.de/whfc/
• SuSEfax is also a nice client for windows. Get it here: ftp://ftp.suse.com/pub/suse/discontinued/i386/SuSEFax_WIN32

For more information and configuration on hylafax please read the manpages or browse the web.