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
asciiwolf 851ff3304f There are two abstraction sets added.
- The first is D-Bus session abstractions.

There are D-Bus denies for opening dialog boxes and file open boxes, which need D-Bus abstractions to access the user sessions. Fixed by including abstractions/dbus-session (which also implicitly imports abstractions/dbus-session-strict for systemd user sessions) in the AppArmor rules, if the abstractions exist.

The abstractions/dbus-session rule also requires adding an AppArmor owner rule for the ~/.cache/ibus/dbus-* socket. Otherwise, keyboard input will stop working.

- The second is X abstractions.

Observed initially in #588, systems that do NOT have GNOME installed on them, such as Lubuntu which uses LXQt and has ZERO GNOME components, will have issues accessing X11 sockets.

In such systems, the implied abstractions/gnome already part of the AppArmor profile do not exist. Therefore, AppArmor will not import abstractions/gnome which includes the X abstractions because the GNOME abstractions definition does not exist.

In such cases, components of the UI will not properly function with dialog boxes. This is why this is separately explicitly required, despite GNOME abstractions including X abstractions.
2024-10-05 10:14:32 +00:00
.github Update git repository URL (#7) 2023-11-23 16:36:58 +01:00
.vscode Format all python with black, and add a .vscode folder 2021-06-18 18:26:55 -04:00
apparmor Update/Add Additional Abstractions for AppArmor 2024-10-05 10:14:32 +00:00
po Remove modem sound references 2024-02-26 18:18:57 +01:00
share Update share/torbrowser-launcher/tor-browser-developers.asc (#21) 2024-09-23 11:35:05 +02:00
torbrowser_launcher Remove gnupg_import_ok_pattern from torbrowser_launcher/common.py (#12) 2024-01-11 13:33:31 +01:00
.gitignore ignore source packages that get generated in some dev environments 2015-05-11 14:09:30 -07:00
build_deb.sh Fix shellcheck warnings 2021-09-13 16:58:02 +00:00
build_rpm.sh Depend on dbus-glib 2024-01-11 09:57:30 +00:00
BUILD.md Update Git repo URL in BUILD.md 2023-10-13 12:22:19 +00:00
CHANGELOG.md Version bump to 0.3.7 and update changelog 2024-01-11 20:00:16 +01:00
git-tag_release.sh Add script to tag new release (#13) 2024-01-12 11:13:05 +01:00
LICENSE Update Copyright lines (#11) 2024-01-10 09:47:10 +01:00
makepot.sh Added a script to generate a pot 2016-12-03 20:32:52 +04:00
ppa_release.sh Fix spelling 2021-09-13 16:58:02 +00:00
README.md Remove modem sound references 2024-02-26 18:18:57 +01:00
screenshot.png Version bump to 0.3.3, update readme, update screenshot 2020-10-06 16:50:53 -07:00
security_design.md Fix url for version check (#678) 2023-04-28 21:02:18 +02:00
setup.py Update Copyright lines (#11) 2024-01-10 09:47:10 +01:00
stdeb.cfg Add python3-packaging dependency 2020-10-06 16:50:20 -07:00
torbrowser_launcher.pot Update torbrowser_launcher.pot 2024-01-10 09:47:11 +01:00
torbrowser-launcher Update Copyright lines (#11) 2024-01-10 09:47:10 +01:00

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. Try installing from Flatpak (instructions below), or build from source.

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 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.

You might want to check out the security design doc.

Tor Browser Launcher screenshot

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.

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