WHAT IS KMLDONKEY?
==================

KMLDonkey is a frontend for MLDonkey, a powerful P2P file sharing tool,
designed for the KDE desktop.


FEATURE OVERVIEW
================

A brief overview of KMLDonkey's most important features:

* A flexible, powerful and KDE Style Guide compliant graphical interface.
* A complete implementation of the MLDonkey GUI protocol, meaning KMLDonkey
  can do everything the original GUI does.
* A convenient and configurable on-demand MLDonkey launcher.
* Real-time graphical bandwidth and network statistics.
* MobileMule middleware for controlling your MLDonkey using your Java
  enabled mobile phone.
* Embedded previewing of all downloads using KParts viewers.
* Embedded web browser providing P2P related web services such as
  availability and fake checks.
* KDE panel applet and system tray icon for statistics and easy access to
  the GUI.
* KIOSlave for opening current and complete downloads in all KDE
  applications (eg. "mldonkey:/Default/downloading/")

For more details, consult the KMLDonkey home page at http://kmldonkey.org/


REQUIREMENTS
============

To use KMLDonkey, you will need the following:

* KDE 3.1 or higher.
* MLDonkey 2.5.14 or higher. KMLDonkey can help you install this.


INSTALLATION
============

To compile and install KMLDonkey, follow this procedure: 

 $ tar jxvf kmldonkey-0.10pre4.tar.bz2
 $ cd kmldonkey-0.10pre4
 $ ./configure --prefix=$KDEDIR
 $ make
 $ su -c "make install"

Replace $KDEDIR with the prefix to your KDE installation. If you don't know
what it is, type the command "kde-config --prefix" in a shell to find out.
Please take care to get this right, or KMLDonkey will very likely not work
correctly!

If you have trouble performing the installation, please consult the more
detailed instructions on the KMLDonkey home page:

  http://kmldonkey.org/node/view/21


COPYRIGHT
=========

This program is copyright (C) 2002-2004 Petter E. Stokke
                          (C) 2003, 2004 Sebastian Sauer

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
