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.3 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.10.1.tar.bz2
 $ cd kmldonkey-0.10.1
 $ ./configure --prefix=$(kde-config --prefix)
 $ make
 $ su -c "make install"

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-2005 Petter E. Stokke
                          (C) 2003-2005 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., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
