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 line:

  python setup.py sdist; cd dist; py2dsc torbrowser-launcher-0.1.tar.gz; cd deb_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