INSTALL.unix.txt 2.9 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798
  1. The easiest way to install BitTorrent is to run the install_nix.sh
  2. script included in the source code. The rest of these directions are
  3. included for historical reasons.
  4. ----------------------------------------
  5. Before installing BitTorrent 5.x, remove any older versions of the
  6. BitTorrent client that may be installed. This command will tell you
  7. if you have an older version of BitTorrent installed:
  8. ls -dl /usr/lib/python*/site-packages/BitTorrent* /usr/lib/python*/site-packages/khashmir*
  9. Many of the following instructions require root privileges.
  10. Prerequisites for installing BitTorrent on any generic UNIX system:
  11. ----------------------------------------
  12. Install Python, version 2.3 or later. (2.4 recommended)
  13. http://python.org/
  14. Install wxWidgets, version 2.6 or later, in the Unicode flavor.
  15. http://wxwidgets.org/
  16. Install wxPython, version 2.6 or later, in the Unicode flavor.
  17. http://wxpython.org/
  18. Install GTK, version 2.6 or later.
  19. http://gtk.org/
  20. Install Twisted, version 2 or later.
  21. http://twistedmatrix.com/trac/
  22. Install PyCrypto, version 2 or later.
  23. http://www.amk.ca/python/code/crypto
  24. Install Psyco.
  25. http://psyco.sourceforge.net/
  26. Install Zope.Interface.
  27. http://www.zope.org/Products/ZopeInterface
  28. In all cases, it is STRONGLY recommended that you install these
  29. packages using the standard package management system on your
  30. particular distribution.
  31. Next, be sure to remove any older versions of BitTorrent that may be
  32. installed.
  33. How to install BitTorrent using Python's distutils system:
  34. ----------------------------------------
  35. Install BitTorrent by running this from the root of the source code
  36. directory:
  37. $ python setup.py install
  38. How to build a .deb format Debian package and install it:
  39. ----------------------------------------
  40. First, remove any older versions of BitTorrent that may be installed:
  41. (this command will also remove BitTornado)
  42. $ sudo apt-get remove bittorrent bittorrent-gui
  43. Build a proper deb using the following command:
  44. $ sh build_nix_pkg.sh deb
  45. then install the .deb:
  46. $ sudo dpkg -i dist/bittorrent_5.x.y_python2.z.deb
  47. How to build an .rpm format package and install it:
  48. ----------------------------------------
  49. Generate an .rpm format package:
  50. $ python setup.py bdist_rpm
  51. Then install the .rpm:
  52. $ sudo rpm -i dist/BitTorrent-5.x.y-1.noarch.rpm
  53. How to add BitTorrent as the default mime-type handler:
  54. ----------------------------------------
  55. This step is optional. Put a line in /etc/mailcap which is similar to
  56. the following, only replace the path to /usr/bin/bittorrent.py with
  57. the one it's actually in.
  58. application/x-bittorrent; /usr/bin/bittorrent.py %s; test=test -n "$DISPLAY"
  59. You may have to restart your web browser for it to start using
  60. BitTorrent.
  61. If you're using a web browser which doesn't respect /etc/mailcap you
  62. can go into the mime-type configuration for your web browser and
  63. manually associate application/x-bittorrent with btdownloadgui.py
  64. (with the appropriate path, of course.)