'echolinux.pl' is written in Perl/Tk, and thus requires both
Perl and the Perl Tk module to be installed.

As the name implies, this program is targeted at Linux platforms,
however it should operate on any POSIX style Unix system.
It is unlikely to be of use to users of Win32 platforms.

These days, any Linux system is likely to have Perl installed,
so I won't describe how to obtain Perl.

If 'echolinux.pl' fails with an error "Can't locate Tk.pm in @INC..."
then your system does not have the Perl Tk module installed.
If your system uses the RPM system to provide packages, check for
the existance of a package named something like "perl-Tk-....", and
install it if available.
If no RPM is available, or your system does not use the RPM system,
you can download the source for the Perl Tk module from

           http://www.cpan.org/authors/id/NI-S

Full installation instruction should be found in the package.


                    User Configuration
                    ------------------

Environment
-----------

Ensure the directory $HOME/.echoLinux exists. In the directory, you
should have the files 'userdata.txt', 'info.txt', and 'connect.wav'
as per the configuration for EchoLinux.

You should add the files 'servers.txt' and 'friends.txt', where the
contents should be:

servers.txt:
A list of Echolink server hostnames to attempt to contact, one
hostname per line. For example (indented for clarity):

                 europe.echolink.org
                 asia.echolink.org
                 servers.echolink.org

friends.txt:
A list of friend station callsigns, one callsign per line. The friend
details are compared with the current station list returned by the
Echolink server, and need to match exactly (i.e. include any trailing
'-L' or '-R', or the leading and trailing '*' for Conferences). For
example (indented for clarity):

                 *ECHOTEST*
                 G0OAN
                 G0VAS
                 G3JNJ
                 G4IQE-L
                 G4POI
                 G7VVF
                 G8IUC

Program
-------

There is little which should need to be configured in the 'echolinux.pl'
program. You may need to alter the '#!' line to point to your installation
of Perl. The location of the 'echolinux' binary is hard-coded: if your
binary is not installed in '/usr/local/bin' then you will need to
modify the line which reads:

        my $echolinux_binary = '/usr/local/bin/echolinux';


This is beta software, and comments and feedback welcomed.

Andrew Benham G8FSL.
g8fsl@adsb.co.uk