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   apt-get install python-stdeb
  29
  30 Also install the torbrowser-launcher dependencies:
  31
  32   apt-get install tor python-gtk2 gnupg python-twisted
  33
  34 Building
  35 --------
  36
  37 To build a Debian source package:
  38
  39   python setup.py --command-packages=stdeb.command sdist_dsc
  40
  41 To build a Debian binary package:
  42
  43   python setup.py --command-packages=stdeb.command bdist_deb
  44
  45 Installing
  46 ----------
  47
  48 Once you've made a .deb, you can install by running this as root:
  49
  50   dpkg -i deb_dist/torbrowser-launcher_VERSION_all.deb
  51