YajHFC - Yet another Java HylaFAX Client

Description

YajHFC is a client for the HylaFAX fax server written completely in Java.

Features:

• Faxing documents in PostScript, PDF, JPEG, PNG, TIFF, GIF and HTML format
• Polling faxes
• Support for generating cover pages from templates (in PostScript, HTML and (with a Plugin) XSL:FO or ODT format)
• Viewing sent and received faxes
• Phone book (entries can optionally be read from SQL databases or LDAP directories)
• Visible table columns may be selected in a dialog
• Runs under Windows, Linux and Mac OS X (and probably other platforms if a suitable JRE is available)
• Supports eight languages: English, French, German, Italian, Polish, Russian, Spanish and Turkish

Requirements

• A installed Java 5.0 (or higher) JRE (Java 6 or higher recommended)
• A running HylaFAX server in your network (should be obvious ;-) )
• A program to view faxes (optional, also see the FAQ)
• A PostScript viewer (optional, e.g. Ghostview)
• GhostScript (optional)
• tiff2pdf from the libtiff utilities package (optional)

Screenshots

Screenshots of the program can be found here.

News

If you would like to receive news about YajHFC automatically by email, you can subscribe to the yajhfc-announce mailing list.

Download

Current version

The current version can be downloaded from the project page on BerliOS.

Which file(s) should you download?

If you just want to run the application, download only the JAR file (e.g. yajhfc-0_3_5.jar for version 0.3.5).
You can run YajHFC by executing the command java -jar yajhfc-0_3_5.jar or by simply double-clicking the downloaded file (on most platforms).
(If you downloaded another version, use a different file name, of course).

If you intend to run YajHFC under Windows, you can alternatively download the setup.exe (e.g. yajhfc-0_3_5-setup.exe for version 0.3.5).
This setup creates nice start menu and desktop icons for YajHFC and automatically adds a "fax printer" under Windows 2000/XP/Vista.

If you are interested in the source code, get the source archive (e.g. yajhfc-0_3_2-src.zip for version 0.3.2) from the project page and the gnu.hylafax library from http://gnu-hylafax.sourceforge.net/.
For instructions how to build YajHFC from the source code please see the file BUILDING.txt included in the source archive.

Software packages used by YajHFC

YajHFC uses the following third-party packages (you don't need to download any of these just to run YajHFC, however):

1. The gnu.hylafax library.
2. TableLayout.jar from https://tablelayout.dev.java.net/. The necessary classes from this package are included in the jar sub-directory of the source archive.
3. "Java look and feel Graphics Repository" (jlfgr-1_0.jar) from http://java.sun.com/developer/techDocs/hi/repository/. The necessary GIF files from this package are included in the jar sub-directory of the source archive, too.

FOP Plugin

Starting with version 0.3.7 YajHFC supports a plugin that adds support for cover pages in XSL:FO and ODT (OpenDocument Text) format. You can download it from the project page on BerliOS, too.

If you just want to run the application, download the zip file containing the binary distribution (e.g. YajHFC-0_3_7-FOPPlugin_0_1.zip) for YajHFC 0.3.7 with the FOP plugin version 0.1).
The plugin distribution includes a current version of YajHFC and all required libraries for convenience (so you don't need to download anything else). See the included README file (readme.pdf) for installation instructions.

If you intend to run YajHFC including the FOP Plugin under Windows, you can alternatively download the setup.exe (e.g. yajhfc-0_3_7-FOPPlugin-0_1-setup.exe for YajHFC 0.3.7 with the FOP plugin version 0.1).
This setup creates nice start menu and desktop icons for YajHFC and automatically adds a "fax printer" under Windows 2000/XP/Vista.

If you are interested in the source code, get the source archive (e.g. FOPPlugin-0_1-src.zip for version 0.1) from the project page, a JAR file of YajHFC and the Apache FOP library from http://xmlgraphics.apache.org/fop/.
For instructions how to build the plugin from the source code please see the file BUILDING.txt included in the source archive.

Old versions

Versions newer than (and including) 0.3.0 can be found on the project page, too.

Versions older than 0.3.0 can be found here.

Additional files

• A script that can be used to create a "fax printer" using CUPS. (Refer to the INSTALL document in this archive for more instructions)
• A Windows batch file to view both sent and received faxes as PDF (contributed by Thomas Koch)
• The YajHFC icon in PNG and Windows ICO format
• An OpenOffice plugin adding a toolbar icon to send a fax
• Examples for coverpages usable with YajHFC (includes the default cover pages before and after version 0.4.2)

Documentation/Support

General

Currently there are only the README files from the source archive available.

• README.txt
• The YajHFC FAQ (also as PDF)
• README_es.txt (Spanish, translation by Elsa Andrés)
• The YajHFC FAQ in Spanish (also as PDF) (translation by Elsa Andrés)
• README_de.txt (German)
• The YajHFC FAQ in German (also as PDF)
• README_fr.txt (French, translation by Defmond Law and Olivier Vigand)
• The YajHFC FAQ in French (also as PDF) (translation by Defmond Law and Olivier Vigand)
• README_ru.txt (Russian, translation by Alexander Moisseev)
• The YajHFC FAQ in Russian (also as PDF) (translation by Alexander Moisseev)
• README_tr.txt (Turkish, translation by Mesut Güler)
• The YajHFC FAQ in Turkish (also as PDF) (translation by Mesut Güler)

HOWTOs

• Creating a fax printer in Windows
• Creating a fax printer in Windows (Spanish, translation by Elsa Andrés)
• Creating a fax printer in Windows (German)
• Setting up YajHFC for small workgroups (how to use a shared read/unread state for the faxes and a shared phone book).
• Setting up YajHFC for small workgroups (Spanish translation by Elsa Andrés)
• Setting up YajHFC for small workgroups (German translation)
• Installation von YajHFC auf Mac OS X (10.4+) (German; contributed by Thomas Koch)
• Creating a fax printer with Mac OS X (contributed by Barnaby Puttick)
• How to connect to MySQL databases with YajHFC
• How to connect to MySQL databases with YajHFC (Spanish translation by Elsa Andrés)

Mailing lists

There are two mailing lists for YajHFC:

yajhfc-user: Subscribe/Unsubscribe Archives

Mailing list for YajHFC users. Intended for general discussion, questions, etc. about YajHFC.

yajhfc-announce: Subscribe/Unsubscribe Archives

Announcements about new releases or other important information about YajHFC (the same as in the news section above).
This list is read only and very low volume (at most two or three postings per month).

How to help

If want to help with the development of YajHFC, there are several things you can do:

• Write additional documentation
• Translate YajHFC (or documentation) into your native language (no programming skills necessary; contact me for details)
• Contribute code
• Create an installer/package for your favorite OS/Linux distribution
• Last but not least: If you find a bug or strange behaviour, write me a mail with a bug report.

Donations

If you want to support the development of YajHFC, but do not have the time to contribute documentation/translations/code, you can alternatively donate some money.

If you wish to donate, you have the following options of payment:

• With PayPal using the following button:
  
• If you live in the Euro zone: By bank transfer. In that case, please send me a short mail to receive my bank account details (IBAN/BIC).

Contact

You can contact me by email at: jonas.wolz@freenet.de

Impressum

Project hosted at:

Last modification: Tuesday, 13-Oct-2009 12:10:36 CEST