summaryrefslogtreecommitdiffstats
path: root/INSTALL.unix.txt
diff options
context:
space:
mode:
Diffstat (limited to 'INSTALL.unix.txt')
-rw-r--r--INSTALL.unix.txt65
1 files changed, 65 insertions, 0 deletions
diff --git a/INSTALL.unix.txt b/INSTALL.unix.txt
new file mode 100644
index 0000000..3e19b87
--- /dev/null
+++ b/INSTALL.unix.txt
@@ -0,0 +1,65 @@
+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