]> git.lizzy.rs Git - torbrowser-launcher.git/blob - README.md
Merge pull request #217 from dogsleg/master
[torbrowser-launcher.git] / README.md
1 # Tor Browser Launcher
2
3 Tor Browser Launcher is intended to make Tor Browser easier to install and use for GNU/Linux users. You install ```torbrowser-launcher``` from your distribution's package manager and it handles everything else:
4
5 * Downloads and installs the most recent version of Tor Browser in your language and for your computer's architecture, or launches Tor Browser if it's already installed (Tor Browser will automatically update itself)
6 * Verifies Tor Browser's [signature](https://www.torproject.org/docs/verifying-signatures.html.en) for you, to ensure the version you downloaded was cryptographically signed by Tor developers and was not tampered with
7 * Adds "Tor Browser" and "Tor Browser Launcher Settings" application launcher to your desktop environment's menu
8 * Includes AppArmor profiles to make a Tor Browser compromise not as bad
9 * Optionally plays a modem sound when you open Tor Browser (because Tor is so slow)
10
11 Tor Browser Launcher is included in Ubuntu, Debian, and Fedora. To install it in any other distribution, see the [build instructions](/BUILD.md).
12
13 You might want to check out the [security design doc](/security_design.md).
14
15 ![Tor Browser Launcher screenshot](/screenshot.png)
16
17 # Installing in Ubuntu
18
19 If you want to always have the latest version of the `torbrowser-launcher` package before your distribution gets it, you can use my PPA:
20
21 ```sh
22 sudo add-apt-repository ppa:micahflee/ppa
23 sudo apt-get update
24 sudo apt-get install torbrowser-launcher
25 ```