README.md

   1 # Tor Browser Launcher
   2
   3 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 everything else, including:
   4
   5 * Downloading the most recent version of TBB for you, in your language and for your architecture
   6 * Automatically updating (while preserving your bookmarks and preferences)
   7 * Verifying the TBB's [GnuPG signature](http://www.gnupg.org/gph/en/manual/x135.html)
   8 * Adding a "Tor Browser" application launcher to your desktop environment's menu
   9
  10 If you use Ubuntu, you can install it now from my PPA (see "Installing in Ubuntu" below). [Soon](https://github.com/micahflee/torbrowser-launcher/issues/31) it will be in Debian. To install it in any other distribution, follow the "Quick Start" instructions.
  11
  12 ## Quick Start
  13
  14 First, clone the repository:
  15
  16     git clone https://github.com/micahflee/torbrowser-launcher.git
  17     cd torbrowser-launcher
  18
  19 Then install dependencies, build a package, and install:
  20
  21 ### Debian, Ubuntu, Linux Mint, etc.
  22
  23     sudo apt-get install build-essential python-all python-stdeb python-gtk2 python-psutil python-twisted python-pygame python-lzma python-parsley python-txsocksx wmctrl gnupg fakeroot
  24     ./build_deb.sh
  25     sudo dpkg -i deb_dist/torbrowser-launcher_*.deb
  26
  27 ### Red Hat, Fedora, CentOS, etc.
  28
  29     sudo yum install python-psutil python-twisted pygame wmctrl gnupg fakeroot
  30     ./build_rpm.sh
  31     sudo yum install dist/torbrowser-launcher-*.rpm
  32
  33 ## Installing in Ubuntu
  34
  35 I've created a PPA where I'm maintaining torbrowser-launcher binaries. You can install in an Ubuntu-based distribution like this:
  36
  37     sudo add-apt-repository ppa:micahflee/ppa
  38     sudo apt-get update
  39     sudo apt-get install torbrowser-launcher
  40
  41 ## Enabling AppArmor Profiles
  42
  43 AppArmor is a Linux kernel hardening technology that lets you confine specific programs to only use specific resources. For example, if you visit a website that exploits a bug in the Tor Browser to get arbitrary code execution, the attacker won't be able to access files in ~/.gnupg. Here's how you turn on the AppArmor profiles for Tor Browser Launcher and for the programs bundled in the TBB.
  44
  45     sudo apt-get install apparmor-utils
  46     sudo aa-enforce /etc/apparmor.d/usr.bin.torbrowser-launcher
  47     sudo aa-enforce /etc/apparmor.d/torbrowser.start-tor-browser
  48     sudo aa-enforce /etc/apparmor.d/torbrowser.Browser.firefox
  49     sudo aa-enforce /etc/apparmor.d/torbrowser.Tor.tor
  50
  51 # Building in Debian
  52
  53 ## Dependencies
  54
  55 You need to have ```stdeb``` installed. If you're using Debian or Ubuntu you can install it like this:
  56
  57     apt-get install python-stdeb
  58
  59 Also install the ```torbrowser-launcher``` dependencies:
  60
  61     apt-get install python-gtk2 python-psutil python-twisted python-lzma wmctrl gnupg fakeroot
  62
  63 ## Debian packages
  64
  65 To build a Debian source and binary packages:
  66
  67     python setup.py --command-packages=stdeb.command sdist_dsc bdist_deb
  68
  69 Once you've made a ```.deb```, you can install by running this as root:
  70
  71     dpkg -i deb_dist/torbrowser-launcher_VERSION_all.deb