https://github.com/torproject/torbrowser-launcher

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
https://github.com/torproject/torbrowser-launcher

Last synced: 8 days ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/torproject/torbrowser-launcher
• Owner: torproject
• License: mit
• Created: 2013-02-07T04:31:02.000Z (almost 12 years ago)
• Default Branch: main
• Last Pushed: 2024-05-13T08:22:27.000Z (6 months ago)
• Last Synced: 2024-05-21T15:24:30.964Z (6 months ago)
• Language: Python
• Homepage:
• Size: 2.09 MB
• Stars: 763
• Watchers: 49
• Forks: 183
• Open Issues: 90
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE
  • Codeowners: .github/CODEOWNERS
  • Security: security_design.md

Awesome Lists containing this project

README

        
# Tor Browser Launcher

_**Are you getting an error?** Sometimes updates in Tor Browser itself will break Tor Browser Launcher. There's a good chance that the problem you're experiencing has already been fixed in the [newest version](https://gitlab.torproject.org/tpo/applications/torbrowser-launcher/-/tags). Try installing from Flatpak (instructions below), or [build from source](/BUILD.md)._

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:

* 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)

* Verifies Tor Browser's [signature](https://support.torproject.org/tbb/how-to-verify-signature/) for you, to ensure the version you downloaded was cryptographically signed by Tor developers and was not tampered with

* Adds "Tor Browser" and "Tor Browser Launcher Settings" application launcher to your desktop environment's menu

* Includes AppArmor profiles to make a Tor Browser compromise not as bad

Tor Browser Launcher is included in Ubuntu, Debian, and Fedora. To install it in any other distribution, see the [build instructions](/BUILD.md).

You might want to check out the [security design doc](/security_design.md).

![Tor Browser Launcher screenshot](/screenshot.png)

# Installing

You can install `torbrowser-launcher` from your operating system's package manager, but it might be out-of-date and have issues working. If you want to make sure you always have the latest version, use Flatpak:

## Installing in any Linux distro using Flatpak

Install Flatpak using these [instructions](https://flatpak.org/setup/).

Then install `torbrowser-launcher` like this:

```

flatpak install flathub org.torproject.torbrowser-launcher -y

```

Run `torbrowser-launcher` either by using the GUI desktop launcher, or by running:

```

flatpak run org.torproject.torbrowser-launcher

```