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:
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
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.
12 You might want to check out the [security design doc](/security_design.md).
16 First, clone the repository:
18 git clone https://github.com/micahflee/torbrowser-launcher.git
19 cd torbrowser-launcher
21 Then install dependencies, build a package, and install:
23 ### Debian, Ubuntu, Linux Mint, etc.
25 sudo apt-get install build-essential python-all python-stdeb python-gtk2 python-psutil python-twisted python-lzma wmctrl gnupg fakeroot xz-utils
27 sudo dpkg -i deb_dist/torbrowser-launcher_*.deb
29 Optionally you can install python-pygame if you want to play a modem sound while Tor Browser is launching.
31 ### Red Hat, Fedora, CentOS, etc.
33 sudo yum install python-psutil python-twisted wmctrl gnupg fakeroot rpm-build
35 sudo yum install dist/torbrowser-launcher-*.rpm
37 Optionally you can install pygame if you want to play a modem sound while Tor Browser is launching.
39 ### Run without installing
41 Install the dependencies: sadly, not all of them are available in virtualenv, so you will need to install (some of) them system-wide.
42 Then, you can run: `TBL_SHARE=share ./torbrowser-launcher`
44 ## Installing in Ubuntu
46 I've created a PPA where I'm maintaining torbrowser-launcher binaries. You can install in an Ubuntu-based distribution like this:
48 sudo add-apt-repository ppa:micahflee/ppa
50 sudo apt-get install torbrowser-launcher
52 ## Enabling AppArmor Profiles
54 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.
56 sudo apt-get install apparmor-utils
57 sudo aa-enforce /etc/apparmor.d/usr.bin.torbrowser-launcher
58 sudo aa-enforce /etc/apparmor.d/torbrowser.start-tor-browser
59 sudo aa-enforce /etc/apparmor.d/torbrowser.Browser.firefox
60 sudo aa-enforce /etc/apparmor.d/torbrowser.Tor.tor