Tor Browser Launcher
====================

Tor Browser Launcher is intended to make the Tor Browser Bundle (TBB) easier to
maintain and use for GNU/Linux users. You install torbrowser-launcher from your
distribution's package manager and it handles downloading the most recent
version of TBB for you, in your language and for your architecture. It also
adds a "Tor Browser" application launcher to your operating system's menu.

When you first launch Tor Browser Launcher, it will download TBB from
https://www.torproject.org/ and extract it in ~/.torproject, and then execute
it. When you run it after that it will just execute TBB.

Tor Browser Launcher will get updated each time a new version of TBB is
released. When you open Tor Browser after an update, it will download the newer
version of TBB for you and extract it over your old TBB directory in
~/.torproject, so you will maintain your TBB bookmarks.

Building a Debian package
=========================

Dependencies
------------

You need to have stdeb installed. If you're using Debian or Ubuntu you can
install it like this:

  sudo apt-get install python-stdeb

Here are other things you might need:

  sudo apt-get install build-essential dpkg-dev debhelper devscripts fakeroot \
                       cdbs

Building
--------

First build a source distribution:

  python setup.py sdist

Turn it into a Debian source package:

  cd dist
  py2dsc torbrowser-launcher-0.1.tar.gz

Turn it into a Debian binary package:

  cd deb_dist/torbrowser-launcher-0.1
  dpkg-buildpackage -rfakeroot -uc -us

Or, to combine all those in one command:

  python setup.py sdist; cd dist; py2dsc torbrowser-launcher-0.1.tar.gz; \
  cddeb_dist/torbrowser-launcher-0.1; dpkg-buildpackage -rfakeroot -uc -us; \
  cd ..

Installing
----------

Once you've made a .deb, you can install it like this:

  sudo dpkg -i python-torbrowser-launcher_0.1_all.deb