Before sending a fax, the name of the file to be sent must be specified in the "File to fax" box. The file specified must be in postscript format, and will be converted by the program into the correct tiffg3 fax format. It can be entered manually in the "Fax to send" box, or entered by means of the file selection dialog. If the file comprises a single postscript file, then you can find it by pressing the "Single File" button. It can be more easily found with this dialog if it is placed in the $HOME/faxout directory.

Where more than one file is specified in the "Fax to send" box, they will be sent as a single fax appended in the order in which they are entered in the box. Such multiple files can be more easily selected using the file list brought up by pressing the "Multiple Files" button. Pressing the "Multiple Files" button enables files to be found and added to the file list, and they can be reordered by using the Up or Down arrow buttons, or by dragging and dropping with the mouse. (If entering multiple files manually rather than by means of the "Multiple Files" dialog, use a `,' or a `;' as the file name separator.)

The telephone number to which the fax is to be sent is entered into the "Tel number" box. This can be entered directly into the box, or by using the built-in addressbook. The addressbook can be invoked by pressing the "Tel number" button, or from the `File/Address book' pull-down menu item. See "Using the address book" further below. However, if a telephone connection has already been established with the remote fax receiver, then the fax can be sent without dialing by leaving the "Tel number" box blank (a dialog will come up asking if you would like to send the fax without dialing - this does the same thing as `fax send -m ...' using the efax `fax' script from the command line).

When a fax is received from the print system via the socket server, the program settings can be configured to bring up a dialog automatically. If the program is inactive or is standing-by to receive faxes the fax can be sent directly from this dialog without the need to invoke the list of queued faxes received from the socket.

Successfully sent faxes are copied to a directory in the $HOME/faxsent directory, which has a name derived from the year, month, day, hour and seconds when the sending of the fax was completed, and will appear in the faxes sent list. They are only included in that list if they have been sent without error. The efax message display box will report on the progress of a fax being sent. The fax list can be brought up from the `File/List sent faxes' pull down menu item. See "Using the fax lists" further below.

The program can send a fax when it is in receive standby mode. If sending a fax from receive standby mode, when the fax has been sent (or there is an error in sending the fax), the program will return to receive standby mode.

To make sending faxes from word processors easy, a socket server is provided interfacing directly with the print system. See below for further details.

Ordinary ascii text files can be converted into postscript if required using a number of programs, of which probably the easiest to use are nenscript or GNU enscript (`man enscript').

Three ways of receiving faxes are provided for.

First, the program can be set to answer a fax call which is ringing but has not been answered, by pressing the "Answer call" button.

Secondly, the program can take over a call which has already been answered (say, by a telephone hand set) by pressing the "Take over call" button.

Thirdly, the program can be placed in standby mode by pressing the "Standby" button. This will automatically answer any call after the number of rings specified in the efax-gtkrc file, and receive the fax. The program will keep on receiving faxes until the "Stop" button is pressed. A fax can also be sent when the program is in receive standby mode.

Received faxes in tiffg3 format (one file for each page) are placed in a directory in the $HOME/faxin directory, which has a name derived from the year, month, day, hour and seconds when the relevant "Answer call", "Take over call" or "Standby" button was pressed. (Where in standby mode after a fax has been received, any further fax will derive its name from the time when receipt of the last received fax has been completed and the program goes back into standby mode.)

Received faxes can be printed, viewed, described and managed using the built in fax list facility. This can be brought up from the `File/List received faxes' pull down menu item. See "Using the fax lists" further below.

When a fax is received, a pop-up dialog can also be set to appear (go to the Settings dialog to do this). In the settings dialog you can also specify a program to be executed when a fax is received. The number of the fax is passed as the first (and only) argument to the program, which enables the program to find the fax in $HOME/faxin. The distribution contains two executable scripts, mail_fax and print_fax, which can be used to e-mail a fax or print a fax to a user automatically when it is received. (These scripts are not installed by `make install' - if you want to use them, make them executable with `chmod +x' and copy them to a directory which is in the system path, such as /usr/local/bin, and then specify the script name in the settings dialog).

To pick a telephone number from the address book, highlight the relevant address by pressing the left mouse button over it, and then press the "OK" button.

Addresses can be added to the address book by pressing the add button, and then completing the relevant dialog which will appear. To delete an address from the address book, highlight the relevant address and press the delete (trashcan) button. The addressbook can be sorted by using the up and down arrow buttons on a highlighted address.

Addresses are stored in file `$HOME/.efax-gtk_addressbook'.

To bring up the fax lists, go to the the `File' menu and pick the `List received faxes' or `List sent faxes' menu item. Highlight the fax to printed or viewed by pressing the left mouse button. The programs to be used to print and view the fax are specifed in the efax-gtkrc configuration file, or if none are specified, the program will print using lpr (which will work for most Unix systems) and view with gv.

To print faxes, a PRINT_SHRINK parameter can be specifed in efax-gtkrc to enable the fax page to fit within the printer margins. A parameter of 98 will work with most printers. This can be changed while the program is running by bringing up the `Settings' dialog and entering it into the `Print/Print Shrink' box.

