GTKDIAL 0.4.1
-------------

Gtkdial was born out of the Perl/Tk Qdial project, and is now being implemented in C for the GNOME environment

Gtkdial presents a GUI frontend to the wvdial intelligent dialler. Drawing from existing wvdial configuration files, the user is able to switch between several ISPs by clicking on a list. The main Gtkdial window provides buttons to dial or kill the connection, or to exit the dialer. An optional connection timer allows monitoring of connections made during the current Gtkdial session.

Additionally, a preferences dialog allows the user to control the windows persistence on connect/kill, a session timer, a cumulative timer, timer alarms, single service mode, etc.

BUILDING GTKDIAL
----------------

Uncompress the archive and cd into the resulting gtkdial-0.x.x directory.
Type:

$ ./configure --prefix={chosen install prefix}
$ make

and then:

# make install

as root, to compile and install the sources

i386 and src RPMs are available at http://www.gtnorthern.demon.co.uk/packages/gtkdial

RUNNING GTKDIAL
---------------

The current version of gtkdial will scan your wvdial.conf file for a default modem and ISP settings, and will present a multiple choice list for easy selection.

Gtkdial will automagically install a gnome-menu shortcut in "Internet".

Gtkdial can be also run from the command line by typing:

# gtkdial

Gtkdial can also be run with a number of commandline options, typing:

# gtkdial --help

will give brief details of these. More information is available in the online help files.

PLEASE NOTE that wvdial may require you to be root or have superuser equivalenence in order to launch a PPP connection. At the very least, wvdial needs write access to your {pap,chap}-secrets file. We do not recommend making your PPP related files world-readable, but this is currently the only realistic option. Please see http://www.worldvisions.ca for more information.

As of 0.2.23pre releases, a shell script is shipped with the Gtkdial sources which will set permissions on all relevant files to allow non-root use of Gtkdial. Use of this script, particularly in multi-user environments is strongly advised against. The script is in the /tools directory of the untarred source archive, and is called unsafe.sh

CVS ACCESS
----------

Gtkdial is currently at Sourceforge, and anonymous CVS access is available to download the latest snapshots of both gtkdial and gwvedit.

$ cvs -d:pserver:anonymous@cvs.gtkdial.sourceforge.net:/cvsroot/gtkdial co gtkdial 

will checkout the latest snapshot. Replace the final gtkdial with gwvedit to grab the config editor.

THE GWVEDIT WVDIALCONF EDITOR
---------------------
This is currently available in CVS at gwvedit, and will soon receive a stable release of its own.

CONTACT/REPORTING BUGS
----------------------
Please contact me at mike@principia-systems.co.uk with any fixes,
bugs or comments, or use our bug reporting system at gtkdial.sourceforge.net


Mike Newman, February 2002
