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

Homepage: http://deluge-torrent.org

Authors:
    Andrew Resch
    Damien Churchill

For past developers and contributers see: http://dev.deluge-torrent.org/wiki/About

==========================
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: http://freenode.net

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

For more detailed instructions see: http://dev.deluge-torrent.org/wiki/Installing/Source

See: DEPENDS for a full list of dependencies.

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 \
    python-mako python-twisted-web python-chardet python-simplejson

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-console
    Web:
        deluge-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 -L <log level>

I can't connect to the daemon from another machine/

    * Configure the daemon to allow remote connections
    * Add a user to the auth file located in the config folder: ~/.config/deluge/auth
    * Restart the daemon.

I upgraded from 0.5 and plugin x is missing

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

For the full FAQ see: http://dev.deluge-torrent.org/wiki/Faq