A fax can be deleted from a fax list by pressing the delete (trashcan) button. This will place the deleted fax in the $HOME/faxin/oldfax or $HOME/faxsent/oldfax directory.

A fax can be deleted from a fax list by pressing the delete (trashcan) button. This will place the deleted fax in the `Trash' folder. If the delete (trashcan) button is pressed in relation to a fax in the `Trash' folder, it will be deleted from the file system.

A description can be added to a received fax when appearing in a fax list (or subsequently amended) by pressing the relevant button -- this will enable faxes to be more easily identified.

To refresh a fax list (say, to update with any faxes received or sent since the fax list was brought up), press the refresh button.

The program settings can be changed by manually editing the efax-gtk configuration file comprising $HOME/.efax-gtkrc, $sysconfdir/efax-gtkrc or /etc/efax-gtkrc. The file is searched for in that order, so $HOME/.efax-gtkrc takes precedence over the other two.

The configuration file can also be set by using the Settings dialog launched from the `File/Settings' pull down menu item. The settings entered using this dialog are always stored as $HOME/.efax-gtkrc. Accordingly, if the Settings dialog has been used, and you want to revert to the global settings, this can be done either by deleting the $HOME/.efax-gtkrc file, or by pressing the `Reset' button in the Settings dialog, which will reload the Settings dialog from the global configuration file ($sysconfdir/efax-gtkrc or /etc/efax-gtkrc).

Help can be obtained when filling out the Settings dialog by holding the mouse over the relevant help (?) button, which will bring up a "Tips" display, or by pressing the button, which will bring up an information display.

Probably the simplest way of using the program with a word processor is to print to file from the print dialog of the word processor program concerned, and choosing a file name in the $HOME/faxout directory which can then be selected with the file selector dialog in efax-gtk. All Unix/Linux word and document processing programs will print to file in Postscript format, ready to be faxed by efax-gtk. (At least, if there is one which does not, I do not know of it).

Efax-gtk can run a socket server, which CUPS can connect to. When the socket server is running, fax files received from CUPS will automatically be displayed in a "Queued faxes from socket" list maintained by efax-gtk. From this list, a fax can be selected for sending by efax-gtk, so there is no need to print to file from the word processor and then select the file with the file selection dialog in efax-gtk.

If you are using CUPS and you want to connect it directly to efax-gtk as mentioned above, you can do so by bringing up the fax administration page for CUPS in a web browser, installing a new printer with a name of "fax" (or whatever other name you want), choose the IPP protocol, pick a URI of "socket://[hostname]:[port]", and choose the "Raw" CUPS printer driver.

The port number can be any port number less than 65536 and more than 1023 which is not used by any other service on your machine/network (this can be checked out by using nmap, but it is best to avoid any listed in /etc/services). For example, as you will usually be printing from a local computer, if you choose a port number of 9900 (which would be quite reasonable) the URI would be:

socket://localhost:9900

You should then start efax-gtk, go to the Socket tab in the settings dialog, check the "Run socket server" box, and enter 9900 in the "Port to which faxes to be sent" box.

To send a fax from the "Queued faxes from socket" dialog, highlight the one to be sent, press the "Enter selected fax to send" button in the dialog (the one with an icon representing a fax machine) which will enter the fax in the "File to fax" box in efax-gtk, and then choose a telephone number to send it to and press the "Send fax" button in the ordinary way.

If efax-gtk isn't running when you attempt to send a file via CUPS to efax-gtk don't worry. CUPS will queue the fax until it detects that the efax-gtk socket server is running, and then send it to efax-gtk.

Where a fax is queued for sending in the socket list, a small red circle will appear in the main program window on the right hand side of the "Fax to send" box.

The socket server can also be used in the same way with lpd/lprng. The files efax-gtk-faxfilter and efax-gtk-socket-client are installed in /var/spool/fax, when you run `make install' (the installation directory can be changed at the ./configure stage using the "./configure --spooldir=[dir]" parameter. You should add at the end of /etc/printcap the following -

fax:\

:sd=/var/spool/fax:\

:mx#0:\

:sh:\

:lp=/dev/null:\

:if=/var/spool/fax/efax-gtk-faxfilter:

This will cause a printer by the name of "fax" to be available, which (if printed to) will send the file to the efax-gtk socket server. If you set efax-gtk to listen on a port other than port 9900, you will need to amend the file /var/spool/fax/efax-gtk-faxfilter by hand to specify the correct port number on which efax-gtk is listening.

Don't forget to restart the lpd printer daemon after amending /etc/printcap. (An equivalent addition to /etc/printcap can also be made by using the printer configuration tool with your distribution, choosing a printer name of "fax" (or whatever other name you want), choosing a printer device of "/dev/null", a spool directory of "/var/spool/fax" and an input filter of "/var/spool/fax/efax-gtk-faxfilter".)