INSTALL.unix.txt

Before installing BitTorrent 4.x, remove any older versions of the
BitTorrent client that may be installed.

Most of the following instructions require root privileges.

How to install BitTorrent on a generic UNIX system:
----------------------------------------
Install Python, version 2.2.1 or later
http://python.org/

Install GTK, version 2.2 or later
http://gtk.org/

Install pygtk, version 2.4 or later
http://pygtk.org/

Install BitTorrent by running:

$ python setup.py install

Optionally, untar and put a line in /etc/mailcap which is similar to
the following, only replace the path to /usr/bin/btdownloadgui.py with
the one it's actually in.

application/x-bittorrent; /usr/bin/btdownloadgui.py %s; test=test -n "$DISPLAY"

You may have to restart your web browser for it to start using
BitTorrent.

If you're using a web browser which doesn't respect /etc/mailcap you
can go into the mime-type configuration for your web browser and
manually associate application/x-bittorrent with btdownloadgui.py
(with the appropriate path, of course.)


How to build a .deb format Debian package and install it:
----------------------------------------
First, remove any older versions of BitTorrent that may be installed:
(this command will also remove BitTornado)

$ apt-get remove bittorrent bittorrent-gui

Then use setup and alien to generate a .deb format package:

$ python setup.py bdist_dumb
$ cd dist/
$ alien BitTorrent-4.x.y.linux-i686.tar.gz

you should now have a .deb package in: bittorrent-4.x.y.linux_i686-2_all.deb

then install the .deb:

$ dpkg -i bittorrent-4.x.y.linux_i686-2_all.deb


How to build an .rpm format package and install it:
----------------------------------------

Generate an .rpm format package:

$ python setup.py bdist_rpm

Then install the .rpm:

$ rpm -i dist/BitTorrent-4.x.y-1.noarch.rpm