Pyla Hylafax Client
-----------------------

This simple program aims to be a full-featured client for the Hylafax faxserver
entirely written in python. 
This program can be useful to you either if you are looking for a simple fax client or if you need a simple example on how to build your own hylafax client.
This program is still in developement and it's not thoroughly tested. I hope it works for you, if it doesn't please contact me so I can fix it.

Prerequisites
-------------

To run Pyla you basically only need python2 installed. If you need to use ldap
addressbook you need an external python ldap module.
For Windowz machines I've included the module in winldap directory and so you
should be able to run pyla just after installing python for windows.
For Linux machines you must remember to install python-ldap module and Tk-Inter libraries.


Installation
------------
Pyla accept the following parameters:

Usage: pyla.py [-ilcf] [profile] [file]

profile = specify the configuration profile to use.
file = send file mode, specify the file to send.
-i = stdin mode, for fax printers.
-l = local mode.
-c = ignore common profile.
-f = specify file to send.

The 'profile' parameter is used to keep configuration files separate, in this way you can share pyla executable between many users. If you do not specify any profile pyla will use 'default' as profile name. Profiles are saved under the profiles directory.
From version 1.0.7 you can use a special profile named COMMON which is useful to distribute a configuration among different users. To use this feature simply start pyla with COMMON as profile option, edit for example your common ldap address book and then exit pyla. Now you should find that configuration in every other profile.

The '-i' flag can be used to accept a fax from standard input, in this way you can easily configure your system to call pyla when printing on a fax printer.
On Windows platform you can use the Redmon portmonitor, on Unix you can simply
create an entry in your printcap using pyla as a filter(see pyla_print file).

The '-l' flag is used mainly for debugging purposes, it just let you work without a real server.

The '-c' is used to disable the common profile feature.

The '-f' option is used together with 'file' to send a file directly from the command line.


MULTIPLE FILE SUPPORT
Since version 1.1.6 you can send more than one files at a time.
To send multiple files you can simply print on your fax printer and instead of sending it immediately you can queue
it using the 'queue fax' button.
Once you have all the files you need use the 'Send fax' button.

LANGUAGE INFO

If you want to change pyla language, simply copy language.xx on language.db

If you have any question send me an e-mail. <andrea@teamsw.it>

