==========================
 Deluge BitTorrent Client
==========================

Authors:
    Andrew Resch
    Marcos Pinto
    Martijn Voncken
    Sadrul Habib Chowdhury
    Damien Churchill

Homepage: http://deluge-torrent.org


==========================
License
==========================
Deluge is under the GNU GPLv3 license.
Icon data/pixmaps/deluge.svg and derivatives in data/icons are copyright
Andrew Wedderburn and are under the GNU GPLv3.
All other icons in data/pixmaps are copyright Andrew Resch and are under
the GNU GPLv3.

==========================
Contact/Support:
==========================

We have two options available for support:

	Our Forum, at http://forum.deluge-torrent.org
		or
	Our IRC Channel, at #deluge on Freenode

==========================
Installation Instructions:
==========================

Dependencies:
  Core:
    python >= 2.5
    boost >= 1.34.1
    openssl
    zlib
    twisted
    twisted-web
    pyopenssl
    simplejson (if python < 2.6)
    setuptools
    gettext
    pyxdg
    geoip-database (optional)

  Gtk:
    python-notify (libnotify python wrapper)
    pygame
    pygtk >= 2.12
    librsvg
    xdg-utils
    chardet

  Web:
    mako

First, make sure you have the proper build dependencies installed.  On a normal
Debian or Ubuntu system:

sudo apt-get install g++ make python-all-dev python-all python-dbus \
    python-gtk2 python-notify librsvg2-common python-xdg python-support \
    subversion libboost-dev libboost-python-dev libboost-iostreams-dev \
    libboost-thread-dev libboost-date-time-dev libboost-filesystem-dev \
    libboost-serialization-dev libssl-dev zlib1g-dev python-setuptools

The names of the packages may vary depending on your OS / distro.

Once you have the needed libraries installed, build and install by running:

	$ python setup.py build
	$ sudo python setup.py install


==========================
FAQ
==========================

How to start the various user-interfaces

    Gtk:
        deluge --ui gtk
    Console:
        deluge --ui null
    Web:
        deluge --ui web
        Go to http://localhost:8112/ default-password = "deluge"

I started "deluge" but i don't see the gtk-ui

    The deluge command remembers the last interface it started. Be explicit and type one of the full "deluge -u <interface>" commands listed above.

Why is deluge still listed in my system tray even after I close it ?

    You closed the gtk user-interface but you did not close the daemon. Choose "Quit & Shutdown Daemon" to close both Daemon and gtk-ui.

How do I start the daemon ?

    deluged

How do I start the daemon with logging to console ?

    deluged -d

I can't connect to the daemon from another machine

    * Configure the daemon to allow remote connections
    * Restart the daemon.

    Note: do not do this on a public ip , use the webui for unsecure networks.

I upgraded from 0.5 and plugin x is missing

    1.0 is a rewrite, all old 0.5 plugins have to be rewritten.