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
2015-05-11 19:08:40 -04:00
apparmor AppArmor: silence denied access to /sys/devices/virtual/block/*/uevent. 2015-01-29 16:11:57 +00:00
locale Merge pull request #150 from AreYouLoco/master 2014-11-17 10:14:26 -08:00
share version bump to 0.2.0 and updated changelog 2015-05-11 15:27:49 -07:00
torbrowser_launcher Stop printing so much console output (fixes #173) 2015-05-11 15:22:46 -07:00
.gitignore ignore source packages that get generated in some dev environments 2015-05-11 14:09:30 -07:00
build_deb.sh update version path in build scripts 2014-07-09 11:10:51 -07:00
build_rpm.sh Added python-txsocksx, tor dependencies to Fedora version, so FC21 supports upgrading over Tor 2015-05-11 19:08:40 -04:00
BUILD.md Added python-txsocksx, tor dependencies to Fedora version, so FC21 supports upgrading over Tor 2015-05-11 19:08:40 -04:00
CHANGELOG.md version bump to 0.2.0 and updated changelog 2015-05-11 15:27:49 -07:00
LICENSE updated copyright to 2013-2014 2014-07-07 17:23:29 -07:00
ppa_release.sh typo in ppa script 2014-07-10 17:22:19 -07:00
README.md updated readme to include Firefox/default browser instructions (#157) 2015-01-21 12:13:46 -08:00
requirements.txt requirements.txt: add peep hashes and more entries 2014-08-11 11:24:37 +00:00
screenshot.png updated AppData XML, and made the screenshot larger 2014-11-25 13:44:33 -08:00
security_design.md added security design doc 2014-07-17 13:30:37 -07:00
setup.py updated readme, package description 2014-11-25 12:39:22 -08:00
stdeb.cfg python-txsocksx and tor should be dependencies, not just recommend 2014-07-31 12:05:50 -07:00
torbrowser-launcher make torbrowser-launcher script executable again 2014-09-03 13:17:41 -07: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 everything else, including:

  • Downloading the most recent version of TBB for you, in your language and for your architecture
  • Automatically updating (while preserving your bookmarks and preferences)
  • Verifying the TBB's GnuPG signature
  • Includes AppArmor profiles to make a Tor Browser compromise not as bad
  • Adding a "Tor Browser" application launcher to your desktop environment's menu, and letting you set Tor Browser as your default browser
  • Optionally playing a modem sound when you open Tor Browser (because Tor is so slow)

Tor Browser Launcher is included in Ubuntu 14.10+, Debian 8+, and Fedora 20+. To install it in any other distribution, see the build instructions.

You might want to check out the security design doc.

Tor Browser Launcher screenshot

Using Tor Browser as your default browser, and Firefox

Tor Browser Launcher allows you to set Tor Browser as your default web browser. Unfortunately, there's a gnarly issue that prevents this from working if Firefox is open in the background. If Tor Browser is set as your default browser and Firefox is open in the background, links will get opened in Firefox. Likewise, if Firefox is your default browser and Tor Browser is open in the background, links will get opened in Tor Browser. See more information here.

You can only use Tor Browser as your default browser if you don't use Firefox at the same time. Other browser (such as Iceweasel, Chromium, or Chrome) will work fine. You must check "Allow opening links with Tor Browser" in the settings to enable it.

Installing in Ubuntu 14.04 and earlier

I've created a PPA where I'm maintaining torbrowser-launcher binaries. You can install in an Ubuntu-based distribution like this:

sudo add-apt-repository ppa:micahflee/ppa
sudo apt-get update
sudo apt-get install torbrowser-launcher