README

   1 Tor Browser Launcher
   2 ====================
   3
   4 Tor Browser Launcher is intended to make the Tor Browser Bundle (TBB) easier to
   5 maintain and use for GNU/Linux users. You install torbrowser-launcher from your
   6 distribution's package manager and it handles downloading the most recent
   7 version of TBB for you, in your language and for your architecture. It also
   8 adds a "Tor Browser" application launcher to your operating system's menu.
   9
  10 When you first launch Tor Browser Launcher, it will download TBB from
  11 https://www.torproject.org/ and extract it in ~/.torproject, and then execute
  12 it. When you run it after that it will just execute TBB.
  13
  14 Tor Browser Launcher will get updated each time a new version of TBB is
  15 released. When you open Tor Browser after an update, it will download the newer
  16 version of TBB for you and extract it over your old TBB directory in
  17 ~/.torproject, so you will maintain your TBB bookmarks.
  18
  19 Building a Debian package
  20 =========================
  21
  22 Dependencies
  23 ------------
  24
  25 You need to have stdeb installed. If you're using Debian or Ubuntu you can
  26 install it like this:
  27
  28   sudo apt-get install python-stdeb
  29
  30 Here are other things you might need:
  31
  32   sudo apt-get install build-essential dpkg-dev debhelper devscripts fakeroot \
  33                        cdbs
  34
  35 Building
  36 --------
  37
  38 First build a source distribution:
  39
  40   python setup.py sdist
  41
  42 Turn it into a Debian source package:
  43
  44   cd dist
  45   py2dsc torbrowser-launcher-0.1.tar.gz
  46
  47 Turn it into a Debian binary package:
  48
  49   cd deb_dist/torbrowser-launcher-0.1
  50   dpkg-buildpackage -rfakeroot -uc -us
  51
  52 Or, to combine all those in one command:
  53
  54   python setup.py sdist; cd dist; py2dsc torbrowser-launcher-0.1.tar.gz; \
  55   cddeb_dist/torbrowser-launcher-0.1; dpkg-buildpackage -rfakeroot -uc -us; \
  56   cd ..
  57
  58 Installing
  59 ----------
  60
  61 Once you've made a .deb, you can install it like this:
  62
  63   sudo dpkg -i python-torbrowser-launcher_0.1_all.deb
  64