Securely and easily download, verify, install, and launch Tor Browser in Linux. This repository is a mirror of https://gitlab.torproject.org/tpo/applications/torbrowser-launcher
Go to file
Jacob Appelbaum 8d08df37fb This commit adds a second GnuPG key and signature verification info
We add Sebastian's GnuPG key, move Erinn's key into a sub directory,
add a README to explain Tor's signature verification process, and
we include both keys in the Python setup.py. We use both keys in the
key ring to verify the signature.

In the future, we probably also consider depending on the
package 'deb.torproject.org-keyring' from deb.torproject.org or
including the keys included in that package.
2013-02-18 00:44:24 -08:00
keys This commit adds a second GnuPG key and signature verification info 2013-02-18 00:44:24 -08:00
.gitignore back to python 2013-02-14 18:18:17 -08:00
build_and_install.sh wrote a verify.sh script to verify signatures, moved files around some, and implemented verify function 2013-02-15 14:24:12 -08:00
MANIFEST.in back to python 2013-02-14 18:18:17 -08:00
README wrote a verify.sh script to verify signatures, moved files around some, and implemented verify function 2013-02-15 14:24:12 -08:00
setup.py This commit adds a second GnuPG key and signature verification info 2013-02-18 00:44:24 -08:00
torbrowser32.xpm wrote a verify.sh script to verify signatures, moved files around some, and implemented verify function 2013-02-15 14:24:12 -08:00
torbrowser80.xpm wrote a verify.sh script to verify signatures, moved files around some, and implemented verify function 2013-02-15 14:24:12 -08:00
torbrowser-launcher added icon to exit button for errors 2013-02-17 19:26:58 -08:00
torbrowser.desktop wrote a verify.sh script to verify signatures, moved files around some, and implemented verify function 2013-02-15 14:24:12 -08:00
verify.sh This commit adds a second GnuPG key and signature verification info 2013-02-18 00:44:24 -08:00

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